branch

🌿 ブランチ自動作成

[!IMPORTANT] このスキルは Issue URL から dev/{Issue番号}_{要約} 形式のブランチを 1 コマンドで作成する。 結果のみを簡潔に返す。途中経過は出力しない。 --worktree 指定時はブランチ作成と同時に git worktree を作成し、.claude/ を rsync で同期する。

GitHub Issue URL からブランチを作成する。

📖 使用方法

/vibecorp:branch <Issue URL>
/vibecorp:branch --worktree <Issue URL>

⚙️ オプション

オプション	説明
--worktree	ブランチ作成と同時に git worktree を作成し、独立したディレクトリで作業できるようにする

🔄 ワークフロー

1. Issue 情報の取得

引数から Issue URL を受け取り、Issue 番号とタイトルを取得する。

gh issue view <Issue URL> --json number,title --jq '.number,.title'

2. ブランチ名の生成

タイトルを英語の短い要約（スネークケース）に変換し、以下の形式でブランチ名を生成する。

dev/{Issue番号}_{要約}

要約ルール:

項目	ルール
表記	英語のスネークケース（小文字 + アンダースコア）
文字数	最大 30 文字
除外	絵文字・タイプ接頭辞（feat:, fix: 等）は除外する
単語数	内容を端的に表す 2〜4 単語

例:

• ✨ feat: /vibecorp:ship Issue指定からマージまでの全自動スキル → dev/67_ship_auto_merge
• 🐛 fix: mvv.md path notation inconsistency → dev/41_mvv_path_fix

3. ベースブランチの最新化

git pull origin HEAD --ff-only

4. ブランチ作成

--worktree オプションの有無で分岐する。

通常モード（--worktree なし）

git checkout -b <ブランチ名>

ワークツリーモード（--worktree あり）

4a. ワークツリーディレクトリの決定

vibecorp.yml の worktree_dir を読み取る。未設定の場合はデフォルト値を使用する。

MAIN_DIR=$(git rev-parse --show-toplevel)

# vibecorp.yml の worktree_dir を読み取る（未定義なら空文字）
CONFIG_WORKTREE_DIR=$(awk '/^worktree_dir:[[:space:]]*/ { sub(/^worktree_dir:[[:space:]]*/, ""); sub(/[[:space:]]*$/, ""); print; exit }' "$MAIN_DIR/.claude/vibecorp.yml")

if [ -n "$CONFIG_WORKTREE_DIR" ]; then
  # worktree_dir が定義されている場合: 絶対パスはそのまま、相対パスはプロジェクトルート基準
  case "$CONFIG_WORKTREE_DIR" in
    /*) WORKTREE_BASE="$CONFIG_WORKTREE_DIR" ;;
    *) WORKTREE_BASE="$MAIN_DIR/$CONFIG_WORKTREE_DIR" ;;
  esac
else
  # デフォルト: ../{プロジェクト名}.worktrees
  PROJECT_NAME=$(awk '/^name:[[:space:]]*/ { sub(/^name:[[:space:]]*/, ""); sub(/[[:space:]]*$/, ""); print; exit }' "$MAIN_DIR/.claude/vibecorp.yml" | tr -cs 'A-Za-z0-9._-' '_')
  WORKTREE_BASE="${MAIN_DIR}/../${PROJECT_NAME}.worktrees"
fi

4b. ワークツリーの作成

mkdir -p "$WORKTREE_BASE"
git worktree add "$WORKTREE_BASE/<ブランチ名>" -b <ブランチ名>

4c. .claude/ の同期

メインワークツリーの .claude/ を worktree にコピーする。git 追跡状況に関わらず全ケースで同じコマンドで動作する。

rsync -a "$MAIN_DIR/.claude/" "$WORKTREE_BASE/<ブランチ名>/.claude/"

⚠️ 制約

• jq では string interpolation \(...) を使わない — Bash 上で \ がエスケープ文字、() がサブシェルとして解釈され、意図しない展開やパースエラーを引き起こすため。必ず + で結合する。
• コマンドをそのまま実行する — 2>/dev/null、|| echo、; echo 等のリダイレクトやフォールバックを付加しない（根拠）。
• 既存のブランチ名と衝突する場合はユーザーに報告して停止する。

📤 返却フォーマット

通常モード

<ブランチ名>

ワークツリーモード

<ブランチ名>
worktree: <ワークツリーの絶対パス>

🔗 関連ルール

• ブランチ命名規約: .claude/rules/workflow.md
• プロンプト作成基準: .claude/rules/prompt-writing.md
• マークダウン規約: .claude/rules/markdown.md
• シェル規約: .claude/rules/shell.md