groove-work-review

用途

groove-work-review 用于在实现阶段完成后对产出物进行评审。它评估产出物的正确性、质量以及与计划的契合度，识别可供后续复合阶段（compound stage）使用的经验教训，并做出明确的接受或返工决定及其理由。

主要能力

• 对照计划与验收标准评估产出物。
• 识别具体的缺口或问题，而不是笼统的“需要改进”。
• 给出接受或返工的决定并附理由。
• 记录经验教训，供 /groove-work-compound 使用。
• 将评审笔记追加到阶段任务正文中。

使用方式

评审以一个明确的产出物为核心：分支 diff。步骤包括：

1. 分支差异分析：确定基线分支（默认 main，可通过 base: 参数覆盖）。运行以下命令：

   • git log --oneline <base>...HEAD — 列出该分支上的提交
   • git diff <base>...HEAD --stat — 汇总改动的文件
   • git diff <base>...HEAD — 完整 diff（以此作为评审输入） 将该 diff 作为主要评审产出物。如果基线之外没有提交，则改为评审工作区改动。

2. 对照计划与验收标准进行评审 — 如可用，从任务正文或规格文件中读取计划。

3. 对发现进行分类（使用以下精确标签）：

   • Fix Now：琐碎问题 — 在接受前立即修复
   • Needs Spec：需要规划的重要缺口 — 创建规格
   • Create Issues：较大工作量或锦上添花 — 作为任务跟踪

4. 说明接受或返工决定及理由。

5. 记录经验教训供 /groove-work-compound 使用。

6. 将评审笔记追加到任务正文。

7. 若 tasks.backend != none，通过 /groove-utilities-task-create 创建阶段任务（标题为 YYYY-MM-DD, Review）。

适用场景

该技能在实现（implementation）完成后使用。验收条件包括：产出物已对照计划和验收标准评估；识别出具体缺口或问题；接受或返工决定及理由已说明；经验教训已记录；评审笔记已追加到阶段任务正文；阶段任务已创建。

限制

• 需从 .groove/index.md 读取 tasks.backend 以确定后端。
• 要求彻底执行——复合循环约 80% 的价值体现在这里和规划阶段。
• 若返工：需记录具体缺口，并链接回被遗漏或不清楚的计划步骤。
• 若接受：仍需记录哪些做得好、下次可以改进什么。
• 即使是很小的改动也不要跳过评审——要记录一些内容。