技能名称：github-actions-commit-health-audit
详细描述：

GitHub Actions 提交健康审计

使用此技能查找持续集成（CI）反复失败的提交，以便团队优先处理回滚、还原或针对性修复。

此技能的功能

• - 读取 GitHub Actions 运行记录的 JSON 导出文件
• 按仓库 + 提交 SHA 对运行记录进行分组
• 根据失败率、失败运行数量和工作流分布对提交风险进行评分
• 标记警告/严重级别的提交热点
• 输出文本或 JSON 格式结果，用于 CI 检查和分类仪表板

输入参数

• - RUNGLOB（默认值：artifacts/github-actions/*.json）
• TOPN（默认值：20）
• OUTPUTFORMAT（text 或 json，默认值：text）
• MINRUNS（默认值：2）
• BRANCHMATCH（正则表达式，可选）
• BRANCHEXCLUDE（正则表达式，可选）
• WORKFLOWMATCH（正则表达式，可选）
• WORKFLOWEXCLUDE（正则表达式，可选）
• REPOMATCH（正则表达式，可选）
• REPOEXCLUDE（正则表达式，可选）
• SHAMATCH（正则表达式，可选）
• SHAEXCLUDE（正则表达式，可选）
• FAILWARNPERCENT（默认值：25）
• FAILCRITICALPERCENT（默认值：50）
• WARNSCORE（默认值：35）
• CRITICALSCORE（默认值：60）
• FAILONCRITICAL（0 或 1，默认值：0）

收集运行 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 \
bash skills/github-actions-commit-health-audit/scripts/commit-health-audit.sh

带失败门控的 JSON 输出：

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

使用内置测试数据运行：

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

输出约定

• - 报告模式下退出码为 0（默认）
• 当 FAILONCRITICAL=1 且存在一个或多个严重提交时，退出码为 1
• 文本模式输出摘要 + 按风险排序的提交分组
• JSON 模式输出摘要 + 评分分组 + 严重提交详情