SuperAPI AI 工具集

moai-workflow-ci-watch

部署与运维

查看项目

更新于 10-16 01:17

技能介绍

用途:在 /moai sync 第 4 阶段创建 PR 后自动启动,持续监视 GitHub PR 的 CI 检查状态,判断是否可合并,或在必需检查失败时把结果交给后续自动修复流程。

主要能力:每 30 秒轮询 gh pr checks;依据 .github/required-checks.yml 的 branches.<pattern>.contexts 区分必需检查,辅助检查失败只发提示不阻塞;状态机为 idle→arm-watch→watching,出口包括全部必需通过(可合并)、必需失败(T3 交接)、仅辅助失败(提示后继续)、30 分钟超时(阻塞)。

使用方式:编排器在 gh pr create 返回 PR 号后通过 Bash 调用:MOAI_CIWATCH_GH=gh sh scripts/ci-watch/run.sh <PR_NUMBER> <BRANCH>。退出码 0 表示全部必需通过,用 moai pr watch --report <PR_NUMBER> --branch <BRANCH> 生成报告;退出码 2 表示必需失败,stdout 输出 JSON 交接给 manager-quality;退出码 3 表示 30 分钟超时。可用 moai pr watch --abort 中止。状态保存在 .moai/state/ci-watch-active.flag,心跳超过 90 秒视为陈旧并可被新调用接管。

限制:需要 gh >= 2.50 以获取 workflow JSON 字段,旧版本回退到基于名称的启发式判断;同一仓库同时只允许一个监视,重复调用会报错;轮询间隔不得低于 30 秒以避免 GitHub API 限流;CLI 不调用 AskUserQuestion,该操作仅由编排器执行;超时可通过 CIWATCH_TIMEOUT_SECONDS 环境变量调整。