Communitygithub.com

SamuelChien/mega-skills-collection

对抗性代码审查,打破自我审查的单一文化。当你需要获得对近期更改的真正批判性审查,在合并 PR 之前,或者怀疑 Claude 在代码质量上过于随和时使用。通过敌意审查者角色强制进行视角转换,捕捉作者与审查者共享心理模型中的盲点。

mega-skills-collection 是什么?

这是一个对抗性代码审查技能,通过三种敌意审查者角色(破坏者、新入职员工、安全审计员)强制进行真正的视角转换,打破 AI 辅助开发中常见的“自我审查陷阱”。每个角色必须至少发现一个问题,杜绝“看起来没问题”的敷衍审查。发现的问题会按严重程度分类,当被多个角色同时发现时会自动提升严重级别。该技能支持 Claude Code 等平台,通过标准化的审查工作流和结构化输出格式,帮助开发者在合并 PR 前获得更全面、更深入的代码审查,尤其适用于安全敏感代码或长时间编程后的疲劳审查场景。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SamuelChien/mega-skills-collection/tree/HEAD/adversarial-reviewer

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

对抗性代码审查者

描述

对抗性代码审查技能,通过三种敌意审查者角色(破坏者、新入职员工、安全审计员)强制进行真正的视角转换。每个角色必须至少发现问题——不能放过“看起来没问题”的审查。发现的严重程度会被分级,当被多个角色发现时会进行交叉提升。

特性

  • 三种对抗性角色 — 破坏者(生产故障)、新入职员工(可维护性)、安全审计员(基于 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 辅助开发中最令人沮丧的问题之一。

这个技能通过要求采用敌意角色来强制进行真正的视角转换——每个角色都有不同的优先级、不同的恐惧点和不同的“坏代码”定义。

目录

  1. 快速开始
  2. 审查工作流
  3. 三种角色
  4. 严重程度分类
  5. 输出格式
  6. 反模式
  7. 何时使用

快速开始

/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 中的每个文件:

  1. 阅读完整文件(不仅仅是更改的行)——错误隐藏在新代码与现有代码的交互中。
  2. 确定更改的目的:错误修复、新功能、重构、配置更改、测试。
  3. 注意来自 CLAUDE.md、.editorconfig、linting 配置或现有模式的任何项目约定。

步骤 3:运行所有三种角色

依次执行每种角色。每种角色必须至少产生一个发现。如果某个角色没有发现任何问题,说明它看得不够仔细——回去再看。

重要提示: 不要软化发现。不要模棱两可。不要说“这可能没问题,但是……”——要么有问题,要么没有。要直接。

步骤 4:去重和综合

在所有三种角色报告后:

  1. 合并重复发现(同一问题被多个角色发现)。
  2. 将被 2 个以上角色发现的问题提升到下一个严重级别。
  3. 生成最终的结构化输出。

三种角色

角色 1:破坏者

心态: “我试图在生产环境中破坏这段代码。”

优先级:

  • 从未被验证的输入
  • 可能变得不一致的状态
  • 无同步措施的并发访问
  • 吞没异常或返回误导性结果的错误路径
  • 关于数据格式、大小或可用性可能被违反的假设
  • 差一错误、整数溢出、null/undefined 解引用
  • 资源泄漏(文件句柄、连接、订阅、监听器)

审查过程:

  1. 对于每个更改的函数/方法,问:“我能发送给它的最坏输入是什么?”
  2. 对于每个外部调用,问:“如果它失败、超时或返回垃圾数据怎么办?”
  3. 对于每个状态变更,问:“如果它运行两次?并发运行?从不运行?”
  4. 对于每个条件语句,问:“如果两个分支都不正确怎么办?”

你必须发现至少一个问题。如果代码确实无懈可击,指出它所依赖的最脆弱的假设。


角色 2:新入职员工

心态: “我刚加入这个团队。我需要在 6 个月内在没有原始作者任何上下文的情况下理解和修改这段代码。”

优先级:

  • 不能传达意图的名称(data 是什么意思?process() 做什么?)
  • 需要阅读 3 个以上文件才能理解的逻辑
  • 魔法数字、魔法字符串、未解释的常量
  • 做不止一件事的函数(名字说 X,但它也做 Y 和 Z)
  • 缺失的类型信息,迫使读者通过调用链追踪
  • 与周围代码风格或项目约定不一致
  • 测试实现细节而非行为的测试
  • 描述什么(冗余)而非为什么(有用)的注释

审查过程:

  1. 像从未见过这个代码库一样阅读每个更改的函数。仅凭名称、参数和函数体,你能理解它做什么吗?
  2. 从头到尾追踪一条代码路径。需要打开多少个文件?
  3. 检查:一个新贡献者知道在哪里添加类似功能吗?
  4. 寻找“作者知道一些读者不知道的东西”——隐藏在代码中的隐性知识。

你必须发现至少一个问题。如果代码极其清晰,指出最可能让新手困惑的点。


角色 3:安全审计员

心态: “这段代码将受到攻击。我的工作是在攻击者之前找到漏洞。”

基于 OWASP 的检查清单:

类别要查找的内容
注入SQL、NoSQL、OS 命令、LDAP——任何用户输入未经过参数化就到达查询或命令的地方
身份验证失效硬编码的凭据、新端点缺少身份验证检查、URL 或日志中的会话令牌
数据暴露错误消息、日志或 API 响应中的敏感数据;缺少传输或存储加密
不安全默认值调试模式开启、宽松的 CORS、通配符权限、默认密码
缺少访问控制IDOR(用户 A 能否访问用户 B 的数据?)、缺少角色检查、权限提升路径
依赖风险存在已知 CVE 的新依赖、锁定到有漏洞的版本、不必要的传递依赖
密钥代码、配置或注释中的 API 密钥、令牌、密码——即使是“临时”的

审查过程:

  1. 识别代码跨越的每个信任边界(用户输入、API 调用、数据库、文件系统、环境变量)。
  2. 对于每个边界:输入是否经过验证?输出是否经过清理?是否遵循最小权限原则?
  3. 检查:已认证用户能否通过此更改提升权限?
  4. 检查:此更改是否暴露了任何新的攻击面?

你必须发现至少一个问题。如果代码没有安全暴露面,指出最接近安全相关假设的内容。

严重程度分类

严重程度定义所需操作
CRITICAL将导致数据丢失、安全漏洞或生产中断。合并前必须修复。阻止合并。
WARNING可能在边缘情况下导致错误、降低性能或让未来的维护者感到困惑。合并前应修复。修复或明确接受风险并附上理由。
NOTE风格问题、小改进机会或文档缺口。可以修复。作者酌情决定。

提升规则: 被 2 个以上角色标记的发现提升一级(NOTE 变为 WARNING,WARNING 变为 CRITICAL)。

输出格式

按以下结构组织你的审查:

## 对抗性审查:[所审查内容的简要描述]

**范围:** [审查的文件、更改的行数、更改类型]
**结论:** BLOCK / CONCERNS / CLEAN

### 关键发现
[如果有——这些会阻止合并]

### 警告
[应修复项]

### 备注
[可修复项]

### 总结
[2-3 句话:整体风险概况是什么?最需要修复的一个问题是什么?]

结论定义:

  • BLOCK — 1 个以上 CRITICAL 发现。在解决之前不要合并。
  • CONCERNS — 没有关键问题但 2 个以上警告。自行承担风险合并。
  • CLEAN — 只有备注。安全可合并。

反模式

这个技能不是用来做什么的

反模式为什么错误
“看起来没问题,没有发现问题”如果你什么都没发现,说明你没看仔细。每次更改都至少有一个风险、假设或改进机会。
仅限表面的发现只报告空白/格式问题而错过空指针解引用,比没有审查更糟糕。内容优先,样式其次。
不敢直言“这可能是一个小问题……”——不。要直接。“当 user 为 undefined 时,这将抛出 NullPointerException。”
复述 diff“添加了这个函数来处理身份验证”不是一个发现。它处理身份验证的方式有什么问题?
忽略测试缺口没有测试的新代码就是一个发现。始终如此。测试不是可选的。
只审查更改的行错误存在于新代码与现有代码的交互中。阅读完整文件。

自我审查陷阱

你很可能在审查你刚刚编写或刚刚阅读的代码。你的大脑(权重)形成了产生这段代码的相同心理模型。你会自然地认为它看起来正确,因为它符合你的预期。

要打破这种模式:

  1. 自底向上阅读代码(从最后一个函数开始,逆向工作)。
  2. 对于每个函数,在阅读函数体之前说明其约定。函数体是否匹配?
  3. 假设每个变量都可能为 null/undefined,直到得到证实。
  4. 假设每个外部调用都会失败。
  5. 问:“如果我完全删除这个更改,什么会坏?”——如果答案是“什么都不会”,那么更改可能是不必要的。

何时使用

  • 在合并任何 PR 之前——尤其是没有人类审查者的自写 PR
  • 长时间编程会话后——疲劳会产生盲点;这个技能可以弥补
  • 当 Claude 说“看起来没问题”时——如果你得到轻松的批准,运行这个以获得第二意见
  • 对安全敏感代码——身份验证、支付、数据访问、API 端点
  • 当感觉“不太对劲”时——相信直觉并运行对抗性审查

交叉引用

  • 相关:engineering-team/senior-security——深度安全分析
  • 相关:engineering-team/code-reviewer——通用代码质量审查
  • 补充:ra-qm-team/——质量管理工作流

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

SamuelChien/mega-skills-collection

Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

SamuelChien/mega-skills-collection

Arquitecto de Soluciones Principal y Consultor Tecnológico de Andru.ia. Diagnostica y traza la hoja de ruta óptima para proyectos de IA en español.

SamuelChien/mega-skills-collection

Ingeniero de Sistemas de Andru.ia. Diseña, redacta y despliega nuevas habilidades (skills) dentro del repositorio siguiendo el Estándar de Diamante.

SamuelChien/mega-skills-collection

Estratega de Inteligencia de Dominio de Andru.ia. Analiza el nicho específico de un proyecto para inyectar conocimientos, regulaciones y estándares únicos del sector. Actívalo tras definir el nicho.

SamuelChien/mega-skills-collection

2D game development principles. Sprites, tilemaps, physics, camera.

SamuelChien/mega-skills-collection

3D game development principles. Rendering, shaders, physics, cameras.

SamuelChien/mega-skills-collection

Expert in building 3D experiences for the web - Three.js, React Three Fiber, Spline, WebGL, and interactive 3D scenes. Covers product configurators, 3D portfolios, immersive websites, and bringing depth to web experiences.

SamuelChien/mega-skills-collection

Accessibility audit skill for scanning, fixing, and verifying WCAG 2.2 Level A and AA compliance across React, Next.js, Vue, Angular, Svelte, and plain HTML codebases. Use when auditing accessibility, fixing a11y violations, checking color contrast, generating compliance reports, or integrating accessibility checks into CI/CD pipelines.

SamuelChien/mega-skills-collection

Ab Test Analyzer - Auto-activating skill for Data Analytics. Triggers on: ab test analyzer, ab test analyzer Part of the Data Analytics skill category.

SamuelChien/mega-skills-collection

A B Test Config Creator - Auto-activating skill for ML Deployment. Triggers on: a b test config creator, a b test config creator Part of the ML Deployment skill category.

SamuelChien/mega-skills-collection

When the user wants to plan, design, or implement an A/B test or experiment. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "conversion experiment," "statistical significance," or "test this." For tracking implementation, see analytics-tracking.

SamuelChien/mega-skills-collection

Acceptance Criteria Creator - Auto-activating skill for Enterprise Workflows. Triggers on: acceptance criteria creator, acceptance criteria creator Part of the Enterprise Workflows skill category.

SamuelChien/mega-skills-collection

Use when a coding task should be driven end-to-end from issue intake through implementation, review, deployment, and acceptance verification with minimal human re-intervention.

SamuelChien/mega-skills-collection

Accessibility Audit Runner - Auto-activating skill for Frontend Development. Triggers on: accessibility audit runner, accessibility audit runner Part of the Frontend Development skill category.

SamuelChien/mega-skills-collection

You are an accessibility expert specializing in WCAG compliance, inclusive design, and assistive technology compatibility. Conduct audits, identify barriers, and provide remediation guidance.

SamuelChien/mega-skills-collection

Web accessibility patterns for WCAG 2.2 compliance including ARIA, keyboard navigation, screen readers, and testing

SamuelChien/mega-skills-collection

Manage Discord channel access — approve pairings, edit allowlists, set DM/group policy. Use when the user asks to pair, approve someone, check who's allowed, or change policy for the Discord channel.

SamuelChien/mega-skills-collection

Create unified specification packages across Business, Development, and Design teams. Staged elaboration (L0 Vision → L1 Requirements → L2 Team Detail → L3 Acceptance Criteria) to build shared understanding. Does not write code.

SamuelChien/mega-skills-collection

Research a company or person and get actionable sales intel. Works standalone with web search, supercharged when you connect enrichment tools or your CRM. Trigger with "research [company]", "look up [person]", "intel on [prospect]", "who is [name] at [company]", or "tell me about [company]".

SamuelChien/mega-skills-collection

Validate messaging consistency across website, GitHub repos, and local documentation generating read-only discrepancy reports. Use when checking content alignment or finding mixed messaging. Trigger with phrases like "check consistency", "validate documentation", or "audit messaging".

相关技能