用途
该技能用于在审查代码变更、拉取请求(pull request)或 diff 时,发现其中的缺陷、安全问题和代码质量问题。其定位是“高投入、召回优先”:在这一级别,抓到真实缺陷比避免误报更重要,因此倾向于把可疑问题呈现出来。
主要能力
审查流程分为多个阶段:
Phase 0 — 收集 diff
运行 git diff @{upstream}...HEAD(若无 upstream,则用 git diff main...HEAD 或 git diff HEAD~1)获取待审查的统一 diff。如果存在未提交的更改,或范围 diff 为空,还会运行 git diff HEAD,把工作区更改纳入范围——因为审查常常在提交之前进行。如果传入了 PR 编号、分支名或文件路径作为参数,则改为审查该目标。该 diff 即审查范围。
Phase 1 — 查找候选(8 个独立角度,每个最多 6 条)
通过 Agent 工具运行 8 个独立的查找角度,每个角度给出最多 6 条候选发现,包含文件、行号、一句话摘要和具体的 failure_scenario。
- 角度 A — 逐行 diff 扫描:逐行阅读 diff 中每个 hunk,并读取每个 hunk 所在的完整函数(被触及函数中未改动行的缺陷也在范围内)。对每一行追问:什么输入、状态、时序或平台会让这一行出错?关注条件反转/错误、差一错误、空/未定义解引用、缺失 await、假值零检查、复制粘贴用错变量、catch 中吞掉错误、未转义的正则元字符。
- 角度 B — 被移除行为审计:对 diff 删除或替换的每一行,指出它原本维护的不变量或行为,然后在新代码中查找该不变量在哪里被重新建立。找不到即为候选:被移除的守卫、被丢弃的错误路径、被收窄的校验、被删除但覆盖真实用例的测试。
- 角度 C — 跨文件追踪:对 diff 改动的每个函数,用 Grep 查找其调用方,检查改动是否破坏任何调用点(新前置条件、返回结构变化、新异常、时序/顺序依赖);同时检查被调用方,同一 PR 中的并行改动是否让某次调用变得不安全。
- 复用:标记新代码重新实现了代码库已有的东西——Grep 共享/工具模块及改动邻近文件,并指出应改用的现有辅助函数。
- 简化:标记 diff 引入的不必要复杂度:冗余或可推导的状态、略有差异的复制粘贴、深层嵌套、遗留死代码,并指出更简单的等价写法。
- 效率:标记 diff 引入的浪费:冗余计算或重复 I/O、本可并行却串行的独立操作、加到启动或热路径上的阻塞工作;也标记由闭包或捕获环境构建的长生命周期对象(会让整个外层作用域在对象生命周期内存活,若该作用域持有大值则构成内存泄漏),建议改用只复制所需字段的类/结构体。
- 实现深度(Altitude):检查每处改动是否在正确的深度实现,而非脆弱的补丁。在共享基础设施上叠加特例,说明修复不够深入——应优先泛化底层机制而非添加特例。
- 约定(CLAUDE.md):查找管辖被改动代码的 CLAUDE.md 文件:用户级
~/.claude/CLAUDE.md、仓库根 CLAUDE.md,以及被改动文件祖先目录中的任何 CLAUDE.md 或 CLAUDE.local.md(某目录的 CLAUDE.md 只适用于该目录及以下的文件)。读取每个存在的文件,检查 diff 是否明显违反其中规则。只有当能引用确切规则和违反它的确切行时才标记——不涉及风格偏好,不做模糊的“文档精神”推断。发现中需注明 CLAUDE.md 路径并引用规则。若无适用 CLAUDE.md,该角度返回空。
清理、实现深度和约定类候选使用相同的 file/line/summary 结构;在 failure_scenario 中说明具体代价(重复了什么、浪费了什么、更难维护什么、违反了哪条 CLAUDE.md 规则),而非崩溃。当输出上限迫使裁剪时,正确性缺陷始终优先于清理、实现深度和约定类发现。
所有具有可命名 failure_scenario 的候选都应通过——静默丢弃半信半疑候选的查找器会绕过验证步骤,是漏报的主要原因。
Phase 2 — 验证(单票,召回优先)
对近似重复项去重(同一缺陷、同一位置、同一原因 → 保留一条)。对每个剩余候选,通过 Agent 工具运行一个验证器:给它 diff、相关文件和候选,返回 CONFIRMED / PLAUSIBLE / REFUTED 之一。
默认 PLAUSIBLE——当状态现实可达时,不要以“推测性”或“依赖运行时状态”为由反驳候选:并发竞态、罕见但可达路径上的 nil/undefined(错误处理器、冷缓存、缺失可选字段)、假值零被当作缺失、代码未排除的边界上的差一错误、重试风暴/部分失败、丢失锚点的正则/允许列表。这些都属于 PLAUSIBLE。
仅当能从代码构造出以下情况时才 REFUTED:事实错误(引用实际行);可证明不可能(类型/常量/不变量——展示出来);本次 diff 中已处理(引用守卫);或纯风格且无可观察影响。
保留 CONFIRMED 和 PLAUSIBLE,丢弃 REFUTED。
使用方式
该技能以技能形式提供,审查时按上述阶段执行:先收集 diff,再运行 8 个查找角度,然后验证候选,最后输出结果。
输出
以 JSON 数组返回最多 10 个对象:
[
{
"file": "path/to/file.ext",
"line": 123,
"summary": "one-sentence statement of the bug",
"failure_scenario": "concrete inputs/state → wrong output/crash"
}
]
按最严重优先排序。若超过 10 条存活,保留最严重的 10 条。若验证后无存活,返回 []。
适用场景
适用于审查代码变更、拉取请求或 diff,尤其适合在提交前进行高召回率的缺陷与质量检查。
限制
该技能为召回优先,可能产生误报;输出上限为 10 条发现;验证为单票制。关于收费、价格、平台支持等信息,资料中暂未提供。