Maintainer Sweep

Kaku Maintainer Sweep

Use this skill for maintenance work that spans GitHub issues, pull requests, local fixes, main CI, and public follow-up. It is not the notarized release flow, and it must not contain private signing credentials or local machine setup.

Workflow

1. Refresh live state

   • Run gh issue list --state open --limit 20 and gh pr list --state open --limit 20.
   • For each actionable item, read gh issue view <n> or gh pr view <n> and confirm title, author, state, body, and recent comments.
   • If the task asks for the latest state, refresh the lists again before final decisions.

2. Map reports to code

   • Find the latest release tag with git tag --list 'V*' --sort=-version:refname | head -1; without the V* filter the rolling nightly tag sorts first.
   • Compare relevant changes with git log <tag>..HEAD --oneline, git show, and targeted rg.
   • Do not treat a closed issue as proof. Identify the fix mechanism, the commit, or the remaining gap.

3. Fix and verify

   • Keep fixes scoped. For unrelated issues, prefer one commit per issue or behavior.
   • For shell integration changes, run the affected assets/shell-integration/tests/*_smoke.sh script, then the full list that .github/workflows/checks.yml runs under Shell integration smoke tests when feasible.
   • For AI provider, transport, or config changes, run targeted Cargo tests before repository-level checks.
   • For release-adjacent work, prefer git diff --check, make fmt-check, make check, make test, and make app unless the maintainer narrows the gate.

4. Push safely

   • Run git fetch origin main, then verify origin/main still matches the expected base before git push origin main.
   • If origin/main moved, stop and review origin/main..HEAD.
   • After pushing, locate the new run with gh run list --branch main --limit 5 and watch it with gh run watch <id> --exit-status.

5. Follow up publicly

   • Post fixed/closed replies only after the relevant GitHub Actions run on main is green.
   • Confirm each item identity again before posting.
   • Match the opener's language when it is Chinese or English. Use English for Japanese or Korean unless the maintainer says otherwise.
   • Start with @login, one short thanks, the concrete fix or reason, and the next release, nightly, or verification step.
   • Use Nightly as a test path only after verifying it was rebuilt for the fix. nightly is a rolling GitHub prerelease produced by ./scripts/nightly.sh; a push to main alone does not refresh the DMG.
   • For merged contributor PRs, leave at most one short thanks comment after merge or Nightly availability, and avoid duplicating bot or deployment noise.
   • Propose closure and wait for maintainer confirmation this turn before closing (root AGENTS.md closure pipeline). Once confirmed, close with --reason completed.
   • Close PRs without merging only when the fix is already covered on main, the direction is no longer needed, the patch is unsafe, the work is duplicate, or the maintainer explicitly rejects it.
   • If an accepted contributor fix lands through a maintainer commit, mention the landed commit and co-author credit in the PR comment.

Final Report

Report the pushed branch and commit, the CI run URL and conclusion, any verified Nightly URL when used, each issue/PR decision, and whether any open issues or PRs remain.