用途:对 HEAD 与用户提供的固定点(提交 SHA、分支名、标签、main、HEAD~5 等)之间的 diff 做双轴审查。标准轴检查代码是否符合本仓库记录的编码规范;规格轴检查代码是否忠实实现原始 issue、PRD 或规格。两轴刻意分开报告,避免一个轴掩盖另一个。
主要能力:并行运行两个子 agent,各自独立上下文,再汇总发现。以 git diff <fixed-point>...HEAD(三点,针对 merge-base)获取差异,并用 git log <fixed-point>..HEAD --oneline 记录提交列表。
使用方式:先确定固定点,用户未指定则询问以何为基准;固定点原样传递,不加主观判断。然后按顺序查找规格:提交消息中的 issue 引用(经 docs/agents/issue-tracker.md 的工作流获取)、用户传入的路径、docs/、specs/ 或 .scratch/ 下匹配分支名或功能的 PRD/规格。若找不到则询问用户;若用户说没有,规格子 agent 跳过并报告 no spec available。同时收集标准来源:CLAUDE.md、AGENTS.md、CONTRIBUTING.md、CONTEXT.md、CONTEXT-MAP.md、各上下文 CONTEXT.md、docs/adr/、.editorconfig、eslint.config.、biome.json、prettier.config.、tsconfig.json,以及仓库根或 docs/ 下的 STYLE.md、STANDARDS.md、STYLEGUIDE.md 等。
执行与报告:发一条包含两个 Agent 工具调用的消息,两者都用 general-purpose 子 agent。标准子 agent 读取标准文档与 diff,报告每个违反记录标准的位置并引用文件与规则,区分硬违规与判断性跳过,跳过工具强制检查的内容,400 字以内。规格子 agent 读取规格与 diff,报告缺失或部分实现的需求、未被要求的行为(范围蔓延)、看似已实现但实现有问题的需求,并引用规格行,400 字以内。最终在 ## Standards 和 ## Spec 标题下分别呈现,不合并或重排序,末尾给出一行摘要:每轴发现总数与最严重问题。
限制与依赖:issue tracker 应已提供,若 docs/agents/issue-tracker.md 缺失需运行 /setup-matt-pocock-skills。规格缺失时规格轴跳过并在报告中注明。标准轴不重复检查工具已强制的内容。