.agents/skills/openclaw-small-bugfix-sweep
OpenClaw Small Bugfix Sweep
Batch workflow for pasted OpenClaw issue/PR refs. Execute, do not summarize. Triage reviews, proves, and patches local fixes first; publishing waits for Peter's manual review.
Peter Review Gate
Peter always wants to review code before commits. Default flow:
- Review each issue deeply enough to prove current behavior and root cause.
- Fix only easy, high-confidence bugs with narrow ownership and focused proof.
- Stop with the dirty diff summary, touched files, and test/gate output for Peter's manual review.
- After Peter approves shipping, make one commit per accepted fix, with a changelog entry for each user-facing fix.
- Pull/rebase, push, then comment and close only the fixed or explicitly triaged-closed issues.
Do not batch unrelated issue fixes into one commit. Do not push, create PRs, comment, close, label, land, merge, or otherwise publish during the review/prove phase.
Companion Skills
Use $gitcrawl first, $openclaw-pr-maintainer for live GitHub hygiene, $github-deep-review posture for source tracing, and $openclaw-testing for proof.
Loop
For each ref:
- Read live target with
gh. - Check
gitcrawlfor related, duplicate, closed, or already-fixed threads. - Read body, comments, linked refs, changed files, current code, adjacent tests, and dependency contracts when relevant.
- Trace the real runtime path.
- For issues: fix locally only if this is a bug, current code proves root cause, the implicated path is clear, and a narrow patch is cleaner than refactor.
- For PRs: decide
ready-to-merge,needs-fixup, orskip; do not alter PR branches unless explicitly asked. - Add focused regression proof when practical for local issue fixes or PR readiness checks.
- Run the smallest meaningful gate.
- Continue until every pasted ref is fixed or classified.
No subagents unless explicitly requested.
Skip If
- not a bug
- config/docs/workflow/release/support/dependency/product work
- repro or root cause is uncertain
- larger refactor or owner-boundary change is cleaner
- already fixed on current
main - dependency behavior is guessed
- no focused proof is feasible
Skip with terse reason. Do not pad with low-confidence fixes.
Fix Rules
- owner module first; generic seam only when required
- existing patterns/helpers/types
- no drive-by refactors
- tests near failing surface
- docs only for changed public behavior
- no commit during the review/prove phase
- after Peter approves shipping, one commit plus changelog per accepted user-facing fix
- no push/create PR/comment/close/label/land/merge until Peter approves shipping after review
PR Rules
ready-to-merge: code is good, current head checked, required proof is green or clearly pending only external CI; list for maintainer merge or@clawsweeper automergeneeds-fixup: small bug is clear, but PR branch needs changes; list exact files/tests and wait for explicit fix/push/automerge instructionskip: broad, stale, speculative, config/product/security/release, owner-boundary, or refactor-sized- if source PR is untrusted/uneditable, do not create a replacement PR during sweep
Output Shape
Ledger: fixed-local, ready-to-merge, needs-fixup, skipped, needs-human.
Final: issue files left on disk, PRs ready for merge/automerge, tests/gates, skip reasons.
