CommandMate: Skill for Claude Code

Rebuild

サーバーを停止し、ビルドしてバックグラウンドで再起動します。

⚠️ 最初に決めること: ビルドは要るのか（Issue #2132）

ビルドは「アプリケーションのコードが変わったとき」だけ必要です。 npm run build は .next/BUILD_ID を書き換えるため、開いているブラウザタブが chunk を取得できなくなって壊れます （.commandmate/verify.yaml が skipInPrimaryCheckout: true でビルドを外しているのと同じ理由）。

ビルド不要と判断したら Step 2 の代わりに次を 1 回の Bash 呼び出しで実行し、完了報告形式はそのまま使う:

cd {TARGET_DIR} && ./scripts/restart-nobuild.sh
cd {TARGET_DIR} && CM_PORT={port} ./scripts/restart-nobuild.sh   # ポート指定あり

手製の nohup npm start を使わないこと。 その前に source scripts/load-env.sh を叩く形になりますが、 このスクリプトは bash 専用で、zsh から source すると .env を 1 変数も読み込みません （Issue #2132 以降はエラーで失敗しますが、正しい手段は上記の 2 スクリプトです）。

使用方法

/rebuild                        # 現在のリポジトリで実行
/rebuild feature/235-worktree   # 指定ブランチのWorktreeで実行
/rebuild --port 3011            # ポート3011で起動
/rebuild feature/235-worktree --port 3011  # ブランチ指定+ポート指定

パラメータ

• branch_name: 対象ブランチ名（省略可）。指定時は git worktree list からディレクトリを解決する。
• --port {number}: 起動ポート番号（省略可）。指定時は CM_PORT 環境変数を設定してサーバーを起動する。未指定時はデフォルト（3000）。

実行手順

Step 1: 実行ディレクトリの決定

1. ブランチ名が指定された場合:

   • git worktree list を実行し、指定ブランチに対応するディレクトリを取得する
   • 見つからない場合はエラー終了（「ブランチ '{branch_name}' に対応するWorktreeが見つかりません」）
   • 見つかったディレクトリを TARGET_DIR とする

2. ブランチ名が未指定の場合:

   • 現在の作業ディレクトリ（プロジェクトルート）を TARGET_DIR とする

Step 2: サーバー停止・ビルド・再起動

停止とビルド・再起動を 1回のBash呼び出し で実行する（ユーザーへの許可確認を1回に抑えるため）。

ポート指定なしの場合:

cd {TARGET_DIR} && ./scripts/stop.sh && ./scripts/build-and-start.sh --daemon

ポート指定ありの場合:

cd {TARGET_DIR} && CM_PORT={port} ./scripts/stop.sh && CM_PORT={port} ./scripts/build-and-start.sh --daemon

注意: ポート競合が発生した場合は lsof -nP -iTCP:{port} -sTCP:LISTEN -t で待ち受け中のプロセスを特定し、killしてから再試行する。 -sTCP:LISTEN を外すと、そのポートに接続しているだけのプロセス（CommandMate を開いているブラウザの network service、他セッションの CLI など）まで返り、止めると CommandMate 以外のタブの通信も一斉に切れる（Issue #2473）。