用途:对 HEAD 与用户提供的固定点之间的 diff 做双轴代码审查。Standards 轴判断代码是否符合本仓库文档化的编码规范;Spec 轴判断代码是否忠实实现来源 issue、PRD 或规格。两轴作为并行子代理运行,避免相互污染上下文,再由本技能汇总结果。
主要能力:固定点由用户指定,可为提交 SHA、分支名、标签、main、HEAD~5 等,不做主观判断直接透传;未指定时需先询问“对照什么审查——分支、提交还是 main?”,未获得前不继续。捕获一次 diff 命令:git diff <fixed-point>...HEAD(三点,与 merge-base 比较),并记录提交列表:git log <fixed-point>..HEAD --oneline。
Spec 来源查找顺序:提交信息中的 issue 引用(#123、Closes #45、GitLab !67 等),按 docs/agents/issue-tracker.md 的工作流获取;用户作为参数传入的路径;docs/、specs/ 或 .scratch/ 下与分支名或功能匹配的 PRD/规格文件。若找不到则询问用户规格位置;若用户表示没有,Spec 子代理跳过并报告“no spec available”。若 docs/agents/issue-tracker.md 缺失,需运行 /setup-matt-pocock-skills。
Standards 来源:仓库中记录代码应如何编写的文件,常见位置包括 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 子代理。Standards 子代理提示需包含完整 diff 命令与提交列表、步骤 3 找到的规范来源文件列表,以及任务说明:阅读规范文档后阅读 diff,按文件/hunk 报告每一处违反文档化规范之处,引用规范(文件+规则),区分硬性违规与主观判断,跳过工具强制项,400 词以内。Spec 子代理提示需包含 diff 命令与提交列表、规格路径或已获取内容,以及任务说明:阅读规格后阅读 diff,报告规格要求但缺失或部分实现的需求、diff 中未被要求的行为(范围蔓延)、看似实现但实现有误的需求,每项发现引用规格原文,400 词以内。
汇总:在 ## Standards 与 ## Spec 标题下分别呈现两份报告,逐字或轻度清理,不合并、不重排发现,两轴刻意分开以便独立查看。结尾给出一行摘要:每轴发现总数,以及标记出的最严重单个问题(如有)。
适用场景:需要同时检查代码规范符合度与需求实现忠实度的变更审查。
限制:固定点必须由用户提供,否则需先询问;规格缺失时 Spec 轴跳过;两轴报告各自控制在 400 词以内;不重复检查工具已强制执行的规范。