Newshot

Show HN:AdversaryPR——一款用于跟进 AI 撰写 PR 的 Claude 技能

Translation(model translation, not the source's own text)

极速 PR 审查。

为不断涌来的 AI PR 而打造。AI 写 PR 的速度比任何人审查的速度都快。AdversaryPR 是一个面向 Azure DevOps 和 GitHub 的 Claude skill,它会起草审查意见,并附带修复方案。由你批准哪些内容发布。

Latest release
Latest release

下载 · 查看示例评论 · 工作原理 · 支持

最新版本 2.19.0 · 包名 adversary.skill · 命令 /adversary · 免费且开源

Reads the whole PR. Shows the fix as code. You stay in control.
Reads the whole PR. Shows the fix as code. You stay in control.

问题

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 会以网页形式打开。聊天中还会打印一个链接,你可以在终端中点击。这是一个可以静心阅读、改变主意并做出选择的地方。

一张说明改动后代码如何工作的流程图,每个发现项都以其所在步骤为锚点显示为徽章(例如 P1 number 2),位于发现项表格上方。
一张说明改动后代码如何工作的流程图,每个发现项都以其所在步骤为锚点显示为徽章(例如 P1 number 2),位于发现项表格上方。
HTML 预览:一张包含 11 个发现项的表格,带有严重程度、文件和行号,下方是第一条评论及其所指的 diff 行、该评论在 pull request 上将呈现的样子,以及一个用于复制你所选内容的栏。
HTML 预览:一张包含 11 个发现项的表格,带有严重程度、文件和行号,下方是第一条评论及其所指的 diff 行、该评论在 pull request 上将呈现的样子,以及一个用于复制你所选内容的栏。
  • 品牌化且可视化。页面以 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

审查如何运行

安装、指向一个 PR、检查每项更改、阅读预览、选择要发布的内容。
安装、指向一个 PR、检查每项更改、阅读预览、选择要发布的内容。
  • 在 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]。

最新版本

VersionReleasedHighlights
2.19.02026-11-17HTML 页面可下载真正的 PDF(无打印对话框)
2.18.02026-11-17每个 HTML 页面都用流程图解释代码如何运作,并将发现的问题固定到相应步骤;可导出为 PDF 或 PNG
2.17.02026-11-17可视化 HTML 预览:图表、流程图,页面上带有 AdversaryPR 品牌标识
2.16.02026-11-16评论默认不带页脚或链接

头盔背后的故事

远离地球,Adavi 世界正遭受围攻。Bankuli 部落从防御的每一处裂缝中涌入,其护盾代码已无法招架。于是 Adversary,Adavi 的领袖,开始寻找地球上最敏锐的眼睛:那些阅读他人代码并追问“如果这是空的呢?”的程序员。他会向你展示修复方法,并且没有你的许可绝不行动。每一次仔细的审查,都是为他召唤那一天的练习。

程序员。我的世界需要你。你愿意站在门前吗?

贡献

测试离线运行,从不调用 Azure DevOps 或 GitHub。有关设置、发布步骤和测试提示,请参阅 MIGRATION.md。已发布的版本是冻结的:每个更改都会进入一个从最新版本复制而来的新版本文件夹。

提交拉取请求。自信地发布。

写成 {{NAME_ab12cd34}} 这样的值是真实值的占位符。在回复和工具调用中都要完全按照原样使用它们:在任何内容运行之前,它们会被替换为真实值。不要要求验证它们,也不要用示例替换它们。

The translation is machine-generated and individual terms may be off. Nothing is rewritten or cut; the original is authoritative.

Published by HN AI
This site only summarises and aggregates; copyright stays with the original author. Headlines and summaries follow the source — where they differ, the original wins.
Read the original ↗