GitHub Actions SHA 重运行债务审计

使用此技能检测触发多次 GitHub Actions 重运行且在多个工作流中产生失败结果的提交（commits）。

该技能的功能

• 读取 GitHub Actions 运行（run）的 JSON 导出文件
• 基于 run id 关联各次尝试历史，并汇总每次运行的最新结果（conclusion）
• 按仓库（repository）+ 提交 SHA 聚合重运行债务（rerun debt）
• 基于重运行率（rerun rate）、失败运行次数（failed-run count）、受影响工作流数量（workflow spread）以及浪费的重运行分钟数（wasted rerun minutes）综合评分风险
• 为 CI 门禁（CI gates）输出严重性等级（ok、warn、critical）

输入参数

可选：

• RUN_GLOB（默认值：artifacts/github-actions/*.json）
• TOP_N（默认值：20）
• OUTPUT_FORMAT（可选值：text 或 json，默认值：text）
• MIN_RUNS（每个 SHA 的最小运行次数，默认值：3）
• WARN_RERUN_RATE（取值范围：0..1，默认值：0.25）
• CRITICAL_RERUN_RATE（取值范围：0..1，默认值：0.45）
• WARN_FAILED_RUNS（默认值：2）
• CRITICAL_FAILED_RUNS（默认值：4）
• WARN_WASTED_MINUTES（默认值：25）
• CRITICAL_WASTED_MINUTES（默认值：75）
• WARN_WORKFLOWS（受影响的独立工作流数量，默认值：2）
• CRITICAL_WORKFLOWS（默认值：4）
• WORKFLOW_MATCH / WORKFLOW_EXCLUDE（正则表达式，可选）
• BRANCH_MATCH / BRANCH_EXCLUDE（正则表达式，可选）
• EVENT_MATCH / EVENT_EXCLUDE（正则表达式，可选）
• REPO_MATCH / REPO_EXCLUDE（正则表达式，可选）
• HEAD_SHA_MATCH / HEAD_SHA_EXCLUDE（正则表达式，可选）
• FAILURE_CONCLUSIONS（以逗号分隔的失败结论列表，默认值：failure,cancelled,timed_out,startup_failure,action_required）
• FAIL_ON_CRITICAL（0 或 1，默认值：0）

采集运行 JSON 数据

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

执行方式

文本格式报告：

RUN_GLOB='artifacts/github-actions/*.json' 
bash skills/github-actions-sha-rerun-debt-audit/scripts/sha-rerun-debt-audit.sh

JSON 格式输出 + 失败门禁（fail gate）：

RUN_GLOB='artifacts/github-actions/*.json' 
OUTPUT_FORMAT=json 
FAIL_ON_CRITICAL=1 
bash skills/github-actions-sha-rerun-debt-audit/scripts/sha-rerun-debt-audit.sh

针对内置测试用例（fixtures）运行：

RUN_GLOB='skills/github-actions-sha-rerun-debt-audit/fixtures/*.json' 
bash skills/github-actions-sha-rerun-debt-audit/scripts/sha-rerun-debt-audit.sh

输出契约（Output Contract）

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