git-branch

新しい git ブランチを作成します。

• ブランチ名: $ARGUMENTS[0] (必須)
• ベースブランチ: $ARGUMENTS[1] (オプション — リポジトリのデフォルトブランチにデフォルト設定)

手順

1. git rev-parse --is-inside-work-tree を実行して、これが git リポジトリであることを確認します。
2. ベースブランチが指定されていない場合、デフォルトブランチを検出します:

   git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's@^refs/remotes/origin/@@'
   

   失敗した場合は、main を確認してから master を確認するようフォールバックします。
3. ベースブランチのリモートから最新版をフェッチします:

   git fetch origin <base-branch>
   

4. ベースから新しいブランチを作成してチェックアウトします:

   git checkout -b <branch-name> origin/<base-branch>
   

5. 現在のブランチ名とそのトラッキングステータスを出力して、成功を確認します。

ブランチ命名

ユーザーがフォーマット済みのブランチ名ではなく説明的な名前を指定した場合、従来の形式に変換します:

• 小文字、ハイフンで単語を区切る
• インテントが明確で、プレフィックスが指定されていない場合は、feature/、fix/、chore/、docs/ などのプレフィックスを付けます
• 特殊文字を削除します

例: "Add user authentication" → feature/add-user-authentication

エラーハンドリング

• ブランチが既に存在する場合は、ユーザーに通知し、切り替えたいかどうか確認します。
• コミットされていない変更がある場合は、ユーザーに警告を表示し、先にスタッシュまたはコミットすることを提案します。
• リモートがない場合は、フェッチをスキップしてローカルベースからブランチを作成します。