github-actions-rerun-effectiveness-audit（GitHub actions rerun effectiveness 审核）

GitHub Actions Rerun Effectiveness Audit

Use this skill to measure how often workflows require reruns and whether reruns are actually recovering failures.

What this skill does

• Reads GitHub Actions run JSON exports
• Tracks rerun episodes using workflow run id + attempt history
• Measures rerun rate, rerun success rate, and extra rerun attempts
• Estimates wasted rerun minutes from attempt durations
• Emits severity (ok, warn, critical) for CI policy gates

Inputs

Optional:

• RUN_GLOB (default: artifacts/github-actions/*.json)
• TOP_N (default: 20)
• OUTPUT_FORMAT (text or json, default: text)
• GROUP_BY (workflow or workflow-branch, default: workflow)
• FAILURE_CONCLUSIONS (comma-separated, default: failure,cancelled,timed_out,startup_failure,action_required)
• SUCCESS_CONCLUSIONS (comma-separated, default: success)
• MIN_RUNS (minimum workflow runs required, default: 4)
• WARN_RERUN_RATE (0..1, default: 0.2)
• CRITICAL_RERUN_RATE (0..1, default: 0.35)
• WARN_RERUN_SUCCESS_RATE (0..1, default: 0.5)
• CRITICAL_RERUN_SUCCESS_RATE (0..1, default: 0.25)
• WARN_WASTED_MINUTES (default: 20)
• CRITICAL_WASTED_MINUTES (default: 60)
• WORKFLOW_MATCH / WORKFLOW_EXCLUDE (regex, optional)
• BRANCH_MATCH / BRANCH_EXCLUDE (regex, optional)
• EVENT_MATCH / EVENT_EXCLUDE (regex, optional)
• REPO_MATCH / REPO_EXCLUDE (regex, optional)
• ACTOR_MATCH / ACTOR_EXCLUDE (regex, optional)
• FAIL_ON_CRITICAL (0 or 1, default: 0)

Collect run JSON

gh run view <run-id> --attempt <attempt> \
  --json databaseId,runAttempt,workflowName,event,headBranch,headSha,conclusion,createdAt,updatedAt,runStartedAt,url,repository,actor,triggeringActor \
  > artifacts/github-actions/run-<run-id>-attempt-<attempt>.json

Run

Text report:

RUN_GLOB='artifacts/github-actions/*.json' \
bash skills/github-actions-rerun-effectiveness-audit/scripts/rerun-effectiveness-audit.sh

JSON output + fail gate:

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

Run against bundled fixtures:

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

Output contract

• Exit 0 in report mode (default)
• Exit 1 when FAIL_ON_CRITICAL=1 and one or more groups are critical
• Text mode prints summary + ranked workflow groups
• JSON mode prints summary + ranked groups + critical groups