AgentSkillsCN

branch-management

在创建PR、合并代码，或在涉及main、develop与release分支时，审阅并指导分支策略。

SKILL.md
--- frontmatter
name: branch-management
description: Review and guide branch strategy when creating PRs, merging, or creating branches involving main, develop, and release branches
allowed-tools: [Bash, Read, Grep, Glob]

ブランチ管理ガイド

責務

ブランチ戦略・命名規則・PR作成ルールを管理する。

  • •リリースフロー全体（version bump → tag → merge）は /release-procedure skill を参照
  • •CI 実行方法・エラー対処は /local-ci skill を参照

ブランチ戦略

ブランチの役割

ブランチ役割派生元
main本番リリース（tag 付与対象）-
develop開発統合ブランチ-
release/*リリース準備develop
feature/*新機能develop
fix/*バグ修正develop
refactor/*リファクタリングdevelop
docs/*ドキュメントdevelop

フロー

code
feature/* ─┐
fix/*      ├─→ develop → release/* → develop → main → tag
refactor/* ─┘

ルール一覧

操作許可禁止
main への変更develop からの PR マージのみ直接 push、他ブランチからのマージ
develop への変更作業ブランチ or release/* からの PR マージ直接 push
release/* の作成develop から派生main や作業ブランチから派生
作業ブランチの作成develop から派生main から直接派生

実施手順

作業ブランチを作成する場合

bash
git checkout develop
git pull origin develop
git checkout -b feature/my-feature

PR を作成する場合

現在のブランチPR先コマンド例
feature/, fix/, refactor/, docs/developgh pr create --base develop
release/*developgh pr create --base develop
developmaingh pr create --base main

マージ方法の選択基準

マージ方法使用場面コマンド
Squash作業ブランチ → develop（複数コミットを1つに）gh pr merge --squash
Mergerelease → develop（履歴保持）gh pr merge --merge
Mergedevelop → main（履歴保持）gh pr merge --merge

警告パターン

以下の操作を検知した場合は警告:

操作警告メッセージ
git push origin mainmain への直接 push は禁止です。develop からの PR を作成してください。
git push origin developdevelop への直接 push は禁止です。作業ブランチからの PR を作成してください。
git checkout -b feature/* main作業ブランチは develop から派生してください。
git merge mainmain からのマージは想定外です。派生元を確認してください。

クイックリファレンス

code
作業開始:
  git checkout develop && git pull origin develop
  git checkout -b feature/my-work

作業完了（PR作成）:
  gh pr create --base develop

PRマージ:
  gh pr checks <PR番号>
  gh pr merge <PR番号> --squash   # 作業ブランチ用
  gh pr merge <PR番号> --merge    # release/develop用

完全リリースフロー:
  /release-procedure skill を参照