用途:为 VALIDATION 阶段生成验收判定依据(acceptance oracle),即机器可读的可测试标准列表,写入 specs/validation/validation-criteria.json。下游的端到端测试与人工签核清单均由此文件派生,因此忠实于需求比数量更重要。
主要能力:从 specs/requirements/prd.md 的编号 User Stories 及 specs/requirements/features/<slug>.md 中解析需求,为每条需求生成 REQ-NNN 条目,并附上可测试的验收标准 AC-<req-number>-<letter>。每条标准为单一、原子、可验证的断言,method 只能取 e2e 或 manual。e2e 表示可通过无头浏览器驱动 UI 流程或确定性 API/CLI 断言检查;manual 表示需人工判断、探索性交互、主观评估或存在外部/物理/第三方副作用。
使用方式:可独立运行(仅请求标准的一轮),也可作为设计生成轮次的最后一步。读取需求文件后,用 addFile 创建或替换 specs/validation/validation-criteria.json,文件须为符合给定 schema 的合法 JSON,无注释、无多余文字、无 Markdown 围栏,字段顺序保持稳定。重新生成时,未变更标准的 id 须与已有文件保持一致,因为已提交的 e2e 规格以标准 id 为键(tests/e2e/specs/<AC-ID>.spec.ts),重新编号会使规格孤立;仅对真正新增或改写过的标准分配新 id。
限制:不得读取 design.md、openapi.yaml 或任何源码来推导标准,验收判定必须独立于被评对象;不得编造范围、端点或功能;不得添加 schema 之外的字段、注释或文字;不得生成 e2e 测试文件、验证工作流或其他产物。若需求含糊或缺少验收细节,不得猜测填充,而应在回复用户时列出歧义与假设,且这些内容不得写入 JSON 文件。每条需求至少引用一个故事编号,每个被设计阶段的故事都应出现在某条目的 stories 中。