Code review
沿两个轴审查自某个固定基点(提交、分支、标签或合并基点)以来的变更——标准(代码是否遵循本仓库记录的编码标准?)和规格(代码是否符合来源事项/PRD 的要求?)。由并行子智能体执行两项审查,并并列报告结果。用户希望审查分支、PR、进行中的变更,或要求“审查自 X 以来的内容”时使用。From its SKILL.md
npx -y skills add 15102045545/skills-cn --skill code-reviewAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
6.8 KB, as published. Nobody here has run it
对 HEAD 与用户提供的固定基点之间的差异执行双轴审查:
- 标准——代码是否符合本仓库记录的编码标准?
- 规格——代码是否忠实实现了来源事项/PRD/规格?
两个轴均由并行子智能体执行,以免相互污染上下文;随后本技能汇总它们的发现。
问题跟踪器应当已经提供给你——如果还没有,请运行 /setup-matt-pocock-skills;判断依据是 docs/agents/issue-tracker.md 是否缺失。
流程
1. 确定固定基点
用户指定的内容就是固定基点——提交 SHA、分支名、标签、main、HEAD~5 等。如果用户没有指定,请询问。
只记录一次差异命令:git diff <fixed-point>...HEAD(三点语法,因此会相对于合并基点进行比较)。同时通过 git log <fixed-point>..HEAD --oneline 记录提交列表。
继续前,确认固定基点可解析(git rev-parse <fixed-point>),且差异非空。无效引用或空差异应当在这里失败,而不是等到两个并行子智能体内部才失败。
2. 确定规格来源
按以下顺序查找来源规格:
- 提交消息中的事项引用(
#123、Closes #45、GitLab!67等)——通过docs/agents/issue-tracker.md中的工作流获取。 - 用户作为参数传入的路径。
docs/、specs/或.scratch/下与分支名或功能匹配的 PRD/规格文件。- 如果什么也没找到,询问用户规格在哪里。如果用户说没有规格,则跳过规格子智能体并报告“没有可用规格”。
3. 确定标准来源
仓库中记录代码编写方式的任何内容,例如 CODING_STANDARDS.md 或 CONTRIBUTING.md。
除仓库记录的内容外,标准轴始终包含下方的异味基线——一组固定的 Fowler 代码异味(《重构》,第 3 章),即使仓库没有记录任何标准也适用。它受两条规则约束:
- 以仓库为准。 仓库中记录的标准始终优先;如果它认可了基线会标记的做法,则不报告该异味。
- 始终需要判断。 每种异味都是带标签的启发式判断(“可能存在依恋情结”),绝不是硬性违规;与这里的任何标准一样,跳过工具已经强制执行的内容。
每种异味都按“它是什么 → 如何修复”描述;请据此检查差异:
- 神秘命名(Mysterious Name)——函数、变量或类型的名称没有揭示其作用或保存的内容。→ 重命名;如果无法给出诚实的名称,说明设计含糊不清。
- 重复代码(Duplicated Code)——相同的逻辑形态出现在变更的多个区块或文件中。→ 提取共享形态,让两处都调用它。
- 依恋情结(Feature Envy)——方法访问另一个对象的数据多于访问自身的数据。→ 把方法移到它所依恋的数据上。
- 数据泥团(Data Clumps)——相同的几个字段或参数总是一起传递(说明一个类型正等待诞生)。→ 将它们组合成一个类型,并传递该类型。
- 基本类型偏执(Primitive Obsession)——用基本类型或字符串表示理应拥有自身类型的领域概念。→ 为该概念创建一个小型专用类型。
- 重复的 Switch(Repeated Switches)——针对同一类型的相同
switch/if级联在变更中反复出现。→ 用多态替换,或让两处共享一份映射。 - 霰弹式修改(Shotgun Surgery)——一项逻辑变更迫使你分散修改差异中的许多文件。→ 将一起变化的内容聚合到同一个模块。
- 发散式变化(Divergent Change)——出于若干互不相关的原因编辑同一个文件或模块。→ 拆分,使每个模块只因一个原因而变化。
- 夸夸其谈的通用性(Speculative Generality)——为规格中不存在的需求添加抽象、参数或钩子。→ 删除它;不断内联还原,直到出现真实需求。
- 消息链(Message Chains)——调用方不应依赖的长链式导航
a.b().c().d()。→ 将这段遍历隐藏到第一个对象的某个方法之后。 - 中间人(Middle Man)——主要只是继续委派的类或函数。→ 去掉它,直接调用真正的目标。
- 被拒绝的遗赠(Refused Bequest)——子类或实现者忽略或覆盖了所继承内容中的大部分。→ 放弃继承,改用组合。
4. 并行启动两个子智能体
在一条消息中发出两次 Agent 工具调用。两者都使用 general-purpose 子智能体。
标准子智能体提示词——包括:
- 完整的差异命令和提交列表。
- 你在步骤 3 中找到的标准来源文件列表,外加步骤 3 的完整异味基线——子智能体无法通过其他方式获取它。
- 简报:“按相关文件/区块报告:(a) 差异中违反已记录标准的每一处:引用标准(文件 + 规则);(b) 你发现的任何基线异味:说出名称并引用区块。区分硬性违规与判断项——违反已记录标准可以是硬性违规,但基线异味始终是判断项,并且仓库中记录的标准优先于基线。跳过工具已经强制执行的内容。少于 400 个词。”
规格子智能体提示词——包括:
- 差异命令和提交列表。
- 规格的路径或已获取内容。
- 简报:“报告:(a) 规格要求但缺失或仅部分实现的需求;(b) 差异中未经要求的行为(范围蔓延);(c) 看似已实现、但实现方式似乎有误的需求。每项发现都要引用对应规格行。少于 400 个词。”
如果缺少规格,跳过规格子智能体,并在最终报告中注明。
5. 汇总
在 ## 标准 和 ## 规格 标题下呈现两份报告,可保持原样或做轻微整理。不得合并发现或重新排序——两个轴是有意分开的(参见“为何使用两个轴”)。
最后用一行总结:每个轴的发现总数,以及 各轴内部 最严重的问题(如有)。不要跨轴选出一个最严重问题——这种重新排序正是分离两轴所要防止的。
为何使用两个轴
一项变更可能通过一个轴,却未通过另一个轴:
- 代码遵循了所有标准,却实现了错误的内容 → 标准通过,规格失败。
- 代码完全实现了事项要求,却违反了项目约定 → 规格通过,标准失败。
分别报告可防止一个轴掩盖另一个轴的问题。