用途:对 HEAD 与用户指定的固定点(提交 SHA、分支、标签、main、HEAD~5 等)之间的 diff 做双维度评审,两个维度互不干扰,分别由并行子智能体执行后汇总。
两个维度: 编码标准:代码是否符合仓库中记录的编码规范。若仓库无记录,则始终附加一组 Fowler 代码坏味道基线(如 Mysterious Name、Duplicated Code、Feature Envy、Data Clumps、Primitive Obsession、Repeated Switches、Shotgun Surgery、Divergent Change、Speculative Generality、Message Chains、Middle Man、Refused Bequest)。仓库文档标准优先于基线;基线项始终是判断性提示,非硬性违规;工具已能强制检查的内容跳过。 规格:代码是否忠实实现了来源 issue/规格。
使用方式:
- 固定基点:由用户指定,未指定则询问。捕获 git diff <fixed-point>...HEAD(三点,对比合并基点)及 git log <fixed-point>..HEAD --oneline。先用 git rev-parse 确认基点可解析且 diff 非空,否则在此步失败。
- 识别规格来源:按顺序查提交消息中的 issue 引用(经 docs/agents/issue-tracker.md 工作流获取)、用户传入路径、docs/、specs/ 或 .scratch/ 下匹配分支名的规格文件。未找到则询问,若用户说没有,Spec 子智能体跳过并报告"无可用规格"。
- 识别标准来源:仓库中记录代码写法的文档,如 CODING_STANDARDS.md、CONTRIBUTING.md。
- 并行生成两个子智能体,分别给出 diff 命令与提交列表,Standards 还需附带标准来源文件与完整坏味道基线;两段指令要求均控制在 400 词以内。
- 汇总:在 ## Standards 与 ## Spec 标题下分别原样呈现两份报告,不合并、不重新排序。最后给一行总结:各维度发现总数及各自最严重问题,不跨维度选单一最优。
限制与依赖:需要用户提供固定基点;规格缺失时仅做标准维度;若缺少 docs/agents/issue-tracker.md,会提示用户运行 /setup-matt-pocock-skills。平台支持情况、收费与价格信息暂未提供。