Agent Skills
› gsd-build/gsd-2
› github-workflows
github-workflows
GitHub提供GitHub Actions CI/CD工作流的操作指南，通过ci_monitor.cjs脚本监控运行、调试失败及验证语法，确保使用实时数据避免过时信息。
Trigger Scenarios
编写或修改GitHub Actions工作流文件
排查CI流水线运行失败原因
监控和检查CI构建状态
Install
npx skills add gsd-build/gsd-2 --skill github-workflows -g -y
SKILL.md
Frontmatter
{
"name": "github-workflows",
"description": "Work with GitHub Actions CI\/CD workflows - read live syntax, monitor runs, and debug failures. Use when writing, running, or debugging GitHub Actions workflows."
}
GitHub Workflows
Mission: Work with GitHub Actions without using stale training data. All syntax, versions, and parameters come from live sources.
Structural Principle
All CI operations go through ci_monitor.cjs. Never reach for gh CLI directly — the script wraps it with observable output.
Primary Tool: ci_monitor.cjs
Path: scripts/ci_monitor.cjs
node scripts/ci_monitor.cjs <command>
Before using any command:
- Run
--helpto discover available arguments
Routing Table:
| When You Need | Command |
|---|---|
| List recent runs | runs [--branch <name>] |
| Monitor running workflow | watch <run-id> |
| Fail fast in scripts | fail-fast <run-id> |
| See why run failed | log-failed <run-id> |
| Test pass/fail counts | test-summary <run-id> |
| Check action versions | check-actions [file] |
| Search logs | grep <run-id> --pattern <regex> |
| Wait for deployment | wait-for <run-id> <job> --keyword <text> |
Documentation Routing
Base URL: https://docs.github.com/en/actions/reference/workflows-and-actions/
Before writing any workflow syntax:
- Fetch the relevant
.mdfile from the URL above - Read only the section you need
| Task | File | Section |
|---|---|---|
| Create workflow | workflow-syntax.md | name, on, jobs |
| Set triggers | workflow-syntax.md | on |
| Set permissions | workflow-syntax.md | permissions |
| Concurrency | workflow-syntax.md | concurrency |
| Reusable workflow | workflow-syntax.md | on.workflow_call |
| Annotations | workflow-commands.md | "Setting an error/warning/notice message" |
| Output variables | workflow-commands.md | "Environment files" |
| Conditionals | expressions.md | "Operators", "Functions" |
| Contexts | contexts.md | " |
| Events | events-that-trigger-workflows.md | Event tables |
Version Verification
| What | Where |
|---|---|
| Action versions | node ci_monitor.cjs check-actions <file> |
| Node.js LTS | curl -s https://nodejs.org/dist/index.json | jq '.[0].version' |
Validation Constraint
"No errors" is not validation. Prove observable change:
BEFORE: [specific state]
AFTER: [different state]
EVIDENCE: [output from ci_monitor.cjs]
References
references/gh/SKILL.md— gh CLI reference
Version History
- 33c00aa Current 2026-07-25 10:22
