SuperAPI AI 工具集

gh-workflow-monitoring

办公与效率

查看项目

更新于 10-15 23:49

技能介绍

用途:使用 gh run watch 监控 GitHub Actions 工作流运行。该命令会阻塞直到运行结束,无需轮询循环或超时管理,适合推送后等待 CI、触发工作流后跟进进度,以及按运行结果链式执行后续步骤。

主要能力:

  • 阻塞式跟踪运行直到完成,实时显示进度,并返回退出码(成功为 0,失败为非零)。
  • 支持 --compact 精简输出(仅显示相关/失败步骤,推荐给智能体)、--exit-status 失败时非零退出、-i/--interval 设置刷新间隔(默认 3 秒)。
  • 配合 gh run list 可按状态(queued、in_progress、completed、waiting、pending、requested)、工作流、分支、事件筛选运行;配合 gh run view 可查看状态、作业、步骤、失败日志或完整日志。
  • 可从 --log 的制表符分隔输出中提取某一步骤的原始 stdout,用于读取成功步骤中的结构化标记。

必要用法示例: gh run watch $RUN_ID --compact --exit-status gh run list --status in_progress --json databaseId,name gh run view $RUN_ID --log-failed gh workflow run "CI" && sleep 2 && gh run watch --compact --exit-status

适用场景:推送后等待 CI、触发并跟进工作流、等待 PR 检查、监控多个运行、诊断失败、CI 集成流程。

限制:需要已安装并认证 GitHub CLI;运行 ID 需先通过 gh run list 获取;触发后需等待 GitHub 注册运行(示例中用 sleep);该技能聚焦监控,不负责自动修复失败检查或读取已完成运行的堆栈跟踪,这些由其他技能处理。