AgentSkillsCN

gh-workflow

触发并监控GitHub Actions工作流、CI/CD流水线及自动化构建。适用于运行工作流、触发CI、通过GitHub Actions部署、下载制品或在github.com上查看工作流状态时。

SKILL.md
--- frontmatter
name: gh-workflow
description: Trigger and monitor GitHub Actions workflows, CI/CD pipelines, and automated builds. Use when running workflows, triggering CI, deploying via GitHub Actions, downloading artifacts, or checking workflow status on github.com

gh-workflow

Run GitHub workflows on github.com

Workflow

When the user asks to run a workflow:

  1. •Check the workflow file in .github/workflows/ to understand its trigger type and inputs
  2. •For workflow_dispatch workflows: trigger directly with gh workflow run
  3. •For push workflows: push to the remote first, then the workflow runs automatically
  4. •Use appropriate parameters based on the workflow's input definitions
  5. •For testing/iteration with matrix builds: prefer x64 over arm64 (faster provisioning)
  6. •Download workflow artifacts to verify outputs

Usage

bash
# List workflows
GH_HOST=github.com gh workflow list

# Run a workflow
GH_HOST=github.com gh workflow run <workflow-name>

# Run with inputs
GH_HOST=github.com gh workflow run <workflow-name> -f key=value

# View recent runs
GH_HOST=github.com gh run list --workflow=<workflow-name>

# Watch a run
GH_HOST=github.com gh run watch <run-id>

# Download artifacts from a run
GH_HOST=github.com gh run download <run-id>

Testing matrix builds

For workflows with matrix builds, test with the fastest variant first:

  • •Prefer x64 over arm64 (x64 runners provision faster)
  • •Prefer ubuntu over macos (faster startup)
  • •Use workflow inputs to target specific matrix cells if supported

Examples

bash
# Run workflow_dispatch workflow with inputs
GH_HOST=github.com gh workflow run luajit.yml -f release_tag=2025.11.23 -f create_release=true

# Run workflow on specific branch
GH_HOST=github.com gh workflow run luajit.yml --ref main

# Run without creating release (testing)
GH_HOST=github.com gh workflow run nvim.yml -f create_release=false

# Download artifacts from latest run
GH_HOST=github.com gh run list --workflow=luajit.yml --limit 1 --json databaseId --jq '.[0].databaseId' | xargs -I {} GH_HOST=github.com gh run download {}