用途:对 HEAD 与用户指定固定点之间的 diff 做双轴审查。规范轴检查代码是否符合本仓库文档化的编码规范;规格轴检查代码是否忠实实现原始 issue、PRD 或规格。两条轴线作为并行子 agent 运行,互不污染上下文,再由本技能汇总。
主要能力:确定固定点并捕获 diff 命令 git diff <fixed-point>...HEAD(三个点,比较 merge-base),同时用 git log <fixed-point>..HEAD --oneline 记录 commit 列表;确认固定点可解析(git rev-parse <fixed-point>)且 diff 非空。查找规格来源:commit 消息中的 issue 引用、用户传入路径、docs/、specs/ 或 .scratch/ 下匹配的 PRD/规格文件。查找规范来源,若存在 CODING_STANDARDS.md 或 CONTRIBUTING.md 必须列入;规范轴始终携带 Fowler《重构》第 3 章的代码气味基线,仓库已文档化的标准优先并压制基线判定,气味始终是判断性启发式而非硬性违规,且跳过工具已强制执行的内容。
使用方式:用户指定固定点(commit SHA、分支名、tag、main、HEAD~5 等),未指定则询问。并行发出两个子 agent 调用并在前台运行,汇总返回报告。规范子 agent 报告按文件/hunk 列出违反文档化规范之处(引用规范文件与规则)及基线气味(命名并引用 hunk),区分硬性违规与判断性差异,400 字以内。规格子 agent 报告规格要求但缺失或不完整的需求、diff 中存在但规格未要求的行为(范围蔓延)、看似已实现但可能实现错误的需求,每项引用规格原文,400 字以内。规格缺失则跳过规格子 agent 并在最终报告注明。
汇总:在 ## 规范 和 ## 规格 标题下呈现两份报告,不合并或重新排序发现项。结尾附一行总结:每条轴线的发现项总数及各自最严重的单项问题,不跨轴线选最终获胜者。
适用场景:审查分支、PR、进行中的变更,或要求从某固定点开始审查。
限制:Issue 跟踪器应已提供,否则需用户运行 /setup-matt-pocock-skills;固定点无法解析或 diff 为空时应在此处失败,不应交给并行子 agent;规格来源缺失时需询问用户,用户说没有则规格轴跳过并报告“无可用的规格”。