GitHub Actions 队列延迟审计

使用此技能量化工作流在作业启动前的队列等待时间。

此技能的功能

• - 读取一个或多个 GitHub Actions 运行 JSON 导出文件（来自 gh run view --json ...）
• 计算每个作业的队列等待时间（startedAt - createdAt）和运行时长（completedAt - startedAt）
• 按仓库 + 工作流 + 作业名称对重复作业进行分组
• 按最差队列等待时间和平均队列等待时间对热点进行排名
• 使用可配置阈值标记警告/严重队列等待
• 输出为人类可读文本或机器可读 JSON

输入参数

• - RUNGLOB（默认值：artifacts/github-actions/*.json）
• TOPN（默认值：20）
• OUTPUTFORMAT（text 或 json，默认值：text）
• QUEUEWARNSECONDS（默认值：120）
• QUEUECRITICALSECONDS（默认值：300）
• FAILONCRITICAL（0 或 1，默认值：0）— 当任何作业实例达到/超过严重队列等待时以非零退出
• WORKFLOWMATCH（正则表达式，可选）
• WORKFLOWEXCLUDE（正则表达式，可选）
• JOBMATCH（正则表达式，可选）
• JOBEXCLUDE（正则表达式，可选）
• REPOMATCH（正则表达式，可选）
• REPO_EXCLUDE（正则表达式，可选）

收集运行 JSON

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

运行

文本报告：

bash
RUN_GLOB=artifacts/github-actions/*.json \
TOP_N=15 \
QUEUEWARNSECONDS=180 \
QUEUECRITICALSECONDS=420 \
bash skills/github-actions-queue-latency-audit/scripts/queue-latency-audit.sh

用于仪表板的 JSON 输出：

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

过滤到单个仓库/工作流系列：

bash
RUN_GLOB=artifacts/github-actions/*.json \
REPO_MATCH=^flowcreatebot/ \
WORKFLOW_MATCH=(CI|Build|Test) \
bash skills/github-actions-queue-latency-audit/scripts/queue-latency-audit.sh

使用捆绑的测试数据运行：

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

输出约定

• - 报告模式下退出 0（默认）
• 如果 FAILONCRITICAL=1 且至少有一个作业实例的队列等待时间 >= QUEUECRITICALSECONDS，则退出 1
• 在 text 模式下：打印摘要 + 顶部队列热点
• 在 json 模式下：打印摘要 + 分组热点记录 + 原始违规实例