spec-review - SKILL.md Agent Skill

disable-model-invocation: true name: spec-review description: 审查 Spec 执行完成情况，检验实现是否严格按照 Spec 执行，识别未完成项和不符项，在 reviewer/ 下生成审查报告（review.md）。在 spec-execute 完成 executor/summary.md 后、spec-end 归档前使用。触发词：审查 Spec、检查实现、Spec Review。

进入核心规则前先对齐这张表。它把本 Skill 当成一个有边界的循环单元：明确读什么、能动什么、怎么算完成、什么时候停、什么时候交还给人。

项	本 Skill 的约定
输入	`writer/plan.md` 或 `updater/update-xxx.md`、`executor/summary.md` 或 `updater/update-xxx-summary.md`、实际代码
权限	只写 `reviewer/review.md` / `update-xxx-review.md`（审查结论）；只读代码核对，不修改代码、不修 bug、不归档
验证	按完成度/一致性/额外实现三维核对，每个检查项标注 Spec 位置 + 代码位置（file:line）
停止	审查报告定稿且通过用户确认即停止；不越界去修复发现的问题（交给 spec-debugger/spec-update）
升级	发现核心功能未实现、数据模型严重不符或需重新实现时，在 `Problem Resolution Log` 记录并交回 TeamLead 由用户决策

[!important] 完成审查报告后，必须使用当前运行环境的确认方式等待用户确认。

确认目标：审查报告已创建完成，审查结果是否准确？
确认选项：
- 审查准确
- 需要调整（请说明问题）

场景	文件名
新功能审查	`reviewer/review.md`
更新审查	`reviewer/update-001-review.md`（编号与 update 对应）

维度	检查内容	标记
完成度	Spec 定义的功能是否全部实现（功能点、数据模型、API、测试）	✅ 已完成 / ❌ 未完成
一致性	实现是否与 Spec 设计一致（接口签名、数据结构、业务逻辑、命名）	⚠️ 不符
额外实现	是否有 Spec 未定义的额外功能、字段、参数	➕ 额外

严格模式（默认）：所有功能必须实现、签名完全一致、不允许额外实现

宽松模式（用户指定时使用）：核心功能必须实现、允许小的接口差异和合理的额外实现

步骤	操作	要点
1	读取 Spec 文档	读取 `writer/plan.md` 或 `updater/update-xxx.md`，提取功能点、数据模型、接口定义
2	读取实现总结	读取 `executor/summary.md` 或 `updater/update-xxx-summary.md`，了解已完成功能和修改文件
3	建立检查清单	从 Spec 提取所有需实现的功能点、模型、接口、测试
4	检查代码实现	根据 summary 文件列表读取实际代码，逐项核对
5	对比分析	按三个维度（完成度、一致性、额外实现）识别差异
6	生成审查报告	在 Spec 目录下创建 `reviewer/review.md`，模板见 references/review-template.md
7	用户确认	必须使用当前运行环境的确认方式等待用户确认

问题按优先级分类：

Frontmatter 和正文模板详见 references/review-template.md
每个检查项必须标注具体的 Spec 位置和代码位置（file:line）
使用 Obsidian Callout 标注结果：> [!success]、> [!failure]、> [!warning]、> [!tip]
使用 [[]] 双链或相对链接关联 writer/plan.md 和 executor/summary.md

用户确认前，先更新当前 Spec 的 lead/team-context.md 共享区：

在 Task Progress 中追加或更新 spec-reviewer 自己的审查任务行
artifact 指向 reviewer/review.md 或 reviewer/update-xxx-review.md
status 根据审查结果标记为 done / needs-fix
completed_at 使用当前时间，updated_by 写 spec-reviewer
若发现阻塞问题，在 Problem Resolution Log 中追加问题行，found_by 写 spec-reviewer，owner 建议写 TeamLead 或 spec-debugger
只修改 Task Progress / Problem Resolution Log，不要修改 TeamLead 控制面区块

响应	含义	后续操作
"审查准确"	用户确认	审查通过 → 交给 spec-end 归档；需修复 → 等待修复后重新审查
"需要调整" 或 "Other"	需要修改	根据用户反馈调整审查报告

禁止：