对HEAD与用户提供的固定点之间差异的双轴审查:
- 规范——代码是否符合该仓库文档化的编码标准?
- 规格——代码是否忠实实现了原始需求/PRD/规格?
两个轴作为并行子代理运行,避免相互污染上下文,然后此技能汇总它们的发现。
问题跟踪器应已提供给你——如果docs/agents/issue-tracker.md缺失,请运行/setup-matt-pocock-skills。
流程
1. 确定固定点
无论用户指定的固定点是什么——提交SHA、分支名、标签、main、HEAD~5等。如果用户未指定,则要求提供。
捕获一次差异命令:git diff <固定点>...HEAD(三点格式,以便与合并基线比较)。同时通过git log <固定点>..HEAD --oneline记录提交列表。
在继续之前,确认固定点能解析(git rev-parse <固定点>)且差异非空。无效引用或空差异应在此处失败——而不是在两个并行子代理内部。
2. 识别规格源
按此顺序查找原始规格:
- 提交消息中的问题引用(
#123、Closes #45、GitLab!67等)——通过docs/agents/issue-tracker.md中的工作流获取。 - 用户作为参数传递的路径。
- 位于
docs/、specs/或.scratch/下与分支名或特性匹配的PRD/规格文件。 - 如果未找到,询问用户规格位置。如果用户表示不存在,则规格子代理将跳过并报告“无可用规格”。
3. 识别规范源
仓库中任何记录代码编写方式的文件,例如CODING_STANDARDS.md或CONTRIBUTING.md。
4. 并行生成两个子代理
发送一条消息,包含两次Agent工具调用。两次都使用general-purpose子代理。
规范子代理提示——包含:
- 完整的差异命令和提交列表。
- 你在步骤3中发现的规范源文件列表。
- 简报:“报告——在相关处按文件/块——差异中每一处违反文档化标准的地方。引用标准(文件+规则)。区分硬性违规和判断性意见。跳过工具强制执行的任何内容。不超过400词。”
规格子代理提示——包含:
- 差异命令和提交列表。
- 规格的路径或抓取的内容。
- 简报:“报告:(a) 规格要求但缺失或不完整的需求;(b) 差异中未经要求的行为(范围蔓延);(c) 看起来已实现但实现有误的需求。对每项发现引用规格原文。不超过400词。”
如果规格缺失,则跳过规格子代理,并在最终报告中注明。
5. 汇总
在## 规范和## 规格标题下逐字或稍作清理地呈现两份报告。不要合并或重新排序发现——两个轴是刻意分开的(参见_为何分为两轴_)。
以一行摘要结束:每个轴的发现总数,以及每个轴内最严重的问题(如果有)。不要跨轴选一个胜者——这就是避免重新排序的分离目的。
为何分为两轴
一次变更可能通过一轴但未通过另一轴:
- 代码遵循了所有标准但实现了错误的内容 → 规范通过,规格未通过。
- 代码完全按照需求实现但打破了项目约定 → 规格通过,规范未通过。
分别报告可以防止一轴掩盖另一轴的问题。