用途:监控 GitHub Actions CI 运行直到结束,并报告判定结果。适用于推送后查看 CI、检查构建状态、监控 PR 检查、等待 CI 完成等场景。不适用于推送代码(用 /push-ci)、创建 PR(用 /create-pr)或运行本地测试(用 /verify 或 /precommit)。
主要能力:自动检测分支与 SHA,查找匹配的 CI 运行,先做快速状态检查,再通过 gh run watch 监控进行中的运行,最后汇总判定。支持多运行并行监控,整体结果取最差(任一失败即整体失败)。
使用方式:默认自动检测当前分支与 HEAD SHA,也可用参数指定。常用参数包括 --sha、--branch、--timeout(默认 10 分钟)、--interval(默认 30 秒)、--run-id、--blocking、--background。默认使用 Monitor 流式模式,非阻塞地接收状态通知;--blocking 为前台阻塞模式;--background 为旧版回退模式,仅返回单个完成事件,自动报告不可靠。查找运行使用 gh run list --branch "$BRANCH" --limit 30 --json databaseId,headSha,status,name,url,监控使用 gh run watch <run-id> --exit-status -i "$INTERVAL"。
限制:仅允许使用 gh、git、Read 和 Monitor 命令;不得用一次 gh run view 代替监控;不得用 gh run list 结果作为最终判定;不得以 sleep N(N≥2)作为首个命令;Monitor 可用时不应使用后台模式。若重试后仍无匹配运行,会提示可能原因(未配置工作流、路径过滤未触发等)。超时则报告为超时。