| name | creating-git-branch |
| description | Git リポジトリの慣習に則って新しいブランチを作成します。ユーザーがブランチの作成を求めたときや、エージェントがブランチを作成するときに必ず使用してください。 |
Git ブランチ作成
前提
README.md やメモリファイル(AGENTS.md や CLAUDE.md
など)にブランチ名の規約がある場合、それに従う。
以下のワークフローは、明確な規約がない場合に実行します。
ワークフロー
1. 情報収集
既存のブランチ名を取得:
git branch --sort=-committerdate | grep -v -E '^\*?\s*(main|master)\s*$' | head -10
2. 判定
スタイル判定
既存ブランチから以下を判定します。
- シンプル形式:
add-feature、fix-bugなどスラッシュなし - プレフィックス付き:
feature/xxx、fix/xxxなどスラッシュを含む
例外
- 複数スタイルが混在する場合、最も使用頻度の高いスタイルを採用
- 既存ブランチがない場合は、どのスタイルを使用するかユーザーに確認
プレフィックス判定
プレフィックス付きスタイルの場合、以下のコマンドでプレフィックス一覧を取得します:
git branch --all | head -100 | grep -v -E 'HEAD|main\s*$|master\s*$' | sed -E 's/^\*?\s*//; s|remotes/origin/||' | grep '/' | cut -d'/' -f1 | sort -u | awk '{printf "%s%s", sep, $0; sep=", "} END {print ""}'
3. ブランチ名生成
判定したスタイルに基づき、2〜5 単語程度のブランチ名を生成します。
- 動詞始まり(
add、update、fix、removeなど) - ハイフン区切り
- 変更内容を簡潔に表現
4. ブランチ作成
ブランチ名を提示し、ユーザーに確認した上でブランチを作成してください。
git switch -c <branch-name>