babysitting-pr 是一个面向拉取请求(PR)维护场景的技能。当用户已有开启的 PR,并希望代理持续监控它、修复 CI 失败、处理审查评论、保持其处于可合并状态时,可使用该技能。
用途
该技能用于自动照看一个开启中的 PR:检查 CI 状态、审查评论与合并冲突,并自动尝试修复可处理的问题。
主要能力
- 获取 PR 状态:通过 gh pr view --json number,title,state,mergeable,reviewDecision,statusCheckRollup,comments,reviews 获取当前状态,并通过 gh pr view --json mergeStateStatus 检查合并冲突。
- 检查 CI 状态:查看 statusCheckRollup 字段,使用 gh pr checks 列出所有 CI 检查及其状态(通过/失败/等待中)。
- 修复 CI 失败:对每个失败检查,使用 gh run view <run-id> --log-failed 获取日志,分析并修复:
- Lint 失败:本地运行 linter(npm run lint -- --fix),手动修复剩余问题并提交。
- 类型错误:运行 npx tsc --noEmit,读取错误、修复类型并提交。
- 测试失败:本地运行失败测试套件,读取断言错误,修复代码或更新测试预期并提交。
- 构建失败:运行 npm run build,读取错误输出,修复导入/配置/缺失依赖并提交。
- 修复后推送:git add -A && git commit -m "fix: resolve CI failures" && git push
- 处理审查评论:使用 gh api repos/{owner}/{repo}/pulls/{pr}/comments 获取评论。对每条未解决评论:阅读评论及其引用的代码;若修复明确(拼写、命名、缺失空值检查、风格问题),则应用;若需要设计决策或澄清,则跳过并报告用户。提交修复:git add -A && git commit -m "fix: address review feedback" && git push
- 解决合并冲突:若 PR 有冲突,执行 git fetch origin main 和 git merge origin main,通过阅读双方内容选择正确解决方案,模糊冲突询问用户。解决后:git add -A && git commit -m "fix: resolve merge conflicts" && git push
- 重新检查状态:推送修复后,等待 CI 运行并再次检查:gh pr checks --watch。若出现新失败,返回第 3 步。限制为 3 轮,避免无限循环。
- 报告:总结失败过哪些 CI 检查及如何修复、处理了哪些审查评论、是否解决合并冲突、当前 PR 状态(可合并或仍被什么阻塞)。
循环行为
该技能设计为循环运行:检查 PR → 发现问题 → 修复问题 → 推送 → 重新检查 → 重复。
停止条件:
- 所有检查通过、无未解决评论、无冲突 → PR 可合并。
- 已尝试 3 个修复-推送-检查周期仍未完全解决 → 报告仍失败的内容。
- 某项修复需要设计决策 → 询问用户。
注意事项
- 绝不强制推送到共享 PR 分支。
- 不要仅为让测试通过而修改测试断言,除非行为变更是有意的。
- 对不确定的审查评论不要自行解决——跳过并告知用户。
- 若 CI 处于排队/等待中,先等待其完成再分析失败。
- 一切正常后,可使用 gh pr ready 将 PR 标记为可供审查。