ship（发布交付）

Ship

Get the branch onto main. Two paths: PR (CI up) or local merge (CI down).

Announce: "Using /ship to integrate this branch."

Prerequisites

1. On a feature branch (not main).
2. /review (Step 6) passed, or user explicitly approved.
3. Worktree path is known (needed for cleanup).

If any prerequisite is missing, say which and stop.

Step 1: Validate

pnpm validate

If validation fails, stop. Fix first.

Step 2: Determine target branch

Read the plan file's Target: field from ai-workspace/plans/<name>.md frontmatter. If no plan exists (hotfix/one-sentence scope), fall back to:

git -C <worktree> symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's|refs/remotes/origin/||'

Default: main. If ambiguous, ask.

Step 3: Present options

CI status comes from conversation context — if the user has said CI is down, frozen, or at billing cap, treat as down. No auto-detection.

CI up (default):

Ready to ship.

1. Open PR + auto-merge
2. Keep branch as-is
3. Discard

CI down:

Ready to ship (CI down — local merge with review gate).

1. Local merge to main
2. Keep branch as-is
3. Discard

Option 1a: PR + auto-merge (CI up)

git -C <worktree> push -u origin <branch>

GH_REPO=<owner/repo> gh pr create \
  --base "$TARGET" \
  --title "<conventional-commit-title>" \
  --body "$(cat <<'EOF'
## Summary
<2-3 bullets>

## Test plan
- [ ] <verification steps>
EOF
)"

GH_REPO=<owner/repo> gh pr merge --auto --merge

Report the PR URL. Proceed to worktree cleanup.

If CI blocks or fails after PR is up: STOP. Ask the user. No self-rescue, no local merge fallback, no force-merge.

Option 1b: Local merge (CI down)

Dispatch the code-reviewer agent on the diff first — all autonomous code must be reviewed before merge:

claude --agent code-reviewer "Review diff: git -C <worktree> diff $TARGET..HEAD"

If reviewer returns P0/P1 findings, STOP. Fix before proceeding.

Invoke /local-merge with BRANCH=<branch>, TARGET=$TARGET, PRIMARY=<primary-worktree-path>, MESSAGE="merge: <branch> into $TARGET". It handles the shallow clone, push with retry, and non-destructive propagation to primary.

Option 2: Keep as-is

Report: "Keeping branch <name>. Worktree preserved at <path>."

Do not clean up.

Option 3: Discard

Require typed "discard" confirmation. Show branch name, commit list, worktree path.

git -C <primary> worktree remove <worktree-path>
git -C <primary> branch -d <branch>

If branch -d fails (unmerged work), warn the user and stop — do NOT use branch -D. Only delete the remote branch after local delete succeeds:

git push origin --delete <branch>

Worktree Cleanup

After PR (1a) or local merge (1b):

git -C <primary> worktree remove <worktree-path>

Integration

Called by: /task (Step 8) Pairs with: /isolate (cleans up worktree it created), /review (must pass before /ship)