SuperAPI AI 工具集

fix-ci

部署与运维

查看项目

更新于 10-16 09:48

技能介绍

用途:当用户要求修复 CI,或 PR 工作中的必需检查变红时使用该技能。其核心原则是“红色检查只是路由证据,不等于归属”,必须在改动代码前找到造成失败的因果方。

主要能力与流程:

  1. 冻结失败:读取仓库说明,检查工作树、分支、脏状态、活动 PR、目标分支与堆栈;运行 CI 提供方最轻量的认证与连通性预检(GitHub 可用 gh auth status 加一次只读 API 探测);在改动前快照 PR 头、基、状态、可合并性、检查与审核状态;读取失败作业的注解与日志,记录工作流、作业、运行 URL、头 SHA、失败文本与首个可操作帧。步骤完成条件是每个变红的必需检查都有记录并绑定到确切 SHA。
  2. 证明因果归属:将失败头与 PR diff、合并结果、目标分支、目标分支近期运行及已存在修复 PR 对比,把每个失败归为且仅归为一类:current-pr(当前 diff 引入)、target-branch(目标分支独立存在)、existing-fix(已有 PR 或更新提交负责修复)、external(运行器、提供方、网络、配额或依赖服务)、flaky-or-unknown(证据不足或不可复现,可重试一次原作业并保留原始证据)。需用行为与溯源证据,不能仅凭文件名重叠判断;完成条件是分类具备三份证明:失败日志、相关源码或配置接缝、与目标分支或归属变更的对比。
  3. 在归属处修复:当前 PR 的失败在当前分支修复,必要时按仓库要求变基或合并目标分支;目标分支的失败保留特性工作树,派发独立工作树与会话从最新目标分支建分支,复现、实现窄修复、运行失败检查与仓库门禁、开独立修复 PR 并链接受影响 PR;已有修复时不要重复,按修复 PR 先合并、再更新被阻 PR、再跑精确头 CI 的顺序处理;外部或偶发失败保持源码不变,重试、监控或按证据上报提供方事件。
  4. 判断合并影响:分别给出因果性(当前 PR 是否导致失败)与可合并性(策略与分支保护是否允许合并)两个结论,目标分支归属的失败可能代码无问题但仍机械性阻断合并,应明确说明。绝不因修 CI 而自动合并特性 PR;独立 CI 修复 PR 仅在用户明确记录偏好、修复窄且不改产品行为/数据/权限/安全/迁移/发布语义、必需检查在精确头全绿、当前头自动审核无可操作发现、审核线程均已处置且可合并等条件全部满足时才可自动合并;无偏好时在首个此类 PR 达到门禁时询问一次。
  5. 闭环报告:报告因果归属分类及三份证明、修复位置与 PR/分支/精确头 SHA、运行的检查与本地门禁及结果、当前头自动审核与未决线程状态、因果性/可合并性/必需合并顺序,以及剩余阻塞或单一用户动作。

限制:资料未提供安装命令、价格或平台支持等具体信息;该技能依赖 CI 提供方证据与仓库策略,偶发或未知失败在可复现、可辩护地判为偶发或由提供方负责前仍是信心阻塞。