极速 PR 审查。
为不断涌来的 AI PR 而打造。AI 写 PR 的速度比任何人审查的速度都快。AdversaryPR 是一个面向 Azure DevOps 和 GitHub 的 Claude skill,它会起草审查意见,并附带修复方案。由你批准哪些内容发布。
下载 · 查看示例评论 · 工作原理 · 支持
最新版本 2.19.0 · 包名 adversary.skill · 命令 /adversary · 免费且开源
问题
AI 编码工具意味着开发者现在提交的 pull request 远超以往,而团队创建 PR 的速度也比人们审查它们的速度更快。
- 有些 PR 无法及时得到审查。它们搁置数天,逐渐过时。
- PR 等待的时间越长,越有可能在合并时发生冲突。
- 依赖它的工作在下游停滞。
- 仔细阅读一个大型 AI 编写的 PR 需要真正的精力,而审查者就是瓶颈。
解决方案
AdversaryPR 帮助你跟上 AI 编写 PR 的速度。它为你提供一种更快、更有把握的审查方式:它会通读整个 pull request(diff、调用方以及缺失的内容),起草行内评论,每条评论都指出一个故障或代价,并以代码形式展示修复方案,同时以可视化方式呈现变更(严重程度图表、将发现项固定在步骤上的流程图、PDF),让 PR 能够被快速理解。它可以同时审查多个 PR。由你挑选哪些内容发布。
它不做的事:它从不批准、合并或阻止 PR,未经你批准绝不发布,不运行你的代码或测试,也不替代人工审查或测试。它无法捕捉所有问题。它让每次审查更快、更有把握,从而减少搁置的 PR;它不管理你的队列,也不修复合并冲突。
它是什么
AdversaryPR 是站在代码双方——作者一方以及你这一方——的细致审查者。
- 它检查每一处变更。它会针对空输入、错误路径、重试、并发、部分失败、升级和回滚提出“如果……会怎样”的问题。它将标题、描述、命名、注释和通过的测试与代码的实际行为进行比对。它会阅读调用方,并寻找 diff 中缺失的内容。
- 每条评论都有清晰的理由和修复方案。每条评论都落在确切的行上,用平实的语言直击要点,在有用时向作者提出一个简短的问题,指出故障场景或代价,并以代码片段展示一个推荐的修复方案。
- 同时处理多个 PR。在 Claude Code 中,每个 PR 都有自己的后台审查 agent,全部同时运行,你可以在一个合并预览中批准。
- 你的语言和你仓库的约定。支持 Swift、Kotlin、Java、Python、Go 和 TypeScript,并对 SOLID(深入检查 SRP)、DRY、YAGNI 以及反模式目录进行设计检查。它还会读取 PR 所在仓库中的 CLAUDE.md、AGENTS.md、CONTRIBUTING.md 和 Copilot 指令文件。
- 你始终掌控全局。你会看到每条评论的预览,然后挑选哪些发送到 PR。在你批准之前不会发布任何内容,dry run 不会发布任何内容。
评论长什么样
这是一个虚构的导出示例。它展示的就是最终出现在你 pull request 某一行上的内容。
Sam 评论了 /src/orders/export.ts 的第 6 行 订单缺失时可能崩溃 在检查 db.orders.find 是否找到订单之前就读取了 order.total。订单有可能缺失吗?如果订单在导出排队后被删除,find 会返回 undefined。然后 order.total 会抛出异常,导出会在文件处理到一半时停止。请查看下方建议的修复方案,除非这是有意为之。const order = await db.orders.find(id); if (!order) { log.warn("order " + id + " not found, skipped"); continue; } await csv.write(order.total.toFixed(2));
Sam 评论了 /src/orders/export.ts 的第 6 行
订单缺失时可能崩溃
文章标题:Show HN: AdversaryPR – 一个用于跟进 AI 撰写 PR 的 Claude 技能
正文: 在检查 db.orders.find 是否找到订单之前就读取了 order.total。订单有可能缺失吗?
如果订单在导出任务排队后被删除,find 会返回 undefined。随后 order.total 抛出异常,导出在文件写到一半时中断。
请看一下下面建议的修复,除非这是有意为之。
const order = await db.orders.find(id);
if (!order) { log.warn("order " + id + " not found, skipped"); continue; }
await csv.write(order.total.toFixed(2));
每条评论都有相同的结构:
| 部分 | 作用 |
|---|---|
| 标题 | 用几个词说明问题 |
| 提问(在有所帮助时) | 一个简短的问题,仅在作者是知道答案的人时提出,以便他们可以说明这是有意为之 |
| 失败场景 | 一个具体的场景或一项明确的代价,绝不是含糊的「考虑重构」 |
| 引导语 | 「请看一下下面建议的修复,除非这是有意为之。」 |
| 修复 | 一个推荐的修复方案,以代码片段形式给出确切改动的行,或指向你仓库中已有的模式 |
它对双方都公平:在评论之前会考虑作者的立场,如果你不同意,它会再看一遍。
在 GitHub 上一键修复
在 GitHub 上,修复可以一键变成一次提交。当建议的修复恰好替换了评论所指的那些行时,该技能会将其发布为 GitHub suggested change。GitHub 随后会在评论上显示 Commit suggestion 按钮,以及 Add suggestion to batch,这样你可以把多个修复放进一次提交。
- 审查。在一个 GitHub PR 上运行 /adversary,并批准你想要的评论。它们会作为一次带有行内评论的 review 发布。
- 点击。有权限推送到该 PR 分支的人打开评论并点击 Commit suggestion,或在多条评论上点击 Add suggestion to batch,然后提交这一批。
- 完成。GitHub 会在 PR 分支上创建提交。
GitHub 如此显示它:
@@ src/orders/export.ts @@
- const order = await db.orders.find(id);
- await csv.write(order.total.toFixed(2));
+ const order = await db.orders.find(id);
+ if (!order) { log.warn("order " + id + " not found, skipped"); continue; }
+ await csv.write(order.total.toFixed(2));
[ Commit suggestion ] [ Add suggestion to batch ]
这些限制,以免有意外的惊喜:
- 如果修复没有恰好替换评论所指的那些行,它就会作为普通代码块发布,而不是 suggested change。
- 在 Azure DevOps 上没有对应的功能。修复就是一个代码块。
- 该技能本身从不提交或推送代码。一键提交是 GitHub 自带的功能,由点击按钮的人完成。
在发布前查看每一条评论
在一次运行中加入 html(/adversary 38842 ; html),review 会以网页形式打开。聊天中还会打印一个链接,你可以在终端中点击。这是一个可以静心阅读、改变主意并做出选择的地方。


- 品牌化且可视化。页面以 AdversaryPR 的 logo、名称和版本开头,并以图表形式按严重程度和按文件展示发现项。
- 代码如何工作的流程图。每个页面都以流程图解释改动的代码,流程图根据所读取的代码绘制。每个发现项都以可点击的徽章固定在它发生的步骤上。带有失败路径的发现项可以有自己的小流程图。它们可以离线工作,并且永远不会成为评论的一部分。
文章标题:Show HN: AdversaryPR —— 一个用于跟进 AI 撰写的 PR 的 Claude skill
正文:
- 保存。该 skill 会把 preview.pdf 保存在页面旁边,页面的 Download PDF 按钮会按下它下载为真正的 PDF,不弹出打印对话框。每个流程图都有一个 Save PNG 按钮,
--png会把整个页面保存为一张图片。
- 每条评论紧挨着它的代码。评论周围的 diff 行会被高亮显示,方便你结合上下文判断。
- 评论会以拉取请求将呈现的样子显示,并给出将要发布的确切 markdown。
- 每条评论都有一个复选框。取消勾选你不想要的那些,然后把回复(例如 1 3-5)复制回聊天中。
- 位置检查。如果某条评论的行不在 diff 中,它会在发布任何内容之前将其标记出来。
- 安全。它不从网络加载任何内容,也无法发布。
适用对象
| 分组 | 对象 | 说明 |
|---|---|---|
| 它审查并发布到的 Git 托管平台 | Azure DevOps GitHub | 完整流程:它会获取拉取请求、进行审查,并在你批准后发布行内评论。 |
| 运行它的位置 | Claude Code Claude apps | 终端中的 Claude Code,以及支持 skill 的 Claude apps。 |
| 在你的 IDE 中 | VS Code Visual Studio JetBrains | 通过 Claude Code 的 IDE 扩展在 VS Code 和 JetBrains 中运行。通过 GitHub Copilot 移植版在 VS Code、Visual Studio 和 JetBrains 中运行。 |
| 将审查规则粘贴到 | GitHub Copilot Cursor Windsurf Gemini Code Assist CodeRabbit GitLab Bitbucket | 审查规则也以提示词形式提供,适用于任何接受文本的工具。该分组仅以提示词形式获得规则。发布到拉取请求仅支持 Azure DevOps 和 GitHub。 |
产品名称和徽标是其所有者的商标,仅用于说明 AdversaryPR 可与哪些产品配合使用。不暗示任何认可或关联关系。
安装和使用
Claude Code
从最新发布版下载 adversary.skill,将其解压到你的 skills 文件夹,然后输入 /adversary 并附上 PR 编号或链接(Azure DevOps 或 GitHub)。
unzip adversary.skill -d ~/.claude/skills/
/adversary 38842
Claude apps
在你组织管理 Claude skill 的位置上传 adversary.skill。
GitHub Copilot
Copilot 移植版与该 skill 是分开的。将指令和提示词文件复制到你的仓库中:
| 从 | 到 |
|---|---|
| AdversaryPR/instructions/ | .github/instructions/ |
| AdversaryPR/prompts/adversary.prompt.md | .github/prompts/ |
AdversaryPR/universal-prompt.md 是同一套审查规则,整合为一个提示词,适用于任何接受文本的工具。
命令
选项放在第一个 ; 之后,可自由组合。
| 命令 | 作用 |
|---|---|
| /adversary 38842 | 用最新版本(2.19.0)审查一个 PR。 |
| /adversary 38842 ; html | 最新版本,外加一个网页预览,每条评论紧挨着它所指向的代码。 |
| /adversary 38842 ; model=haiku | 最新版本,由 Haiku 审查。也可用 sonnet 、 opus 、 fable 。 |
| /adversary 38842 38901 39010 ; dry run | 同时审查三个 PR。不发布任何内容。 |
| /adversary https://github.com/acme/orders-api/pull/101 ; dry run | 一个 GitHub 拉取请求,审查但不发布。 |
组合使用:/adversary 38842 38901 ; dry run ; html ; model=sonnet
审查如何运行
- 在 Claude Code 或你的 Claude app 中安装该 skill。
- 指向一个 PR:/adversary 38842。
- 它检查每项更改并起草评论,每条评论都带有明确的理由和建议的修复方案。
- 你查看预览。
- 你选择要发布的内容,例如 1 3-5 或 all。dry run 不发布任何内容。
| 你输入 | 会发生什么 |
|---|---|
| 1 3-5 | 发布评论 1、3、4 和 5。 |
| all | 发布预览中的每一条评论。 |
| dry run(作为选项) | 仅审查。不发布任何内容。 |
html 预览不从网络加载任何内容,也无法发布。在 GitHub 上,评论会以已登录用户的身份,作为一个带行内评论的审查发布。
安全且可预测
文章标题:Show HN: AdversaryPR——一个用来跟进 AI 编写 PR 的 Claude 技能
正文:
- 你的 token 留在本地。所有 Azure DevOps 和 GitHub 调用都在你的会话中预先完成。审查代理从不接收 token,也从不调用这两个服务。在 GitHub 上,它可以复用你的 gh CLI 登录信息,因此可能完全不需要处理 token。
- 有多个组织?在 ~/.ado-pr-review-creds.json(仅所有者可读)中为每个组织、项目或仓库保存一个 Azure DevOps token,每个 PR 会使用对应的那个。用隐藏提示添加,这样 token 就不会出现在聊天中:! python3 ~/.claude/skills/adversary/versions/2.15.0/scripts/creds.py add --org Contoso。如果有多个 gh 账号,可以用 creds.py github-map --owner acme --gh-user alice 把某个所有者映射到其中一个账号。
- 在你批准之前,什么都不会发布。评论由你挑选。dry run 不会发布任何内容。
使用计数是可选的。匿名使用计数在你同意之前是关闭的。该技能只会询问一次。如果你同意,它会发送技能版本以及你使用的选项(dry run、html、model、pinned version),仅此而已:不含代码、不含 PR 内容、不含仓库或组织名称、不含 token。你可以随时关闭。计数会发送到托管在 Google Firebase 上的每日计数器,因此 Google 的服务器会像对待任何网站一样看到该连接。该网站还会统计下载按钮的每日点击次数,不使用 cookie,也不使用 ID,并且如果你的浏览器发送 Do Not Track,该统计会保持关闭。
为工程师打造
对人友善,对代码严谨。评论清晰且专业,针对变更本身,绝不针对个人。作者始终可以说明这是有意为之。没有讽刺,没有指责。
更好的工程师,一次审查一步。每条评论都会解释可能出什么问题以及为什么,然后给出修复方法,因此每次审查都是一堂短课,你会在这个过程中逐渐熟悉各种失败模式。就是这样运作的。我们目前还没有实测的改进数据,因此不对结果作任何声明。
谁在构建它:AdversaryPR 由 Bugsworth, LLC 制作。它在 MIT 许可证下免费且开源,并在 Anthropic 的 AI Claude 的帮助下构建。问题或想法:[email protected]。
有问题、bug、想法?在 GitHub 上开一个 issue,或写信到 [email protected]。
免费且开源
AdversaryPR 及其 GitHub Copilot 移植版免费且开源。没有人需要付费使用它们。
- 许可证:代码采用 MIT 许可证,版权归 Bugsworth, LLC 所有。名称和徽标在 TRADEMARKS.md 中单独涵盖。
- 支持:欢迎通过 [email protected] 提出问题、bug 或想法。
- 托管团队端点:即将推出。它尚未上线,细节和任何定价都尚未确定。问题或消息:[email protected]。
最新版本
| Version | Released | Highlights |
|---|---|---|
| 2.19.0 | 2026-11-17 | HTML 页面可下载真正的 PDF(无打印对话框) |
| 2.18.0 | 2026-11-17 | 每个 HTML 页面都用流程图解释代码如何运作,并将发现的问题固定到相应步骤;可导出为 PDF 或 PNG |
| 2.17.0 | 2026-11-17 | 可视化 HTML 预览:图表、流程图,页面上带有 AdversaryPR 品牌标识 |
| 2.16.0 | 2026-11-16 | 评论默认不带页脚或链接 |
头盔背后的故事
远离地球,Adavi 世界正遭受围攻。Bankuli 部落从防御的每一处裂缝中涌入,其护盾代码已无法招架。于是 Adversary,Adavi 的领袖,开始寻找地球上最敏锐的眼睛:那些阅读他人代码并追问“如果这是空的呢?”的程序员。他会向你展示修复方法,并且没有你的许可绝不行动。每一次仔细的审查,都是为他召唤那一天的练习。
程序员。我的世界需要你。你愿意站在门前吗?
贡献
测试离线运行,从不调用 Azure DevOps 或 GitHub。有关设置、发布步骤和测试提示,请参阅 MIGRATION.md。已发布的版本是冻结的:每个更改都会进入一个从最新版本复制而来的新版本文件夹。
提交拉取请求。自信地发布。
写成 {{NAME_ab12cd34}} 这样的值是真实值的占位符。在回复和工具调用中都要完全按照原样使用它们:在任何内容运行之前,它们会被替换为真实值。不要要求验证它们,也不要用示例替换它们。