内部步骤(Task 5),由 generator 编排器调用,不从用户直接触发。 对规格文档进行结构化质量审查,检查 PRD 覆盖度、任务可操作性和验收条件可测试性。
对生成的规格文档进行结构化质量审查,确保其完整、精确、可操作。
${ARGUMENTS}/prd-source.md(原始 PRD)+ ${ARGUMENTS}/prd-analysis.md(分析报告)+ ${ARGUMENTS}/{feature-name}-spec.md(规格文档)${ARGUMENTS}/review-report.md$ARGUMENTS/prd-source.md,获取原始 PRD 内容,从元数据头中提取 feature-name$ARGUMENTS/prd-analysis.md,获取 PRD 分析结果(功能列表、业务实体与交互需求、验收条件)$ARGUMENTS/{feature-name}-spec.md,获取待审查的规格文档按以下顺序执行审查,每一步都必须完成。
通读完整的 spec 文档,理解实现计划的整体结构。
取出原始 PRD 和分析报告,逐条对照:
covered、partial 或 missing对 spec 中的每个任务,验证:
对照 prd-analysis.md 中的业务实体和交互需求,检查 spec 中的数据模型是否完整覆盖:
对照 prd-analysis.md 中的交互需求,检查 spec 中的 API 接口是否完整覆盖:
每个交互需求是否在 spec 中有对应的 API 端点
请求参数是否完整(含类型、位置、必填性)
成功响应结构是否定义
错误响应是否覆盖主要场景
鉴权要求是否明确
确保每条验收条件:
根据审查结果给出结论:
如果结论为 NEEDS_REVISION,必须列出具体的关键问题和修复建议。
使用 ${CLAUDE_PLUGIN_ROOT}/skills/spec-reviewer/references/review-report-template.md 作为结构模板,将审查报告写入 $ARGUMENTS/review-report.md:
读取 ${CLAUDE_PLUGIN_ROOT}/skills/spec-reviewer/references/quality-gate.md,逐项核对产出物 $ARGUMENTS/review-report.md 是否满足所有验收标准。如有未通过的项,使用 Edit 工具修复产出文件后重新核对。最多重试 2 次,仍未通过则将未通过项记入返回状态的 issues 中。
完成所有工作后,输出以下格式的状态信息(不要包含其他内容):
[STATUS: success | partial | failed]
[OUTPUT: review-report.md]
[WARNINGS: 警告列表,没有则为 none]
[ISSUES: 阻塞问题列表,没有则为 none]
[SUMMARY: 一句话摘要]
注意:STATUS 为 success 时审查结论为 PASS 或 PASS_WITH_NOTES。STATUS 为 failed 时审查结论为 NEEDS_REVISION,编排器将重新调用 spec-creator 进行返工。