github-actions-runs
使用asim-utilities Python库/CLI自动化和检查GitHub Actions运行。在触发工作流、列出最近的运行或失败、在作业失败时等待/取消运行、下载运行日志和工件时使用。涵盖CLI使用、输出约定和~/workplace/asim-utilities的仓库布局。
📖 中文导读:使用asim-utilities Python库/CLI自动化和检查GitHub Actions运行。在触发工作流、列出最近的运行或失败、在作业失败时等待/取消运行、下载运行日志和工件时使用。涵盖CLI使用、输出约定和~/workplace/asim-utilities的仓库布局。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: github-actions-runs description: Automate and inspect GitHub Actions runs with the asim-utilities Python library/CLI. Use when triggering workflows, listing recent runs or failures, waiting/canceling runs on job failure, or downloading run logs and artifacts. Covers CLI usage, output conventions, and repo layout for ~/workplace/asim-utilities.
GitHub Actions Runs
Overview
Use the asim-utilities repo to manage GitHub Actions runs via a typed Python library and the gh-actions-runs CLI. This skill covers common workflows (trigger/watch, list failures, download logs/artifacts), configuration, and where to modify the code.
Before using the CLI in a session, run gh-actions-runs --help once to refresh flags and subcommands.
Quick start (CLI)
- Set auth:
GITHUB_TOKENorGH_TOKENin the environment (or rely ongh auth token). - Run against current repo (auto-detects
origin), or pass--repo owner/name. - Default output root:
~/.cache/gh-actions-runs(override with--output).
Common commands:
- Trigger + wait for run ID:
gh-actions-runs trigger --workflow CI --ref main --wait
- Watch a run, cancel on first failure, download logs/artifacts:
gh-actions-runs watch --workflow CI --ref main
- List recent runs:
gh-actions-runs list --limit 20
- List recent failures:
gh-actions-runs failures --limit 10
- Download logs + artifacts for a run:
gh-actions-runs download 123456
- Download latest completed run for a PR (number or URL):
gh-actions-runs pr-download --repo owner/name --pr 1234gh-actions-runs pr-download --pr https://github.com/owner/repo/pull/1234
Workflow: Trigger + watch
- Dispatch workflow (
triggerorwatchwithout--run-id). - Poll for the run ID based on creation time + branch.
- Poll run + jobs; if any job fails and
--no-cancel-on-failureis not set, cancel the run. - Wait for completion, then download logs and artifacts into
run-<id>/.
Workflow: Inspect recent runs
- Use
listfor recent runs; add--workflowor--branchfilters. - Use
failuresto filter for failed conclusions. - Use
runandjobsto inspect a single run in detail.
Output and formats
--format human(default): tables and readable summaries.--format json: machine-readable output for scripting.
Code map
- Library:
src/utilities/github_actions/client.py: GitHub REST API clientruns.py: high-level run operationsmodels.py: typed dataclassesutils.py: helpers (token, repo parsing, XDG cache paths)
- CLI:
src/utilities/github_actions/cli.py
Installation notes
gh-actions-runsentry point is installed via editable install and linked into~/bin.- If a rebuild is needed, rerun the repo install steps (see repo setup).