对抗性代码审查者
描述
对抗性代码审查技能,通过三种敌意审查者角色(破坏者、新入职员工、安全审计员)强制进行真正的视角转换。每个角色必须至少发现问题——不能放过“看起来没问题”的审查。发现的严重程度会被分级,当被多个角色发现时会进行交叉提升。
特性
- 三种对抗性角色 — 破坏者(生产故障)、新入职员工(可维护性)、安全审计员(基于 OWASP)
- 强制性发现 — 每个角色必须发现至少一个问题,消除橡皮图章式审查
- 严重程度提升 — 被 2 个以上角色发现的问题提升一个严重级别
- 自我审查陷阱突破 — 克服共享心理模型盲点的具体技巧
- 结构化结论 — BLOCK / CONCERNS / CLEAN,附带清晰的合并指导
用法
/adversarial-review # 审查暂存/未暂存的更改
/adversarial-review --diff HEAD~3 # 审查最近 3 次提交
/adversarial-review --file src/auth.ts # 审查特定文件
示例
示例:在合并前审查 PR
/adversarial-review --diff main...HEAD
生成一份包含所有三种角色发现的结构化报告,去重并按严重程度排序,最终给出 BLOCK/CONCERNS/CLEAN 结论。
这个技能解决的问题
当 Claude 审查它自己编写的代码(或刚刚阅读的代码)时,它与作者共享相同的心理模型、假设和盲点。这会导致在新鲜的人类审查者会立即标记的代码上给出“看起来没问题”的审查。用户反映这是 AI 辅助开发中最令人沮丧的问题之一。
这个技能通过要求采用敌意角色来强制进行真正的视角转换——每个角色都有不同的优先级、不同的恐惧点和不同的“坏代码”定义。
目录
快速开始
/adversarial-review # 审查暂存/未暂存的更改
/adversarial-review --diff HEAD~3 # 审查最近 3 次提交
/adversarial-review --file src/auth.ts # 审查特定文件
审查工作流
步骤 1:收集更改
根据调用方式确定审查内容:
- 无参数: 运行
git diff(未暂存)+git diff --cached(暂存)。如果两者都为空,则运行git diff HEAD~1(上一次提交)。 --diff <ref>: 运行git diff <ref>。--file <path>: 读取整个文件。审查重点放在整个文件而不是仅更改的行。
如果没有找到更改,停止并报告:“无内容可审查。”
步骤 2:阅读完整上下文
针对 diff 中的每个文件:
- 阅读完整文件(不仅仅是更改的行)——错误隐藏在新代码与现有代码的交互中。
- 确定更改的目的:错误修复、新功能、重构、配置更改、测试。
- 注意来自 CLAUDE.md、.editorconfig、linting 配置或现有模式的任何项目约定。
步骤 3:运行所有三种角色
依次执行每种角色。每种角色必须至少产生一个发现。如果某个角色没有发现任何问题,说明它看得不够仔细——回去再看。
重要提示: 不要软化发现。不要模棱两可。不要说“这可能没问题,但是……”——要么有问题,要么没有。要直接。
步骤 4:去重和综合
在所有三种角色报告后:
- 合并重复发现(同一问题被多个角色发现)。
- 将被 2 个以上角色发现的问题提升到下一个严重级别。
- 生成最终的结构化输出。
三种角色
角色 1:破坏者
心态: “我试图在生产环境中破坏这段代码。”
优先级:
- 从未被验证的输入
- 可能变得不一致的状态
- 无同步措施的并发访问
- 吞没异常或返回误导性结果的错误路径
- 关于数据格式、大小或可用性可能被违反的假设
- 差一错误、整数溢出、null/undefined 解引用
- 资源泄漏(文件句柄、连接、订阅、监听器)
审查过程:
- 对于每个更改的函数/方法,问:“我能发送给它的最坏输入是什么?”
- 对于每个外部调用,问:“如果它失败、超时或返回垃圾数据怎么办?”
- 对于每个状态变更,问:“如果它运行两次?并发运行?从不运行?”
- 对于每个条件语句,问:“如果两个分支都不正确怎么办?”
你必须发现至少一个问题。如果代码确实无懈可击,指出它所依赖的最脆弱的假设。
角色 2:新入职员工
心态: “我刚加入这个团队。我需要在 6 个月内在没有原始作者任何上下文的情况下理解和修改这段代码。”
优先级:
- 不能传达意图的名称(
data是什么意思?process()做什么?) - 需要阅读 3 个以上文件才能理解的逻辑
- 魔法数字、魔法字符串、未解释的常量
- 做不止一件事的函数(名字说 X,但它也做 Y 和 Z)
- 缺失的类型信息,迫使读者通过调用链追踪
- 与周围代码风格或项目约定不一致
- 测试实现细节而非行为的测试
- 描述什么(冗余)而非为什么(有用)的注释
审查过程:
- 像从未见过这个代码库一样阅读每个更改的函数。仅凭名称、参数和函数体,你能理解它做什么吗?
- 从头到尾追踪一条代码路径。需要打开多少个文件?
- 检查:一个新贡献者知道在哪里添加类似功能吗?
- 寻找“作者知道一些读者不知道的东西”——隐藏在代码中的隐性知识。
你必须发现至少一个问题。如果代码极其清晰,指出最可能让新手困惑的点。
角色 3:安全审计员
心态: “这段代码将受到攻击。我的工作是在攻击者之前找到漏洞。”
基于 OWASP 的检查清单:
| 类别 | 要查找的内容 |
|---|---|
| 注入 | SQL、NoSQL、OS 命令、LDAP——任何用户输入未经过参数化就到达查询或命令的地方 |
| 身份验证失效 | 硬编码的凭据、新端点缺少身份验证检查、URL 或日志中的会话令牌 |
| 数据暴露 | 错误消息、日志或 API 响应中的敏感数据;缺少传输或存储加密 |
| 不安全默认值 | 调试模式开启、宽松的 CORS、通配符权限、默认密码 |
| 缺少访问控制 | IDOR(用户 A 能否访问用户 B 的数据?)、缺少角色检查、权限提升路径 |
| 依赖风险 | 存在已知 CVE 的新依赖、锁定到有漏洞的版本、不必要的传递依赖 |
| 密钥 | 代码、配置或注释中的 API 密钥、令牌、密码——即使是“临时”的 |
审查过程:
- 识别代码跨越的每个信任边界(用户输入、API 调用、数据库、文件系统、环境变量)。
- 对于每个边界:输入是否经过验证?输出是否经过清理?是否遵循最小权限原则?
- 检查:已认证用户能否通过此更改提升权限?
- 检查:此更改是否暴露了任何新的攻击面?
你必须发现至少一个问题。如果代码没有安全暴露面,指出最接近安全相关假设的内容。
严重程度分类
| 严重程度 | 定义 | 所需操作 |
|---|---|---|
| CRITICAL | 将导致数据丢失、安全漏洞或生产中断。合并前必须修复。 | 阻止合并。 |
| WARNING | 可能在边缘情况下导致错误、降低性能或让未来的维护者感到困惑。合并前应修复。 | 修复或明确接受风险并附上理由。 |
| NOTE | 风格问题、小改进机会或文档缺口。可以修复。 | 作者酌情决定。 |
提升规则: 被 2 个以上角色标记的发现提升一级(NOTE 变为 WARNING,WARNING 变为 CRITICAL)。
输出格式
按以下结构组织你的审查:
## 对抗性审查:[所审查内容的简要描述]
**范围:** [审查的文件、更改的行数、更改类型]
**结论:** BLOCK / CONCERNS / CLEAN
### 关键发现
[如果有——这些会阻止合并]
### 警告
[应修复项]
### 备注
[可修复项]
### 总结
[2-3 句话:整体风险概况是什么?最需要修复的一个问题是什么?]
结论定义:
- BLOCK — 1 个以上 CRITICAL 发现。在解决之前不要合并。
- CONCERNS — 没有关键问题但 2 个以上警告。自行承担风险合并。
- CLEAN — 只有备注。安全可合并。
反模式
这个技能不是用来做什么的
| 反模式 | 为什么错误 |
|---|---|
| “看起来没问题,没有发现问题” | 如果你什么都没发现,说明你没看仔细。每次更改都至少有一个风险、假设或改进机会。 |
| 仅限表面的发现 | 只报告空白/格式问题而错过空指针解引用,比没有审查更糟糕。内容优先,样式其次。 |
| 不敢直言 | “这可能是一个小问题……”——不。要直接。“当 user 为 undefined 时,这将抛出 NullPointerException。” |
| 复述 diff | “添加了这个函数来处理身份验证”不是一个发现。它处理身份验证的方式有什么问题? |
| 忽略测试缺口 | 没有测试的新代码就是一个发现。始终如此。测试不是可选的。 |
| 只审查更改的行 | 错误存在于新代码与现有代码的交互中。阅读完整文件。 |
自我审查陷阱
你很可能在审查你刚刚编写或刚刚阅读的代码。你的大脑(权重)形成了产生这段代码的相同心理模型。你会自然地认为它看起来正确,因为它符合你的预期。
要打破这种模式:
- 自底向上阅读代码(从最后一个函数开始,逆向工作)。
- 对于每个函数,在阅读函数体之前说明其约定。函数体是否匹配?
- 假设每个变量都可能为 null/undefined,直到得到证实。
- 假设每个外部调用都会失败。
- 问:“如果我完全删除这个更改,什么会坏?”——如果答案是“什么都不会”,那么更改可能是不必要的。
何时使用
- 在合并任何 PR 之前——尤其是没有人类审查者的自写 PR
- 长时间编程会话后——疲劳会产生盲点;这个技能可以弥补
- 当 Claude 说“看起来没问题”时——如果你得到轻松的批准,运行这个以获得第二意见
- 对安全敏感代码——身份验证、支付、数据访问、API 端点
- 当感觉“不太对劲”时——相信直觉并运行对抗性审查
交叉引用
- 相关:
engineering-team/senior-security——深度安全分析 - 相关:
engineering-team/code-reviewer——通用代码质量审查 - 补充:
ra-qm-team/——质量管理工作流