CommandMate: Command for Claude Code

Worktree Cleanup スキル

概要

指定したIssue番号に対応するGit Worktree環境をクリーンアップするスキルです。

使用方法

/worktree-cleanup [Issue番号...]

例:

/worktree-cleanup 135
/worktree-cleanup 187 188 191 193

実行内容

あなたはWorktree環境クリーンアップの専門家です。以下の手順でWorktree環境を安全にクリーンアップしてください。 複数のIssue番号が指定された場合は、各Issueに対してPhase 1〜5を順番に繰り返し実行します。

パラメータ

• issue_numbers: 対象Issue番号（必須、1つ以上、スペース区切り、各番号は正の整数）

削除しない worktree

CLAUDE.md の「恒久 worktree（クリーンアップ対象外）」に載っている worktree とブランチ （../commandmate-main / main、../commandmate-agent-health / agent-health-runner）は、 このコマンドでも、Issue 番号を指定しない「worktree をまとめて片付けて」という依頼でも、削除・停止しない。 git worktree list から片付け対象を選ぶときは、先にこの一覧を除く。

---

実行フェーズ

複数Issue指定時: 以下のPhase 1〜6を各Issueに対して順番に実行します。 Phase 7（Worktree同期）は全Issue完了後にまとめて1回実行します。

Phase 1: 入力検証

1. Issue番号が正の整数であることを確認
2. Issue番号が1〜2147483647の範囲内であることを確認

# 共通バリデーション関数を読み込み
# Synced with: src/cli/utils/input-validators.ts MAX_ISSUE_NO
source "$(dirname "$0")/../lib/validators.sh"

# Issue番号の検証
if ! validate_issue_no "$ISSUE_NO"; then
  echo "Error: Invalid issue number"
  exit 1
fi

Phase 2: サーバー停止

1. Issue専用サーバーが起動中か確認（PIDファイルベース）
2. ポートベースでサーバーを検出（フォールバック）
3. 起動中の場合は停止

# プロセス管理ユーティリティを読み込み
source "$(dirname "$0")/../lib/process-utils.sh"

# Worktreeの絶対パスを取得
WORKTREE_DIR="../commandmate-issue-${ISSUE_NO}"
WORKTREE_ABS=$(cd "$WORKTREE_DIR" 2>/dev/null && pwd)

# Step 1: PIDファイルベースの検出（既存ロジック）
PID_FILE=~/.commandmate/pids/${ISSUE_NO}.pid

if [ -f "$PID_FILE" ]; then
  PID=$(cat "$PID_FILE")
  if kill -0 "$PID" 2>/dev/null; then
    echo "Stopping server for Issue #${ISSUE_NO} (PID: $PID)..."
    kill "$PID"
    sleep 3
    # 強制終了（必要な場合）
    kill -0 "$PID" 2>/dev/null && kill -9 "$PID"
  fi
  rm -f "$PID_FILE"
fi

# Step 2: ポートベースの検出（フォールバック）
# npm run devで直接起動したサーバーはPIDファイルがないため、ポートで検出
if check_lsof_available && [ -n "$WORKTREE_ABS" ]; then
  # 検出対象ポートの配列を構築
  PORTS_TO_CHECK=(3000)  # デフォルトポート

  # Issue専用ポート（4桁以下のIssue番号のみ）
  # ポート番号上限65535のため、3{issueNo}形式は1-9999まで
  if [ "$ISSUE_NO" -le 9999 ]; then
    PORTS_TO_CHECK+=("3${ISSUE_NO}")
  fi

  # 各ポートをチェック
  for PORT in "${PORTS_TO_CHECK[@]}"; do
    stop_server_by_port "$PORT" "$WORKTREE_ABS" "$ISSUE_NO"
  done
fi