SuperAPI AI 工具集

watch-ci

通用与其它

查看项目

更新于 10-16 07:13

技能介绍

watch-ci 用于在后台监控 GitHub Pull Request 的 CI 检查状态,并在检查结束时通过 macOS 系统通知提醒。适用于用户想监控 CI/CD 状态,或说出“watch CI”“check CI”等场景。

主要能力:轮询 PR 检查直至到达终态;对已合并的 PR,可转而监控目标分支上合并提交对应的 CI。轮询由纯 shell 循环实现(gh CLI + jq),通过 Bash 以 run_in_background: true 启动,不生成子代理,token 仅在启动和完成时消耗,而非每个轮询周期。

使用方式:脚本位于 scripts/notify.sh(macOS 通知)、scripts/poll-pr-checks.sh <pr-number> [max-min](轮询开放 PR 检查)、scripts/poll-runs.sh <branch> <commit-sha> [max-min](轮询分支+提交的工作流运行)。默认上限 60 分钟、轮询间隔 30 秒。用 gh pr view --json ... 识别 PR;开放 PR 执行 bash $HOME/.claude/skills/watch-ci/scripts/poll-pr-checks.sh <PR_NUMBER>,已合并 PR 执行 bash $HOME/.claude/skills/watch-ci/scripts/poll-runs.sh <BASE_BRANCH> <MERGE_SHA>。成功后通知成功音并输出 RESULT: PASSED(退出 0);失败输出 RESULT: FAILED(退出 1)并附失败检查名;超时输出 RESULT: TIMEOUT(退出 2)。若检查已通过或失败,走前台快捷路径直接通知并分析失败日志。

限制:在 Claude Code Web($CLAUDE_CODE_REMOTE=true)上 gh 不可用,脚本无法运行,需改用 GitHub MCP 或 Monitor 工具轮询,且 Web 上无 macOS 通知。需 gh CLI 已认证并有仓库访问权限;通知依赖 macOS osascript。已合并 PR 仅报告不自动修复目标分支。