gh-aw-reliability
Validate GitHub Agentic Workflow contracts through compiled artifacts and realistic mutations
- License 许可
- MIT
- 所属仓库
- github/squad
- 最近更新
- 2026-11-15
- Stars
- ★ 3.4k
- Forks
- 520
01 前言 Front Matter
- name
- gh-aw-reliability
- domain
- github-agentic-workflows, testing
- source
- current workflow gates and regression tests
- confidence
- high
- description
- Validate GitHub Agentic Workflow contracts through compiled artifacts and realistic mutations
03 SKILL.md 正文
Context
Use this skill when creating or changing Squad GitHub Agentic Workflow sources, safe outputs, authorization, or prompt inputs. Prompt prose can look correct while the compiled workflow does nothing or authorizes the wrong action.
Patterns
- Treat workflow source, compiled lock output, and declared safe outputs as a single contract.
- Strict-compile the workflow and inspect the emitted artifact; a zero exit code alone is not enough when a specific handler, input, or protected-file rule is required.
- Enumerate all call sites when changing parsing, normalization, ownership binding, or command routing.
- Bind authorization, labels, and mutable actions to committed provenance rather than an unverified working-tree claim.
- Fail closed when the compiler, required tool, or evidence needed to prove the contract is unavailable.
- Test a realistic mutation of the live source and prove the relevant gate fails.
Examples
test/gh-aw-deps-worker-workflow.test.ts mutates a real worker source, runs the compiler, then
asserts on the compiled protected-files contract. test/gh-aw-activate-roster-binding.test.ts
checks roster-derived authorization behavior.
Anti-Patterns
- Validating only prompt text or a hand-built configuration object
- Letting unavailable workflow tooling silently skip a protection gate
- Testing one parser helper while leaving an alternate command-dispatch caller untested
- Minting labels or authorization from role prose instead of committed roster evidence
04 同仓库更多 Skills
windows-compatibility
Cross-platform path handling and command patterns
versioning-policy
SemVer rules for Squad's stable, preview, insider, and local package versions
tiered-memory
Three-tier agent memory model (hot/cold/wiki) for context reduction per spawn
test-discipline
Design assertions that prove the actual contract and fail on realistic regressions
squad
Squad's command catalog and interactive menu. Invoke via /squad (slash command) or natural language ("squad commands", "what can squad do", "show me squad options"). Presents categorized operations (Install & Upgrade, Team Management, Issues & PRs, Plugins & Skills, Model & Cost, Sessions & State) as an interactive picker. Routes to the right squad CLI command or the Squad coordinator agent.
squad-version-check
Internals of how @bradygaster/squad-cli stamps its version, how `squad upgrade` works (what it preserves vs overwrites), and how to probe the npm registry for the latest version from a coordinator prompt.