forge-verify

Forge Verify - 独立需求验证

描述需求 → 结构化 → 映射代码实现 → 测试验证 → 差距报告。

这是 forge-teams 的独立需求验证入口。复用 spec-reviewer 的逐条验证方法论，但输入不依赖 P1 的 PRD，而是直接接收用户提供的需求描述。

Announce at start: "I'm using the forge-verify skill to check whether the described requirements are implemented in the current codebase."

注意: 本 skill 不需要 Agent Teams，使用 Lead 单 agent 流程执行。

用法

/forge-verify <requirement-description> [options]

参数说明

参数	说明	默认值
<requirement-description>	需求描述（文本、文件路径、或 URL）	必填
--strict	严格模式：PARTIAL 视为 FAIL	宽松模式
--with-tests	对每条 "已实现" 需求检查测试覆盖	不检查
--fix	发现 Gap 后自动补齐实现（PARTIAL → 补全，NOT_IMPLEMENTED → 实现）	不修复
--loop <N>	修复后重新验证，最多 N 轮（需配合 --fix）	3
--format <format>	输出格式：matrix（完整合规矩阵）或 summary（摘要）	matrix
--scope <path>	限定验证范围到指定目录	整个项目

示例

# 只验证，不修复
/forge-verify "用户可以通过邮箱注册，密码至少8位，注册后发送验证邮件"

# 从文件加载需求
/forge-verify requirements.md

# 严格模式 + 检查测试覆盖
/forge-verify "支持 OAuth2 登录和 JWT token 刷新" --strict --with-tests

# 验证 + 自动补齐实现
/forge-verify "用户可以通过邮箱注册，密码至少8位，注册后发送验证邮件" --fix

# 验证 + 补齐 + 多轮循环直到全部通过
/forge-verify "支持 OAuth2 登录和 JWT token 刷新" --fix --loop 5

# 只检查特定目录
/forge-verify "API 支持分页和排序" --scope src/api/

输出目录

docs/forge-verify/
└── [requirement-slug]-[timestamp]/
    ├── structured-requirements.md  # 结构化需求
    ├── code-mapping.md             # 需求到代码映射
    ├── test-coverage.md            # 测试覆盖检查（--with-tests）
    ├── gap-report.md               # 差距报告
    ├── fix-log.md                  # 修复记录（--fix）
    └── summary.md                  # 最终摘要

---

Protocol Overview

┌─────────────────────────────────────────────────────────────────┐
│                   VERIFY REQUIREMENT                              │
├─────────────────────────────────────────────────────────────────┤
│                                                                   │
│  Phase 0: STRUCTURIZE     将大白话需求翻译成可验证条件             │
│           ↓               EARS 格式 + 验收标准                    │
│                                                                   │
│  Phase 1: CODE MAPPING    逐条需求搜索代码实现                     │
│           ↓               Grep + Glob + 代码阅读                  │
│                                                                   │
│  Phase 2: TEST VERIFY     检查测试覆盖（可选）                     │
│           ↓               对 "已实现" 的需求验证测试               │
│                                                                   │
│  Phase 3: GAP REPORT      综合差距报告                             │
│           ↓               5 级分类 + 修复建议                     │
│                                                                   │
│  [--fix enabled]                                                  │
│                                                                   │
│  Phase 4: AUTO FIX        逐条补齐缺失实现                        │
│           ↓               按优先级: NOT_IMPLEMENTED → PARTIAL     │
│                            TDD: 先写测试 → 再实现 → 验证通过      │
│                                                                   │
│  Phase 5: RE-VERIFY       重新验证（回到 Phase 1）                 │
│                            只重验 Phase 4 修改的需求               │
│                            最多 --loop N 轮                       │
│                                                                   │
└─────────────────────────────────────────────────────────────────┘