name: smith-ship description: Ship pipeline — review a worktree change to convergence, then atomic commit, push, PR, address review, squash-merge, ff-only sync, cleanup. Invoke with /smith-ship when you want to ship the current change end-to-end. argument-hint: [scope or PR title] allowed-tools: Bash(git *), Bash(gh *)
/smith-ship — ship the current change end-to-end
Drive the change in the current worktree from review to merged, following smith
conventions. Run phases in order; stop and surface only on the must-ask triggers
in @smith-gh-pr/SKILL.md (Review Convergence Protocol). Argument (if given) is
the intended PR scope/title.
Live state
- Status: !
git status -s - Branch: !
git branch --show-current - Open PR (if any): !
gh pr status 2>/dev/null | head -20
Procedure
Load and follow @smith-gh-pr/SKILL.md, @smith-git/SKILL.md,
@smith-style/SKILL.md, @smith-worktree/SKILL.md, and
@smith-subagents/SKILL.md.
- Isolate — check
git status --porcelainFIRST: if the checkout is dirty, STOP and pick ONE path: (a) commit or stash the changes, thenEnterWorktree; or (b) branch in place (git switch -c …) and continue in the current checkout — noEnterWorktreeat all (the tree is still dirty and theworktree-dirty-guardhook would block it; a new worktree starts clean, stranding uncommitted changes).worktree.baseRef: headonly preserves already-committed unpushed work, never uncommitted changes. Then, if on the EnterWorktree path in a background session, enter the worktree (see@smith-worktree) and rename the branch to the@smith-styleconvention before any push. - Review to convergence — run the
/smith-reviewloop; it owns the tool marshaling, per-round receipts, and convergence criteria. Do not ship until it reports converged. - Commit — logically and semantically atomic; conventional subject ≤72,
body ≤72/line,
Assisted-by:trailer (see@smith-style). One concern per commit. - Push & PR — push the renamed branch;
gh pr create --base <default> --assignee @mewith a What/Why/Testing body ending with theAssisted-by:line (@smith-style). Link issues only if real. The body and title are content: show them and create on an explicit yes (@smith-guidanceHarmless). - Address review — follow
@smith-gh-pr(Code Review Cycle, Posting Review Findings) for fetching, replying, attribution, suggestion blocks, and the content-vs-mechanics gate. Ship-specific: fix high-confidence findings with fix + amend (not new commits); after each push rerun the/smith-reviewloop to a fresh converged verdict (full receipt + criteria — a mechanics-only recheck is not convergence); confirm CodeRabbit actually ran before trusting 0 (@smith-gh-pr"CodeRabbit fails OPEN"). - Merge — on a converged verdict for the LATEST pushed commit (earlier
convergence does not carry across new commits),
gh pr merge --squash --delete-branch(targets the current branch's PR). If this branch has an open child PR stacked on it, OMIT--delete-branchand follow@smith-stacksinstead. - Sync & clean up —
ExitWorktree(remove), then ff-only pull the repo's DEFAULT branch in the primary checkout; clear any squash-merge orphan branch (@smith-worktreeSync-After-Squash-Merge).
State results in your own message (in-band); end with a result: line.
Expert Next.js App Router
Developpement
Un skill qui transforme Claude en expert Next.js App Router.
Générateur de README
Developpement
Crée des README.md professionnels et complets pour vos projets.
Rédacteur de Documentation API
Developpement
Génère de la documentation API complète au format OpenAPI/Swagger.