Invocation
Syntax: /skill:snap-resolve [auto]
Args
| Key | Values | Default | Notes |
|---|---|---|---|
help |
bool | false | show usage |
auto |
bool | false | skip checkpoint approval for clear [FIX], [EXPLAIN], and CI items; never auto-run Unsure |
Resolve GitHub PR feedback and failing checks. One checkpoint before execution unless auto is provided.
Process
Find the PR from current branch/session context, or ask for one.
Gather full PR context: title/body, comments, reviews, review threads, replies, checks, failed logs, and linked issues/specs/PRDs recursively when they affect scope, acceptance, blockers, or intent. Use
references/ci-checks.mdfor CI failure parsing.Classify each current item, accounting for prior replies, resolved threads, commits, and CI reruns:
[FIX]: requires code/docs/test change[EXPLAIN]: reply only; no code-change promiseCI: failing check or log-derived failureAlready addressed: prior reply/fix/CI update shows the item was handled; skip unless it is still failing or explicitly reopenedUnsure: missing, conflicting, or inaccessible context
Show one checkpoint with
[FIX],[EXPLAIN],CI,Already addressed, andUnsure. Wait for approval unlessautois provided. Never auto-runUnsure.Execute approved fixes. Use
references/tdd-cycle.mdfor substantive fixes and direct edits for trivial fixes. Add tests only for meaningful behavior affected by the fix; do not add unnecessary coverage-only tests. Verify locally with targeted tests/checks for touched code. Do not wait for GitHub CI to turn green. Commit each fix atomically.Reply using
references/thread-resolution.md: use true review-thread inline replies when a thread endpoint exists; for top-level PR comments, post a quote-reply comment that quotes the relevant original feedback. Resolve addressed review threads only after replying. Push once, then report commits, local verification, replies, pending CI if any, and remaining unresolved items. Do not watch or wait for GitHub CI after pushing.