GitHub Actions 卡住运行审计（Stuck Run Audit）

使用此技能识别长时间处于 queued（排队中）或 in_progress（进行中）等非终态的 workflow 运行。

该技能的功能

• 读取 GitHub Actions 运行记录的 JSON 导出文件
• 检测处于非终态（如 queued、in_progress 等）的陈旧运行（stale runs）
• 按仓库/工作流（或仓库/分支）聚合卡住风险
• 依据卡住时长（stuck-age）、卡住运行数量（stuck-run volume）及卡住率（stuck-rate）阈值综合评分严重性
• 输出 ok / warn / critical 状态，并可在 CI 门禁（CI gates）中触发失败

输入参数

可选：

• RUN_GLOB（默认值：artifacts/github-actions/*.json）
• TOP_N（默认值：20）
• OUTPUT_FORMAT（可选值：text 或 json，默认值：text）
• GROUP_BY（可选值：repo、repo-workflow、repo-workflow-branch；默认值：repo-workflow）
• NOW_ISO（可选 ISO 时间戳，用于确定性重放）
• STUCK_STATUSES（逗号分隔列表，默认值：queued,in_progress,pending,waiting,requested）
• WARN_STUCK_MINUTES（默认值：45）
• CRITICAL_STUCK_MINUTES（默认值：120）
• WARN_STUCK_RUNS（默认值：2）
• CRITICAL_STUCK_RUNS（默认值：4）
• WARN_STUCK_RATE（取值范围：0..1，默认值：0.2）
• CRITICAL_STUCK_RATE（取值范围：0..1，默认值：0.45）
• MIN_RUNS（默认值：1）
• WORKFLOW_MATCH / WORKFLOW_EXCLUDE（正则表达式，可选）
• BRANCH_MATCH / BRANCH_EXCLUDE（正则表达式，可选）
• EVENT_MATCH / EVENT_EXCLUDE（正则表达式，可选）
• REPO_MATCH / REPO_EXCLUDE（正则表达式，可选）
• STATUS_MATCH / STATUS_EXCLUDE（正则表达式，可选）
• FAIL_ON_CRITICAL（可选值：0 或 1，默认值：0）

采集运行 JSON 数据

gh run view  
  --json databaseId,workflowName,event,headBranch,status,conclusion,createdAt,runStartedAt,updatedAt,url,repository 
  > artifacts/github-actions/run-.json

执行方式

文本格式报告：

RUN_GLOB='artifacts/github-actions/*.json' 
bash skills/github-actions-stuck-run-audit/scripts/stuck-run-audit.sh

JSON 格式输出 + 触发门禁失败：

RUN_GLOB='artifacts/github-actions/*.json' 
OUTPUT_FORMAT=json 
FAIL_ON_CRITICAL=1 
bash skills/github-actions-stuck-run-audit/scripts/stuck-run-audit.sh

基于内置测试用例（fixtures）运行：

NOW_ISO='2026-03-08T00:00:00Z' 
RUN_GLOB='skills/github-actions-stuck-run-audit/fixtures/*.json' 
bash skills/github-actions-stuck-run-audit/scripts/stuck-run-audit.sh

输出约定

• 报告模式（默认）下退出码为 0
• 当 FAIL_ON_CRITICAL=1 且存在一个或多个 critical 级别分组时，退出码为 1
• 文本模式输出摘要信息 + 按卡住风险排序的分组列表
• JSON 模式输出摘要信息 + 排序后的分组列表 + 所有 critical 分组详情