用途
cursor-fix-ci 用于在分支或 PR 的 CI 检查失败时,提供一条快速、迭代的路径,使检查恢复为绿色。它适合需要频繁处理 PR 检查失败、希望以最小改动快速修复 CI 的开发者。
主要能力
- 解析当前活跃的 PR,并检查
gh pr checks --json name,bucket,state,workflow,link的输出。 - 检查失败的任务,提取第一个可操作的错误。
- 在可用时使用 GitHub Actions 日志;否则通过检查链接识别失败的命令或服务。
- 应用最小的安全修复。
- 推送后重新检查 PR 检查集,并重复该过程直到全部通过。
使用方式
该技能的工作流为:
- 解析活跃 PR,并检查
gh pr checks --json name,bucket,state,workflow,link。 - 检查失败的任务并提取第一个可操作的错误。优先使用 GitHub Actions 日志;若不可用,则通过检查链接定位失败的命令或服务。
- 应用最小的安全修复。
- 推送,重新检查 PR 检查集,重复直到绿色。
适用场景
- 分支或 PR 的 CI 失败,需要快速迭代修复。
- 需要以
gh pr checks作为 PR CI 整体状态的事实来源进行判断。 - 希望在修复 CI 时优先采用最小、低风险改动,而非大范围重构。
限制与边界
- 一次只修复一个可操作的失败。
- 优先采用最小、低风险的改动,再考虑更广泛的重构。
- 保持
gh pr checks作为 PR CI 整体状态的事实来源。 - 将仓库审查、本地编辑、推送分支、创建或更新 PR、合并视为不同的效果。每次外部写入都需验证目标仓库与当前用户授权。
- 若推送或 PR 发布尚未授权,则完成本地分支、差异、检查与草稿 PR 文本,使审批成为最后一步。
- 除非单独请求,否则不执行合并。
- 在上述边界内保留上游审查与 CI 工作流。
输出
- 主要失败任务与根错误。
- 按迭代顺序应用的修复。
- 当前 CI 状态与下一步操作。