create-branch

建立分支

依照 Sentry 命名慣例建立 git 分支。
除非使用者明確要求手動選擇名稱，否則保持此工作流程非互動式。

工作流程

1. 解析工作描述：

   • 如果 $ARGUMENTS 存在，則使用它
   • 否則檢查：

     git diff
     git diff --cached
     git status --short
     

   • 如果有本地變更，從 diff 中推導出簡短描述
   • 如果沒有本地變更，使用通用描述，例如 repo-maintenance、tooling-update 或 work-in-progress

2. 分類分支類型：

類型	使用時機
feat	新功能
fix	修正錯誤行為
ref	行為不變，結構改變
chore	維護現有工具/設定
perf	行為相同，速度更快
style	僅視覺或格式
docs	僅文件
test	僅測試
ci	CI/CD 設定
build	建置系統
meta	儲存庫元資料
license	授權變更

如果不確定：新功能用 feat，重構用 ref，維護用 chore。

3. 產生 <type>/<short-description>。
   保持 <short-description> 為 kebab-case、僅 ASCII，且理想為 3 到 6 個單詞。

4. 不經提示選擇基礎分支：

   git branch --show-current
   git remote | grep -qx origin && echo origin || git remote | head -1
   git symbolic-ref refs/remotes/<remote>/HEAD 2>/dev/null | sed 's|refs/remotes/<remote>/||' | tr -d '[:space:]'
   

   • 如果預設分支偵測失敗，依序回退到 main、master，再到目前分支
   • 如果處於 detached HEAD，從目前 commit 分支
   • 如果已經在非預設分支，從目前分支分支
   • 僅在使用者明確要求時才切換到預設分支

5. 避免衝突：依序附加 -2、-3 等，直到名稱在本地和遠端都未被使用。

6. 建立分支：

   git checkout -b <branch-name>
   

   回報最終分支名稱，但不要停下來要求確認。

參考資料

• Sentry 分支命名