用途:审查 HEAD 与用户指定固定点之间的 diff,固定点可为提交 SHA、分支名、标签、main 或 HEAD~5。若用户未提供,需先询问,不可直接开始。
主要能力:三个独立维度并行评审。规范轴检查代码是否符合仓库文档化约定,并附带 Fowler 代码坏味道基线(仓库标准优先,坏味道仅为判断性提示);规格轴检查代码是否忠实实现来源 issue/PRD/规格,仅在提交列表或用户请求中出现规格信号时才启用;可维护性轴评估结构健康度与未来可变更性,鼓励提出保留行为的“代码柔道”式简化建议,每条发现附置信度标签与具体证据。
使用方式:先固定基准点,用 git rev-parse <fixed-point> 确认可解析、diff 非空;一次性采集 git diff <fixed-point>...HEAD(三点比较 merge-base)、git log <fixed-point>..HEAD --oneline、git diff <fixed-point>...HEAD --stat。识别规范来源(CLAUDE.md、AGENTS.md、CONTRIBUTING.md、CONTEXT.md、docs/adr/、STYLE.md、STANDARDS.md、.editorconfig、eslint.config.、biome.json、prettier.config.、tsconfig.json 等),工具已强制的不重复检查。随后以单条消息并行启动子代理:规范与可维护性始终运行,规格按信号决定。最后按 ## Standards、## Spec、## Maintainability 分轴呈现,不跨轴合并或重排;同一问题同时出现在规范与可维护性时保留可维护性条目。结尾给出每轴发现数量与最严重程度,以及 approve、approve with nits 或 request changes 的明确结论,并指出最严重问题。
适用场景:需要从多个独立视角审查近期代码变更、避免单一视角掩盖问题的开发流程。
限制:必须提供固定点;无规格信号时跳过规格轴并注明“no spec available”;子代理需真正并行启动以保持上下文隔离;基准点过期(如本地 main 落后于 origin/main)会导致 diff 错误,应先 fetch 或固定到 origin/main。具体安装命令与收费信息暂未提供。