过去半年我大部分代码是让编码 agent 写的,但真正花时间的不是写代码,而是写代码
前后的那些事:读 issue、拆任务、盯 PR 的检查、解冲突、等 CI 绿了再点合并。于是
我写了个小工具 gh-issue-killer:
一个 Go 单文件程序,监听 GitHub issue,让 opencode / Claude Code / Codex 在独立
worktree 里把活干完,你用评论控制节奏。下面按"为什么"和"怎么用"讲一遍。
这些问题本质上是同一件事:流程的状态没有地方存,所以每推进一步都要人记着。
gh-issue-killer 的做法是把状态放进 state.json,把每一步变成可恢复的阶段。
不用背命令,正常流程只有两步需要你出手。
@yourname-agent(或把 issue assign 给它)。daemon 从
base 分支拉一个 detached worktree,agent 看过需求和仓库后发一条计划评论,标上
agent:awaiting-approval,批准之前不写代码。带 bug 标签的 issue 跳过计划,直接复现、修复
并补回归测试。@agent lgtm(continue、继续 也行),或者直接给计划评论点 👍。
在同一个 worktree 里开始写代码,必要时带上你补充的要求。result.json 汇报改了
什么、怎么测的;checks.json 说明要跑哪些检查命令和超时。检查由 daemon 执行,
失败就把输出回给 agent 修,默认最多 3 轮(maxFixRounds)。Closes #n,并贴一条"实现
完成"评论。原来是 UI 改动的,PR 里会有改动区域的前后对比截图。ci_fix),job 卡住、需要维护者批准、分支冲突都能识别并处理。@agent 合并,或者给 PR 公告评论点 👍:再解一次冲突、跑本地检查、
过 CI,然后 squash merge、关 issue、删分支和 worktree。每个阶段都写在状态里,所以重启 daemon 会接着做;关掉 issue 会取消任务并关闭 PR,
重新打开会继续。任务只是在等你看一眼时才会停下(blocked),比如检查修了几轮仍
然失败。
| 评论 | 效果 |
|---|---|
@agent lgtm、@agent continue、@agent 继续
|
批准计划(或 blocked 后重试) |
@agent 合并、@agent merge、@agent ship
|
squash merge PR,关 issue + PR,清理 worktree |
@agent review、@agent cr(在 PR 上) |
审查这个 PR 的 diff,发表总结 + 行内意见 |
@agent <指令>(在 PR 上) |
直接改这个 PR:改代码、跑检查,把提交推到 PR head |
@agent apply、@agent 应用(在 PR 上) |
直接按最近一次 review 的意见修改,不再重跑 review |
@agent 合并、@agent merge(在 PR 上) |
解冲突、跑检查和 CI,然后 squash merge 这个 PR |
@agent cancel、@agent stop、@agent 停止
|
中止当前任务 |
| plan 评论上的 👍 | 等同 @agent lgtm
|
| PR 公告评论上的 👍 | 等同 @agent 合并
|
| bot 那条"Review 已提交"评论上的 👍 | 按这条 review 的意见直接改 PR 并推送 |
两条规则值得记一下:命令必须来自 approvers 里的人、必须 @ 了 agent、而且
整条评论就是命令;其它评论(比如在 PR 上提意见)会被当成修改要求,交给同一个
worktree 里的 agent 处理。
它是单个静态二进制,运行时只需要 git、一个编码 agent CLI 和 /bin/sh,只发起
出站 HTTPS,不需要开任何入站端口。
最省事的办法是把仓库交给 Claude Code、Codex 或 opencode,让它按 DEPLOY.md 自己
部署。仓库里有一段现成的 prompt,大意是"按第 0–5 节装好、自己推断默认值、最多问
一个问题",agent 会装二进制、按需创建 bot 的 gh-agent wrapper、写配置、跑冒烟
测试、起 daemon,只在需要 bot token 时停下来——那一步只能你本人登录。
手动安装也就四行:
go build -o bin/gh-issue-killer ./cmd/gh-issue-killer
./bin/gh-issue-killer -init # 向导:仓库、agent、approvers、代理
./bin/gh-issue-killer # 后台 daemon
./bin/gh-issue-killer -status # pid、配置、日志和状态路径
配置是 repos / codingAgent / approvers / proxy 几个字段,每个仓库可以单独
覆盖 agent、model、approvers 和语言。保存配置就会热重载,不用重启。
配置 webPort(比如 8787)就能打开一个只在 127.0.0.1 上监听的看板:每个仓库
自己的队列和并发表、阶段进度、PR、检查结果、截图,计划按 Markdown 渲染。顶部显示
"待我处理"的任务数(待批准、待合并、被阻塞),任务列表能按项目过滤、按关键字搜索,
也能一键隐藏已完成和已取消。界面可以中英文切换,主题跟随系统或固定日间/夜间。

看板截图:左边是各仓库的队列余量,右边是每个 issue 的阶段、PR、检查进度。
gh auth token。如果想看看它在真实仓库里跑一整条链路,可以先跑 scripts/smoke-test.sh owner/repo。
代码是 MIT 协议:github.com/uiautodev/gh-issue-killer。
用着有问题、或者你的流程跟它不一样,欢迎开 issue 直接 @ 它自己——它就是这么被
开发出来的。