Community程式設計與開發github.com

mtai0524/claude-skills

分支命名規範,以及修改預設分支(main/master)上的程式碼前必須先建立分支的規則。適用於開始新工作、建立分支,或即將於預設分支上編輯程式碼時。

claude-skills 是什麼?

此技能定義了 git 分支的命名慣例與流程,確保開發團隊遵守一致的規則。它強制要求開發者在開始改動程式碼前,必須先從預設分支(main 或 master)切換到一個新分支,以避免直接修改主幹。分支名稱採用 `<type>/<short-kebab-description>` 格式,其 type 值與傳統的 commit type(如 feat、fix、refactor 等)對應,且全小寫、短橫線分隔、長度不超過 40 個字元。當有 issue/ticket 編號時,應一併納入名稱中(例如 `feat/KV-12-login-screen`),以提升可追溯性。此技能適用於所有使用 git 的開發環境,特別是在 Cursor、Claude Code 或 Codex 等 AI 代理工具中,能自動提醒使用者建立正確名稱的分支,並防止無 ticket 的模糊名稱(如 `fix/stuff`)。它不自動推送分支,保留使用者的推送權限,讓流程可控。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mtai0524/claude-skills/tree/HEAD/skills/branch-naming

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

分支命名

格式:<類型>/<短橫線小寫描述>

  • 類型需與提交類型一致:feat/、fix/、refactor/、chore/、docs/、test/、hotfix/。
  • 全部小寫,使用短橫線分隔,不超過 40 個字元,避免無票證的模糊命名(例如 fix/stuff 是不好的)。
  • 若有票證編號,應包含:feat/KV-12-login-screen。

規則:

  • 在修改程式碼之前,先執行 git branch --show-current 確認當前分支。如果處於預設分支(main 或 master),請先建立分支:git switch -c <類型>/<名稱>。
  • 永遠不要直接推送該分支;由使用者手動推送。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

相關技能