GitHub Actions 运行时回归审计

使用此技能检测历史基线运行与当前运行之间的运行时回归问题。

该技能的功能

• 读取基线运行和当前运行的 GitHub Actions 运行 JSON 导出文件（gh run view --json ...）
• 按仓库 + 工作流 + 任务计算平均运行时和 p95 运行时
• 将当前指标与基线进行对比，并对回归幅度最大的条目进行排序
• 依据绝对秒数增量和百分比增量，标记警告级（warn）或严重级（critical）回归
• 输出面向人工阅读的文本摘要，或面向自动化系统的 JSON 格式结果

输入参数

必需参数：

• BASELINE_GLOB（基线运行 JSON 文件路径通配符）
• CURRENT_GLOB（当前运行 JSON 文件路径通配符）

可选参数：

• TOP_N（默认值：20）
• OUTPUT_FORMAT（text 或 json，默认值：text）
• WARN_DELTA_SECONDS（默认值：30）
• CRITICAL_DELTA_SECONDS（默认值：90）
• WARN_DELTA_PERCENT（默认值：15）
• CRITICAL_DELTA_PERCENT（默认值：35）
• FAIL_ON_CRITICAL（0 或 1，默认值：0）
• WORKFLOW_MATCH（正则表达式，可选）
• WORKFLOW_EXCLUDE（正则表达式，可选）
• JOB_MATCH（正则表达式，可选）
• JOB_EXCLUDE（正则表达式，可选）
• REPO_MATCH（正则表达式，可选）
• REPO_EXCLUDE（正则表达式，可选）

采集运行 JSON 数据

gh run view  --json databaseId,workflowName,headBranch,headSha,url,repository,jobs 
  > artifacts/github-actions/run-.json

采集一个稳定的基线时间窗口（例如最近两周）内的运行数据，再采集最新提交对应的当前运行数据。

执行命令

文本格式报告：

BASELINE_GLOB='artifacts/github-actions/baseline/*.json' 
CURRENT_GLOB='artifacts/github-actions/current/*.json' 
TOP_N=15 
WARN_DELTA_SECONDS=45 
CRITICAL_DELTA_SECONDS=120 
bash skills/github-actions-runtime-regression-audit/scripts/runtime-regression-audit.sh

JSON 输出并启用 CI 门禁（CI gate）：

BASELINE_GLOB='artifacts/github-actions/baseline/*.json' 
CURRENT_GLOB='artifacts/github-actions/current/*.json' 
OUTPUT_FORMAT=json 
FAIL_ON_CRITICAL=1 
bash skills/github-actions-runtime-regression-audit/scripts/runtime-regression-audit.sh

使用内置测试样本运行：

BASELINE_GLOB='skills/github-actions-runtime-regression-audit/fixtures/baseline-*.json' 
CURRENT_GLOB='skills/github-actions-runtime-regression-audit/fixtures/current-*.json' 
bash skills/github-actions-runtime-regression-audit/scripts/runtime-regression-audit.sh

输出约定

• 在报告模式下（默认）退出码为 0
• 当 FAIL_ON_CRITICAL=1 且至少有一个任务超出严重级回归阈值时，退出码为 1
• text 模式输出摘要 + 回归最显著的前 N 项 + 无基线记录的新任务
• json 模式输出摘要、排序后的回归列表以及新观测到的任务