SuperAPI AI 工具集

pr-ready

通用与其它

查看项目

更新于 10-16 03:14

技能介绍

用途:让一个已打开但无法合并的 PR/MR 变得可合并。它不开发新功能,也不做顺手改动,只处理两类阻塞:过期的基线或红色 CI,以及未解决的评审线程。

主要能力:

  • 基线更新与 CI:先查找该 PR 的 worktree(优先复用用户已有的),执行 git fetch origin <default>。若仓库禁止强推或用户要求合并,则把 origin/<default> 合并进现有分支而不改写提交;否则 rebase 到 origin/<default>。解决冲突时需兼顾双方意图与回归测试。推送时若 rebase 改写了历史则用 --force-with-lease。随后观察 CI,只修复由 rebase 或该分支既有问题导致的失败;默认分支上的上游 flaky 问题应如实说明,不得用删除无关测试来掩盖。
  • 评审线程:先提交并推送未推送的工作,列出未解决的行内评论与评审正文。可请求仓库的评审机器人并等待,若约 10–15 分钟仍卡住则说明。逐条处理:有效则修复并解决;错误或过时则简短回复并解决;范围外的 nit 只问一次。未经修复或明确覆盖,不得解决 #1 维护者的评论。推送后重复,直到未解决线程清空或仅剩用户同意延期的。
  • 完成判定:重新查询 forge,不轻信推送已让 CI 变绿或回复已解决线程。任何红色检查或未解决线程都意味着未完成。需确认 PR API 的 head 与推送的 SHA 一致后再归因检查结果。

使用方式:依赖 git、gh(GitHub)或 glab(GitLab)等命令行工具。资料给出的常用命令包括:gh pr view <N> --json url,headRefName,baseRefName,statusCheckRollup、gh pr checks <N>、gh api repos/{owner}/{repo}/pulls/<N>/comments、gh api repos/{owner}/{repo}/pulls/<N>/reviews、gh pr edit <N> --add-reviewer copilot,以及 glab mr view <N>、glab ci status、glab mr note <N>。

适用场景:已有 PR/MR 因基线过期、CI 失败或评审线程未解决而无法合并时;需要处理 Copilot 或人工评审意见时;需要区分 CI 失败原因(如 V8 堆限制与容器 OOM)时。

限制与边界:不做重构、改样式或“顺便”修复;不扩展 PR 描述或取代 PR,除非被要求;前提错误的 PR 应停止并转交 pr-triage。不得删除无关测试、绕过钩子来隐藏问题、改写已发布历史或删除活跃锁。资料未提供安装方式、收费、价格与平台支持信息。