← 返回 Skills 市场

GitHub Actions Queue Latency Audit

Name: GitHub Actions Queue Latency Audit
Author: daniellummis

作者 Daniel Lummis · GitHub ↗ · v1.0.0

cross-platform ✓ 安全检测通过

270

总下载

当前安装

版本数

在 OpenClaw 中安装

/install github-actions-queue-latency-audit

功能描述

Audit GitHub Actions queue wait hotspots from run/job JSON so CI bottlenecks are visible before they stall merges.

使用说明 (SKILL.md)

GitHub Actions Queue Latency Audit

Use this skill to quantify where workflows are waiting in queue before jobs start.

What this skill does

Reads one or more GitHub Actions run JSON exports (from gh run view --json ...)
Computes per-job queue wait (startedAt - createdAt) and runtime duration (completedAt - startedAt)
Groups repeated jobs by repository + workflow + job name
Ranks hotspots by worst queue wait and average queue wait
Flags warning/critical queue waits with configurable thresholds
Emits output as human-readable text or machine-readable JSON

Inputs

Optional:

RUN_GLOB (default: artifacts/github-actions/*.json)
TOP_N (default: 20)
OUTPUT_FORMAT (text or json, default: text)
QUEUE_WARN_SECONDS (default: 120)
QUEUE_CRITICAL_SECONDS (default: 300)
FAIL_ON_CRITICAL (0 or 1, default: 0) — exit non-zero when any job instance hits/exceeds critical queue wait
WORKFLOW_MATCH (regex, optional)
WORKFLOW_EXCLUDE (regex, optional)
JOB_MATCH (regex, optional)
JOB_EXCLUDE (regex, optional)
REPO_MATCH (regex, optional)
REPO_EXCLUDE (regex, optional)

Collect run JSON

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

Run

Text report:

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

JSON output for dashboards:

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

Filter to one repo/workflow family:

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

Run with bundled fixtures:

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

Output contract

Exit 0 in reporting mode (default)
Exit 1 if FAIL_ON_CRITICAL=1 and at least one job instance has queue wait >= QUEUE_CRITICAL_SECONDS
In text mode: prints summary + top queue hotspots
In json mode: prints summary + grouped hotspot records + raw offending instances

安全使用建议

This skill parses local GitHub Actions run JSON files and produces human-readable or JSON reports — it does not require or exfiltrate credentials. Note: the README examples suggest using the 'gh' CLI to create the JSON exports; install/authenticate gh if you wish to follow those examples. Before running, ensure the artifacts/github-actions/*.json files (or whatever RUN_GLOB you set) are trusted — the script will read and print fields like repository names and job URLs, and you may choose to run it in a sandbox/container if you prefer. If you enable FAIL_ON_CRITICAL=1, the script will exit non-zero on critical findings which may fail CI jobs that invoke it.

功能分析

Type: OpenClaw Skill Name: github-actions-queue-latency-audit Version: 1.0.0 The skill provides a utility to audit GitHub Actions queue latency by processing JSON run data. It calculates wait times and identifies performance hotspots using a Python script embedded within a Bash wrapper. The logic is consistent with the stated purpose, and no indicators of data exfiltration, unauthorized execution, or malicious intent were found in scripts/queue-latency-audit.sh or the documentation.

能力评估

✓ Purpose & Capability

Name/description match the included script and fixtures. Required binaries (bash, python3) are appropriate for a shell wrapper that runs an embedded Python parser. No unrelated credentials, config paths, or strange binaries are requested.

ℹ Instruction Scope

SKILL.md shows examples using the 'gh' CLI to export run JSON, but the skill does not declare 'gh' as a required binary — this is a minor mismatch (the use of 'gh' is optional/example-only). The runtime instructions and script operate only on local JSON files (glob), apply user-provided regex filters, and emit text/JSON; they do not read unrelated system files or transmit data to external endpoints.

✓ Install Mechanism

Instruction-only skill with no install spec and a single script file; nothing is downloaded or written during installation.

✓ Credentials

No required environment variables or credentials. The script reads only the provided RUN_GLOB and other optional input environment variables; it does not access secret-named env vars or external service keys.

✓ Persistence & Privilege

The skill does not request permanent presence (always:false) and does not modify other skills or system-wide agent settings. It runs as a local script on invocation.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install github-actions-queue-latency-audit
安装完成后，直接呼叫该 Skill 的名称或使用 /github-actions-queue-latency-audit 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

Initial release. - Audits GitHub Actions queue latency from exported run/job JSON files. - Computes and ranks job queue wait times to identify CI bottlenecks. - Supports filtering by repository, workflow, and job with regex options. - Flags and optionally fails on jobs exceeding configurable queue wait thresholds. - Outputs results as human-readable text or machine-readable JSON. - Includes example usage for various reporting and filtering needs.

元数据

Slug github-actions-queue-latency-audit

版本 1.0.0

许可证 —

累计安装 0

当前安装数 0

历史版本数 1

常见问题