用途:对 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。
-
确定规格来源。按顺序查找:提交信息中的 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。
-
确定规范来源。收集仓库中记录代码应如何编写的文件,常见位置: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 命令与提交列表、规范来源文件清单,以及要求:读规范文档,再读 diff,按文件/代码块报告每一处违反已记录规范之处,引用规范(文件+规则),区分硬性违规与判断性问题,跳过工具强制项,400 词以内。Spec 提示需包含 diff 命令与提交列表、规格路径或已获取内容,以及要求:读规格,再读 diff,报告 (a) 规格要求但缺失或仅部分实现的项;(b) diff 中未被要求的越界行为(scope creep);(c) 看似实现但实现有误的要求;每条发现引用规格原文行,400 词以内。
-
汇总。以 ## Standards 与 ## Spec 两个标题分别呈现两份报告,可逐字或轻度整理,不合并、不重排发现,使两轴可被独立查看。结尾给一行总结:各轴发现总数,以及标记出的最严重单个问题(如有)。
适用场景与限制:适用于需要同时对照编码规范与来源规格来审查改动的工程流程。两轴分离的意义在于,改动可能通过一轴而失败另一轴:完全符合规范但实现方向错误的代码,Standards 通过、Spec 失败;完全满足 issue 要求却破坏项目约定的代码,Spec 通过、Standards 失败。分开报告可避免一轴掩盖另一轴。资料未提供该技能的安装方式、收费信息与具体平台支持情况。