GitHub Actions 触发事件健康审计

使用此技能可找出哪些 GitHub Actions 触发事件导致了最高的失败率。

技能功能

• - 读取一个或多个 GitHub Actions 运行 JSON 导出文件
• 按仓库 + 事件 + 工作流对运行进行分组
• 计算失败/取消/超时率及平均运行时间
• 基于可配置的失败率阈值标记警告/严重热点
• 支持对仓库、工作流和事件使用正则包含/排除过滤器
• 输出文本或 JSON 格式，用于仪表盘和自动化门控

输入参数

• - RUNGLOB（默认值：artifacts/github-actions/*.json）
• TOPN（默认值：20）
• OUTPUTFORMAT（text 或 json，默认值：text）
• MINRUNS（默认值：2）— 跳过样本量过小的分组
• FAILWARNPERCENT（默认值：20）
• FAILCRITICALPERCENT（默认值：40）
• FAILONCRITICAL（0 或 1，默认值：0）
• WORKFLOWMATCH（正则表达式，可选）
• WORKFLOWEXCLUDE（正则表达式，可选）
• EVENTMATCH（正则表达式，可选）
• EVENTEXCLUDE（正则表达式，可选）
• REPOMATCH（正则表达式，可选）
• REPOEXCLUDE（正则表达式，可选）

收集运行 JSON

bash
gh run view --json databaseId,workflowName,event,conclusion,headBranch,headSha,createdAt,updatedAt,startedAt,url,repository \
> artifacts/github-actions/run-.json

运行

文本报告：

bash
RUN_GLOB=artifacts/github-actions/*.json \
MIN_RUNS=3 \
FAILWARNPERCENT=25 \
FAILCRITICALPERCENT=50 \
bash skills/github-actions-trigger-health-audit/scripts/trigger-health-audit.sh

带失败门控的 JSON 输出：

bash
RUN_GLOB=artifacts/github-actions/*.json \
OUTPUT_FORMAT=json \
FAILONCRITICAL=1 \
bash skills/github-actions-trigger-health-audit/scripts/trigger-health-audit.sh

使用捆绑测试数据运行：

bash
RUN_GLOB=skills/github-actions-trigger-health-audit/fixtures/*.json \
bash skills/github-actions-trigger-health-audit/scripts/trigger-health-audit.sh

输出约定

• - 报告模式下退出码为 0（默认）
• 当 FAILONCRITICAL=1 且任意分组达到严重阈值时，退出码为 1
• 文本模式打印摘要 + 排名后的触发事件健康热点
• JSON 模式打印摘要 + 分组指标 + 严重分组详情