OpenSwarm PR自动驾驶指南:pr命令如何自动处理冲突、CI失败与评审意见
OpenSwarm PR自动驾驶指南:pr命令如何自动处理冲突、CI失败与评审意见
OpenSwarm 是一个由 AI Agent 驱动的开源 DevOps 编排器,它的 openswarm pr 命令组可以把 PR(Pull Request)从"红变绿"的全过程交给 Agent 自动驾驶:检测合并冲突并自动修复、盯着 CI 失败日志改代码、逐条落实评审意见,直到 PR 达到 merge-ready。本文带你完整走一遍这套 PR 自动驾驶工作流的每个环节。
什么是 PR 自动驾驶?
想象一下最让人头疼的 PR 收尾场景:
- 主分支刚合并了别人的代码,你的 PR 突然出现合并冲突;
- CI 挂了,错误日志一屏屏往下滚;
- 评审人留下
CHANGES_REQUESTED,还有几条 🔴 级别的行内评论。
以前这些事全靠人肉来回切换终端。OpenSwarm 的 pr 命令组把这些活儿打包成了一条命令的事:
| 子命令 | 作用 | 典型用法 |
|---|---|---|
pr status |
PR 状态快照:冲突 / CI / 评审意见 | openswarm pr status --json |
pr fix |
一次性修复:冲突 → 评审 → CI 全流程 | openswarm pr fix |
pr review |
只处理评审反馈,不碰冲突和 CI | openswarm pr review --fresh |
pr watch |
循环修复直到 merge-ready(默认 5 轮) | openswarm pr watch |
pr create |
本地修复 → 提交 → 推送 → 创建 PR | openswarm pr create |
这套命令是按需调用的(on-demand),底层复用了常驻 daemon 里的 PRProcessor 引擎。需要强调的是:自动驾驶不会自动合并 PR,最后按下"合并"按钮的永远是人。
一键安装步骤
先装好 OpenSwarm,再配一个 AI 模型提供方(如 OpenRouter 的 API Key),PR 自动驾驶就能跑起来:
npm install -g @intrect/openswarm
export OPENROUTER_API_KEY=***
openswarm init # 交互式向导:AI提供方 / 任务后端 / 通知渠道
openswarm doctor # 诊断环境,确认各环节就绪
💡 除 OpenRouter 外,也支持 ChatGPT OAuth(Codex/GPT)、Claude Code CLI、本地 Ollama / LM Studio 等模型来源,详见 README.md。
第一步:pr status 看懂 PR 到底卡在哪
修复之前先"诊断"。pr status 会并行拉取四路信息并生成一份快照:合并冲突、CI 状态、正式评审(reviews)、行内评论(comments)。
openswarm pr status # 人类可读的报告
openswarm pr status --json # 机器可读;exit 0 仅当 merge-ready
它的核心是一个阻塞器优先级分类器——按 conflicts → 评审意见 → CI 失败 → CI 运行中 的顺序,找出当前最优先要解决的那件事(源码见 prStatus.ts)。输出示例:
owner/repo#42 — Add auth caching
conflicts: YES
ci: FAIL (typecheck, unit-test)
reviews: 1 CHANGES_REQUESTED
- alice: please extract the token logic into a helper
blocker: merge conflicts
ready: no
--json 模式配合退出码(0 = merge-ready)非常适合写进 CI 或脚本里做门禁判断(快照类型定义见 PrStatusSnapshot)。
第二步:pr fix 一条龙修复冲突与 CI
pr fix 是整个自动驾驶的发动机。它针对当前分支关联的 open PR(或用 --number N 指定),按固定优先级执行:冲突 → 评审意见 → CI(完整路由逻辑见 prCommand.ts)。
自动处理合并冲突
发现冲突后,内置的 ConflictResolver 会接管:它先做所有权检查(daemon 常驻模式下只处理机器人自己开的 PR;CLI 手动调用则任何 PR 都可以),再受"最多尝试 3 次"的预算约束,避免无限空转(尝试计数逻辑见 conflictResolver.ts)。解决失败时不会默默放弃——它会直接在 PR 上留言,提示需要人工处理:
## ⚠️ PR has merge conflicts - cannot auto-resolve (not owned or max attempts reached)
Please resolve conflicts manually.
自动处理 CI 失败
这是最有价值的环节。PRProcessor 会把 PR 分支 checkout 到本地,然后进入修复-验证重试循环(默认最多 3 次):
- 喂料:把失败的 check 名称、最近 3000 字符的失败日志、PR 的 diff 片段(前 5000 字符)打包成一份结构化任务,并明确指示"只做最小改动,不要改架构";
- 修复:交给 Worker-Reviewer 流水线(
pairPipeline)迭代修码,AI 改完先过一遍审查再放行; - 验证:push 回 PR 分支后,
waitForCICompletion每 30 秒轮询 CI 状态(最长等 10 分钟),并核对"跑 CI 的确实是刚 push 的那个 commit",防止拿到过期的绿灯; - 循环:CI 还是红,就带着新日志再来一轮,直到变绿或耗尽重试次数。
修复成功后,PR 上会自动留下一条"交卷"评论,方便评审人快速了解改了什么:
## ✅ Auto-fix completed - CI passing
Summary: fixed 2 type errors in auth module
Files changed: src/auth/token.ts, src/auth/cache.ts
Total attempts: 1
安全护栏:它"乱动"之前先保护现场
PR 处理前会 git stash 暂存你本地未提交的改动,处理完自动恢复;结束后切回你原来的分支;多个 PR 命令并发时还有跨进程租约(lease)防止互相踩工作区(stash 保护见 prProcessor.ts,租约设计见 fixOne)。所以放心让它跑,你的半成品不会丢。
第三步:pr review 自动落实评审意见
pr fix 会在 CI 变绿后顺带处理评审;如果你只想单独跟进评审反馈,用 pr review:
- 识别两类信号:正式评审的
CHANGES_REQUESTED,以及包含 critical / bug / 🔴 等关键词的关键评论(关键词表见 prStatus.ts); - 把每位评审人的意见整理成带
文件:行号的反馈清单,喂给 Agent 逐条修改(反馈汇总构建见 prProcessor.ts); - 最多迭代 5 轮;已处理过的旧反馈会用"时间戳水位线"标记,不会反复修同一条意见导致死循环。
两个进阶开关值得知道:
openswarm pr review --fresh # 不依赖已有反馈,对当前 diff 做全新代码审查并回帖
openswarm pr review --all # 顺序审查仓库里所有 open PR
--fresh 模式非常讲究:它在临时 git worktree 里做只读审查(连 bash 工具都禁用),不碰你的工作目录,审查结论会连同具体审查的 commit SHA 一起回帖到 PR 上,避免"审了 A 版本却写成 A 版本通过"的歧义(实现见 freshReview)。
第四步:pr watch 挂机式循环修复
pr fix 是一次性冲刺,pr watch 则是"挂机模式"——最多 5 轮(--rounds 可调)循环执行:拉状态快照 → 已 merge-ready 就退出 → CI 还在跑就等它 → 有阻塞就执行一轮 fix → push 后等 CI(见 watch 实现):
openswarm pr watch # 默认最多 5 轮
openswarm pr watch --rounds 10
每轮开始都会打印一份完整状态报告,整个过程透明可追溯。5 轮后仍未就绪也不会悄悄收尾,而是明确报告"最后卡在哪":
Gave up after 5 round(s). Last blocker: ci
从零发布:pr create 的完整旅程
反过来,如果你手里是一个改好的 feature 分支,pr create 能把它一键送上 PR 轨道(实现见 prCreate.ts):
- 先本地跑一遍
openswarm fix(可用--no-fix跳过)——不推送红灯代码; - 校验工作区干净、分支有 upstream、且有领先 upstream 的提交,否则直接报错拦截;
- commit → push →
gh pr create,自动带上--issue INT-123生成的 conventional commit 和Closes关联。
openswarm pr create --issue INT-123 --title "feat: auth caching layer"
进阶:daemon 常驻模式下的全自动巡航
上面都是"手动挡"。如果你在 config.yaml 里配置了 PR 监控仓库,OpenSwarm 的 daemon 会按 cron 计划周期性巡航所有 open PR:先查冲突、再查评审反馈、最后查 CI,只有发现真问题才唤醒 Agent 修复(巡航扫描逻辑见 processPRs)。配合 --max 审计和 Discord / Slack 通知,就形成了一条完整的 PR 自愈流水线。
常见问题 FAQ
Q:自动驾驶会自动帮我 merge PR 吗?
不会。pr 命令组只负责"修到绿",合并决策始终留给人。
Q:修复失败会怎样?
PR 上会留下 ## ❌ Auto-fix failed after N attempt(s) 评论并说明最后错误,daemon 模式还会推送到你的通知渠道,绝不静默失败。
Q:会动我本地未提交的代码吗? 不会。处理前自动 stash 保护,结束后切回原分支并恢复现场。
Q:和 openswarm review 的 --max --fix 有什么区别?
review --max --fix 是提交前/本地 diff 的合并门禁(审计整个代码库后修复并走确定性验证);pr 命令组面向已经开出去的 PR,处理的是远端的冲突、CI 和评审反馈。
总结:把 PR 收尾变成一句话的事
| 场景 | 一条命令 |
|---|---|
| 想知道 PR 卡在哪 | openswarm pr status --json |
| 冲突 + 评审 + CI 一起治 | openswarm pr fix |
| 只跟进评审意见 | openswarm pr review |
| 挂机修到 merge-ready | openswarm pr watch |
| 分支改好直接发 PR | openswarm pr create |
OpenSwarm 用"Agent 干活 + 确定性验证把关 + 人工最终合并"的三层设计,让 AI 的自动化既激进又安全。核心实现可以从这几个文件读起:命令路由 prCommand.ts、状态快照 prStatus.ts、修复引擎 prProcessor.ts 和冲突解析器 conflictResolver.ts。


