| name | swarm-pr-worker |
| description | GitHub issue/PR workflow for Hermes Swarm — triage, reproduction, patching, PR prep, and review feedback handling. |
swarm-pr-worker
GitHub PR and issue lane for Hermes Workspace swarm workers. Used by Reviewer (swarm6), Triage (swarm1, swarm11, swarm12) roles.
Trigger
Load this skill when the task involves GitHub issues, PRs, code review, triage, or reproduction work.
Issue/PR Workflow
Triage Lane
- Scan — List open issues/PRs, score by severity and reproducibility
- Reproduce — Create minimal reproduction steps or failing test
- Branch — Create focused fix branch (
fix/<issue-id>-<slug>)
- Fix — Narrow change only, with test
- PR prep — Write clear PR body: problem / solution / test proof
- Gate — Checkpoint NEEDS_REVIEW, do not merge
Review Lane
- Inspect diff — Read every changed line
- Byte-check — Verify naming, generated output, fragile identifiers exactly
- Run tests — Execute test suite, capture output
- Build — Confirm build passes
- Smoke — Basic functional check
- Verdict — APPROVED / CHANGES_REQUESTED / BLOCKED (never silent)
GitHub API (shiftrepo/aws env)
source /root/.hermes/profiles/bedrock-slack/.env
curl -s -H "Authorization: token $GITHUB_HERMESSHIFT_PAT" \
-H "X-GitHub-Api-Version: 2022-11-28" \
https://api.github.com/repos/shiftrepo/aws/issues?state=open
curl -s -X POST \
-H "Authorization: token $GITHUB_HERMESSHIFT_PAT" \
-H "X-GitHub-Api-Version: 2022-11-28" \
-H "Content-Type: application/json" \
https://api.github.com/repos/shiftrepo/aws/issues \
-d '{"title": "...", "body": "..."}'
Review Verdict Format
VERDICT: <APPROVED|CHANGES_REQUESTED|BLOCKED>
CHECKED:
- diff: <N files, N lines>
- tests: <pass/fail — exact output>
- build: <pass/fail>
- smoke: <pass/fail>
NOTES: <specific findings>
BLOCKERS: <if BLOCKED — exact blocker>
Pitfalls
- Triage must never silently merge or close — always checkpoint NEEDS_REVIEW first
- CHANGES_REQUESTED requires specific, actionable notes (not "looks a bit off")
- shiftrepo env: gh CLI not installed → use Python urllib or curl
- Issue/PR repos:
aws (infra), ai_workshop (AI common) — don't mix them
- X-GitHub-Api-Version: 2022-11-28 header is required