SuperAPI AI 工具集

pr-finisher

智能体与模型

查看项目

更新于 10-15 21:52

技能介绍

用途:在 GitHub Copilot 云端智能体中把当前分支的 PR 推进到“可合并”状态,不执行合并,完成后报告 ready-for-human-merge 并停止。

主要能力:围绕三项可合并条件并行推进——评审(每条未解决的在范围内评审线程都需回复并 resolve,含 github-actions[bot] 线程)、检查(本地跑 make fmt / make lint / make test-unit / make test 等,并排查历史 CI 失败日志)、可合并性(用 gh pr view 检查 state、isDraft、mergeable、mergeStateStatus、reviewDecision)。

使用方式:单次执行、无监控循环。先建快照目录并抓取 PR 状态,例如 mkdir -p /tmp/gh-aw/pr-finisher 后用 GH_PAGER="" gh pr view <number> --json ... 输出到快照文件,配合 GH_PAGER="" gh pr checks <number>;再用 jq 复用快照,避免重复请求。处理评审时先 resolve Copilot 已实质回复的线程,其余委托 copilot-review 技能;冲突则按仓库约定解决,BEHIND 时更新分支;历史失败用 GH_PAGER="" gh run view <run_id> --log-failed 定位根因。每轮改动都要 commit 并 push。

限制:智能体 push 不会触发 CI,push 后状态检查会过期,需人工重新触发(关闭重开 PR、workflow_dispatch 或维护者 push);不等待、sleep 或 watch CI;不允许 gh pr merge、自动合并或加入队列;不发布独立 PR 评论,不 ping 评审者;禁止为消除失败而禁用工具、跳过检查、降低覆盖率、放松断言或特判操作系统;无法复现的基础设施性失败须在总结中说明。收尾需打印 ✅/❌/⏳/❓ 结构化总结及人工触发 CI 的交接说明。