← 返回 Skills 市场
daniellummis

GitHub Actions Failure Hour Audit

作者 Daniel Lummis · GitHub ↗ · v1.0.0
cross-platform ✓ 安全检测通过
248
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install github-actions-failure-hour-audit
功能描述
Audit GitHub Actions failure timing by day/hour to surface recurring outage windows and staffing hotspots.
使用说明 (SKILL.md)

GitHub Actions Failure Hour Audit

Use this skill to identify when failures cluster so teams can target flaky time windows and on-call coverage.

What this skill does

  • Reads one or more GitHub Actions workflow run JSON exports
  • Keeps only failure-like conclusions (failure, cancelled, timed_out, action_required, startup_failure)
  • Buckets failures into day/hour windows (with optional timezone offset)
  • Ranks windows by severity using failure-run thresholds
  • Emits text or JSON output for dashboards or CI gates

Inputs

Optional:

  • RUN_GLOB (default: artifacts/github-actions/*.json)
  • TOP_N (default: 24)
  • OUTPUT_FORMAT (text or json, default: text)
  • WARN_FAILURE_RUNS (default: 3)
  • CRITICAL_FAILURE_RUNS (default: 6)
  • FAIL_ON_CRITICAL (0 or 1, default: 0)
  • TZ_OFFSET_HOURS (default: 0) — integer timezone shift from UTC, between -23 and 23
  • WORKFLOW_MATCH, WORKFLOW_EXCLUDE (regex, optional)
  • BRANCH_MATCH, BRANCH_EXCLUDE (regex, optional)
  • REPO_MATCH, REPO_EXCLUDE (regex, optional)

Collect run JSON

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

Run

Text report:

RUN_GLOB='artifacts/github-actions/*.json' \
WARN_FAILURE_RUNS=3 \
CRITICAL_FAILURE_RUNS=6 \
TZ_OFFSET_HOURS=7 \
bash skills/github-actions-failure-hour-audit/scripts/failure-hour-audit.sh

JSON output + fail gate:

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

Output contract

  • Exit 0 in reporting mode
  • Exit 1 when FAIL_ON_CRITICAL=1 and one or more critical windows are found
  • Text output includes summary and top windows by severity
  • JSON output includes summary, ranked windows, and critical_windows
安全使用建议
This script analyzes local GitHub Actions JSON exports — run it locally against a directory of exported run JSONs (default: artifacts/github-actions/*.json). The skill itself needs only bash and python3. SKILL.md shows how to collect runs with the GitHub CLI ('gh run view ...'), but 'gh' is not declared as a required binary and is not invoked by the script; if you use that collection step, 'gh' will use your GitHub auth (tokens) outside this skill. The script prints sample run URLs and repo names (it does not transmit them), so avoid running it in environments where printed output is automatically uploaded to an untrusted endpoint. If you plan to run this in CI, ensure RUN_GLOB matches only intended files and review outputs before storing or sharing. If you want the documentation to match runtime behavior, either install/declare 'gh' separately or remove the gh usage example from SKILL.md.
功能分析
Type: OpenClaw Skill Name: github-actions-failure-hour-audit Version: 1.0.0 The skill is a utility for auditing GitHub Actions failure patterns by analyzing local JSON artifacts. It uses a bash wrapper for an embedded Python script (scripts/failure-hour-audit.sh) to process data and generate reports. No evidence of malicious intent, data exfiltration, or unauthorized execution was found; the script correctly validates inputs and handles file processing through standard Python libraries.
能力评估
Purpose & Capability
The name/description match the implementation: the included bash+python script scans local GitHub Actions run JSON files, filters failures, buckets by day/hour, ranks windows, and emits text/JSON. One minor mismatch: SKILL.md shows an example 'gh run view ... > artifacts/..' to collect run JSONs, but the skill metadata/bins do not list the GitHub CLI ('gh'). That is a documentation/inventory inconsistency (the script itself does not invoke 'gh').
Instruction Scope
Runtime instructions and the script operate only on local JSON files matched by RUN_GLOB and environment-configurable filters. The script reads file contents, computes metrics, and prints text/JSON; it does not perform network calls, modify system configuration, or access unrelated files. The only scope extension is the SKILL.md example which instructs the user to use 'gh' to fetch run JSONs (a user action), but the skill does not itself reach out to external endpoints.
Install Mechanism
No install spec — instruction-only with a shipped script — so nothing is downloaded or written by an installer. This is low-risk. (As noted, if you plan to use SKILL.md's gh example you must have the gh CLI installed separately; the installer does not provide it.)
Credentials
The skill requires only bash and python3 (declared). It lists no required environment variables or credentials. Be aware: the SKILL.md recommends using the GitHub CLI to export run JSONs; that step uses the user's gh authentication (outside this skill) but is not required by the script. The script does include sample run URLs and repo names in its output (these are derived from input JSONs and are not transmitted elsewhere by the script).
Persistence & Privilege
The skill does not request permanent presence (always:false), does not modify other skills or system-wide settings, and only reads inputs and writes to stdout/exit codes. It does not persist credentials or alter agent configuration.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install github-actions-failure-hour-audit
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /github-actions-failure-hour-audit 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release of GitHub Actions Failure Hour Audit. - Audits GitHub Actions workflow run failures by hour/day, supporting timezone offset - Supports filtering by workflow, branch, and repository via regex - Buckets and ranks failure windows by severity thresholds - Outputs in text or JSON for dashboards or CI checks - Configurable fail gate on critical windows - Accepts customizable input variables for flexible usage
元数据
Slug github-actions-failure-hour-audit
版本 1.0.0
许可证
累计安装 0
当前安装数 0
历史版本数 1
常见问题

GitHub Actions Failure Hour Audit 是什么?

Audit GitHub Actions failure timing by day/hour to surface recurring outage windows and staffing hotspots. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 248 次。

如何安装 GitHub Actions Failure Hour Audit?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install github-actions-failure-hour-audit」即可一键安装,无需额外配置。

GitHub Actions Failure Hour Audit 是免费的吗?

是的,GitHub Actions Failure Hour Audit 完全免费(开源免费),可自由下载、安装和使用。

GitHub Actions Failure Hour Audit 支持哪些平台?

GitHub Actions Failure Hour Audit 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 GitHub Actions Failure Hour Audit?

由 Daniel Lummis(@daniellummis)开发并维护,当前版本 v1.0.0。

💬 留言讨论