名称: 评审描述: 对比实现与规范以验证对齐。在实现后使用以验证需求是否满足。参数提示: [规范文件路径] 允许工具: 读取、全局匹配、查找

评审实现对比规范

对比实现与规范以验证对齐。

变量

spec_file: $1 - 规范文件的路径

目的

评审回答: “我们构建的是我们要求的东西吗？”

这与测试不同。我们知道功能有效。我们在验证与原始规范的对齐。

指令

1. 阅读规范

阅读规范文件以理解:

原始需求
成功标准
期望行为
验收标准

2. 分析变化

对比实现与规范:

# 查看所有变化
git diff origin/main

# 查看更改的文件
git diff origin/main --stat

# 查看特定文件的变化
git diff origin/main -- 路径/到/文件

3. 捕获屏幕截图 (1-5)

捕获关键功能路径的屏幕截图:

初始状态: 交互前
关键操作: 重要用户操作后
最终状态: 结束结果

名称格式: 01_描述性名称.png, 02_描述性名称.png

4. 对比规范

对于规范中的每个要求:

是否已实现？
是否符合规范？
是否有任何偏差？

5. 分类问题

对于发现的每个问题，按严重性分类:

严重性	描述	行动
blocker	阻止发布，损害用户体验	必须修复
tech_debt	质量问题，功能有效	记录
skippable	美化，偏好	仅记录

输出格式

只返回JSON:

{
  "success": true,
  "review_summary": "2-4句评审发现摘要",
  "review_issues": [
    {
      "issue_description": "问题的清晰描述",
      "issue_resolution": "如何修复",
      "issue_severity": "blocker"
    },
    {
      "issue_description": "另一个问题",
      "issue_resolution": "解决方法",
      "issue_severity": "tech_debt"
    }
  ],
  "screenshots": [
    "路径/到/01_初始状态.png",
    "路径/到/02_操作后.png"
  ]
}

成功标准

success: true 当没有blocker问题存在时
success: false 当任何blocker问题存在时

评审可以在有tech_debt和skippable问题的情况下成功。

分类指南

如果为Blocker：

功能未按指定工作
UI不符合要求
关键功能缺失
用户体验受损

如果为Tech Debt：

功能有效但实现次优
代码质量问题
缺少优化
控制台警告

如果为Skippable：

轻微的视觉差异
美化改进
主观偏好
可有可无的增强

与工作流集成

此命令是SDLC的一部分:

/计划 → /实施 → /测试 → /评审 → /修补（如果需要） → /文档

如果发现blockers，使用/修补来创建针对性修复。

名称: 评审 描述: 对比实现与规范以验证对齐。在实现后使用以验证需求是否满足。 参数提示: [规范文件路径] 允许工具: 读取、全局匹配、查找