swarm-pr-worker

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

1. Scan — List open issues/PRs, score by severity and reproducibility
2. Reproduce — Create minimal reproduction steps or failing test
3. Branch — Create focused fix branch (fix/<issue-id>-<slug>)
4. Fix — Narrow change only, with test
5. PR prep — Write clear PR body: problem / solution / test proof
6. Gate — Checkpoint NEEDS_REVIEW, do not merge

Review Lane

1. Inspect diff — Read every changed line
2. Byte-check — Verify naming, generated output, fragile identifiers exactly
3. Run tests — Execute test suite, capture output
4. Build — Confirm build passes
5. Smoke — Basic functional check
6. Verdict — APPROVED / CHANGES_REQUESTED / BLOCKED (never silent)

GitHub API (shiftrepo/aws env)

# List open issues
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

# Create issue
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