salimhamed/claude-code-flow

wt-merge

Squash-merge the current branch's PR, clean up the worktree, return to main, and report remaining worktree status

ソースを見る

使い方

  1. インストールコマンドをコピーし、自分の環境へ導入する前にソースを確認します。
  2. 必要なツール、認証情報、対応環境を原文で確認します。
  3. 入力と成果物を指定し、出力を資料と照合します。
npx skills add https://github.com/salimhamed/claude-code-flow --skill wt-merge

開始前の確認

  • 導入にはモデル契約、API枠、ファイルへのアクセス許可は含まれません。
  • スター数や導入数は活動の指標であり、独立した品質・安全性試験ではありません。
リポジトリの原文

見出し、例、コード、表、リンク、参照画像を含む原文を表示しています。

Merge Worktree

Announce at start: "I'm using the wt-merge skill to squash-merge and clean up."

Context

  • Current directory: !pwd
  • Current branch: !git branch --show-current
  • Worktrees: !git worktree list --porcelain
  • Working tree status: !git status --porcelain
  • Unpushed commits: !git rev-list '@{u}..HEAD' 2>/dev/null || echo NO_UPSTREAM
  • PR info: !gh pr view --json number,url,state,title 2>&1 || echo NO_PR

Decision Flowchart

mermaid
flowchart TD
    A[Preconditions] -- fail --> STOP
    A -- pass --> B[Merge PR]
    B --> C[Cleanup + update main]
    C --> D[Report]

Preconditions

Only two checks before proceeding — everything else fails naturally with clear errors from gh pr merge.

CheckHow to detectAction
Uncommitted changesWorking tree status is non-emptySTOP — tell user to commit or stash
Unpushed commitsOutput shows commit SHAs or NO_UPSTREAMRun git push -u origin HEAD, then continue

Variables

Extract from context above:

VariableSource
{NUMBER}PR number from PR info
{MAIN_WORKTREE}Path of the first entry in the worktree list (the main worktree)
{WORKTREE_PATH}Current directory (the feature worktree being removed)
{BRANCH}Current branch name

Steps

Step 1: Merge

bash
gh pr merge {NUMBER} --squash

Use the PR number from context. Do NOT use --delete-branch (it tries to switch branches locally, which fails when the default branch is already checked out in the main worktree). Branch cleanup is handled in Step 2.

If this fails, STOP and show the error to the user.

Step 2: Cleanup + update main

CRITICAL: This MUST be a single Bash invocation. After worktree remove deletes {WORKTREEPATH}, the shell's CWD no longer exists and ALL subsequent Bash tool calls will fail. Every command uses `git -C` to operate from {MAINWORKTREE} regardless of the shell's CWD state.

Do NOT split these into separate Bash calls. Do NOT remove or reorder commands.

bash
git -C {MAIN_WORKTREE} worktree remove --force {WORKTREE_PATH}; git -C {MAIN_WORKTREE} worktree prune; git -C {MAIN_WORKTREE} branch -D {BRANCH} 2>/dev/null; git -C {MAIN_WORKTREE} fetch --prune && git -C {MAIN_WORKTREE} pull --ff-only; echo "===REMAINING WORKTREES==="; git -C {MAIN_WORKTREE} worktree list

Commands are joined with ; (continue regardless of errors) except fetch && pull which are dependent. Individual failures are tolerated — the branch or worktree directory may already be gone.

Step 3: Report

Parse the output from Step 2. Everything after ===REMAINING WORKTREES=== is the current worktree list.

Summarize:

  • PR was squash-merged (include title and URL from context)
  • Worktree was removed
  • Main branch was updated (or note if ff-only failed based on Step 2 output)
  • List remaining worktrees from Step 2 output

Then tell the user: "The current directory has been deleted. Please close this session and open a new one from a valid directory."

Do NOT run any further Bash commands or offer follow-up actions — the shell is broken because the CWD was deleted with the worktree.

Red Flags

Never:

  • Remove a worktree without merging first
  • Delete worktrees the user didn't confirm
  • Split Step 2 into multiple Bash calls
  • Run Bash commands after Step 2 completes (CWD no longer exists)

Always:

  • Use git -C {MAIN_WORKTREE} for all git commands (never cd)
  • Keep all post-merge operations in a single Bash invocation
  • Tolerate errors during cleanup (worktree remove, branch delete)

タスクに関連する項目

同じリポジトリから

関連する Skills

すべての Skills