AI Skills
git-flow-branch-creator

git-flow-branch-creator

熱門

智慧型 Git Flow 分支建立工具，能分析 git status/diff 並根據 nvie Git Flow 分支模型建立適當的分支。

3.6萬星標
4556分支
更新於 2026/7/13
獲取技能源代碼

相關技能

pnpm5444gws-classroom2.9萬supabase2259
SKILL.md
readonlyread-only
name
git-flow-branch-creator
description

智慧型 Git Flow 分支建立工具，能分析 git status/diff 並根據 nvie Git Flow 分支模型建立適當的分支。

使用說明

<instructions>
	<title>Git Flow 分支建立工具</title>
	<description>此提示會使用 git status 和 git diff（或 git diff --cached）分析你目前的 Git 變更，然後根據 Git Flow 分支模型智慧判斷適當的分支類型，並建立語意化的分支名稱。</description>
	<note>
		只要執行此提示，Copilot 就會分析你的變更並建立適當的 Git Flow 分支。
	</note>
</instructions>

工作流程

請依下列步驟操作：

  1. 執行 git status 檢視目前儲存庫狀態及已變更的檔案。
  2. 執行 git diff（未暫存變更）或 git diff --cached（已暫存變更）分析變更的性質。
  3. 使用下方的 Git Flow 分支分析架構分析變更。
  4. 根據分析結果決定適當的分支類型。
  5. 依照 Git Flow 慣例產生語意化的分支名稱。
  6. 自動建立分支並切換過去。
  7. 提供分析摘要及後續步驟。

Git Flow 分支分析架構

<analysis-framework>
	<branch-types>
		<feature>
			<purpose>新功能、增強、非關鍵性改善</purpose>
			<branch-from>develop</branch-from>
			<merge-to>develop</merge-to>
			<naming>feature/descriptive-name 或 feature/ticket-number-description</naming>
			<indicators>
				<indicator>新增功能</indicator>
				<indicator>UI/UX 改善</indicator>
				<indicator>新的 API 端點或方法</indicator>
				<indicator>資料庫綱要新增（非破壞性）</indicator>
				<indicator>新的設定選項</indicator>
				<indicator>效能改善（非關鍵性）</indicator>
			</indicators>
		</feature>

		<release>
			<purpose>發行準備、版本號更新、最終測試</purpose>
			<branch-from>develop</branch-from>
			<merge-to>develop 和 master</merge-to>
			<naming>release-X.Y.Z</naming>
			<indicators>
				<indicator>版本號變更</indicator>
				<indicator>建置設定更新</indicator>
				<indicator>文件定稿</indicator>
				<indicator>發行前的小型錯誤修正</indicator>
				<indicator>發行說明更新</indicator>
				<indicator>相依套件版本鎖定</indicator>
			</indicators>
		</release>

		<hotfix>
			<purpose>需要立即部署的關鍵生產錯誤修正</purpose>
			<branch-from>master</branch-from>
			<merge-to>develop 和 master</merge-to>
			<naming>hotfix-X.Y.Z 或 hotfix/critical-issue-description</naming>
			<indicators>
				<indicator>安全性漏洞修正</indicator>
				<indicator>關鍵生產錯誤</indicator>
				<indicator>資料毀損修正</indicator>
				<indicator>服務中斷解決</indicator>
				<indicator>緊急設定變更</indicator>
			</indicators>
		</hotfix>
	</branch-types>
</analysis-framework>

分支命名慣例

<naming-conventions>
	<feature-branches>
		<format>feature/[ticket-number-]descriptive-name</format>
		<examples>
			<example>feature/user-authentication</example>
			<example>feature/PROJ-123-shopping-cart</example>
			<example>feature/api-rate-limiting</example>
			<example>feature/dashboard-redesign</example>
		</examples>
	</feature-branches>

	<release-branches>
		<format>release-X.Y.Z</format>
		<examples>
			<example>release-1.2.0</example>
			<example>release-2.1.0</example>
			<example>release-1.0.0</example>
		</examples>
	</release-branches>

	<hotfix-branches>
		<format>hotfix-X.Y.Z 或 hotfix/critical-description</format>
		<examples>
			<example>hotfix-1.2.1</example>
			<example>hotfix/security-patch</example>
			<example>hotfix/payment-gateway-fix</example>
			<example>hotfix-2.1.1</example>
		</examples>
	</hotfix-branches>
</naming-conventions>

分析流程

<analysis-process>
	<step-1>
		<title>變更性質分析</title>
		<description>檢查修改的檔案類型及變更的性質</description>
		<criteria>
			<files-modified>查看副檔名、目錄結構及用途</files-modified>
			<change-scope>判斷變更是新增、修正還是準備性質</change-scope>
			<urgency-level>評估變更是否處理關鍵問題或屬於開發性質</urgency-level>
		</criteria>
	</step-1>

	<step-2>
		<title>Git Flow 分類</title>
		<description>將變更對應到適當的 Git Flow 分支類型</description>
		<decision-tree>
			<question>這些是生產問題的關鍵修正嗎？</question>
			<if-yes>考慮 hotfix 分支</if-yes>
			<if-no>
				<question>這些是發行準備變更（版本號更新、最終調整）嗎？</question>
				<if-yes>考慮 release 分支</if-yes>
				<if-no>預設為 feature 分支</if-no>
			</if-no>
		</decision-tree>
	</step-2>

	<step-3>
		<title>分支名稱產生</title>
		<description>建立語意化、描述性的分支名稱</description>
		<guidelines>
			<use-kebab-case>使用小寫字母並以連字號分隔</use-kebab-case>
			<be-descriptive>名稱應清楚指出用途</be-descriptive>
			<include-context>在可行時加入票號或專案背景</include-context>
			<keep-concise>避免過長的名稱</keep-concise>
		</guidelines>
	</step-3>
</analysis-process>

邊界情況與驗證

<edge-cases>
	<mixed-changes>
		<scenario>變更同時包含功能與錯誤修正</scenario>
		<resolution>優先處理最重要的變更類型，或建議拆分為多個分支</resolution>
	</mixed-changes>

	<no-changes>
		<scenario>git status/diff 未偵測到任何變更</scenario>
		<resolution>通知使用者，建議先檢查 git status 或進行變更</resolution>
	</no-changes>

	<existing-branch>
		<scenario>已在 feature/hotfix/release 分支上</scenario>
		<resolution>分析是否需要新分支，或目前分支是否合適</resolution>
	</existing-branch>

	<conflicting-names>
		<scenario>建議的分支名稱已存在</scenario>
		<resolution>附加遞增後綴或建議替代名稱</resolution>
	</conflicting-names>
</edge-cases>

範例

<examples>
	<example-1>
		<scenario>新增使用者註冊 API 端點</scenario>
		<analysis>新功能、新增變更、非關鍵</analysis>
		<branch-type>feature</branch-type>
		<branch-name>feature/user-registration-api</branch-name>
		<command>git checkout -b feature/user-registration-api develop</command>
	</example-1>

	<example-2>
		<scenario>修正驗證機制中的關鍵安全性漏洞</scenario>
		<analysis>安全性修正、生產關鍵、需立即部署</analysis>
		<branch-type>hotfix</branch-type>
		<branch-name>hotfix/auth-security-patch</branch-name>
		<command>git checkout -b hotfix/auth-security-patch master</command>
	</example-2>

	<example-3>
		<scenario>更新版本至 2.1.0 並完成發行說明</scenario>
		<analysis>發行準備、版本號更新、文件</analysis>
		<branch-type>release</branch-type>
		<branch-name>release-2.1.0</branch-name>
		<command>git checkout -b release-2.1.0 develop</command>
	</example-3>

	<example-4>
		<scenario>改善資料庫查詢效能並更新快取</scenario>
		<analysis>效能改善、非關鍵性增強</analysis>
		<branch-type>feature</branch-type>
		<branch-name>feature/database-performance-optimization</branch-name>
		<command>git checkout -b feature/database-performance-optimization develop</command>
	</example-4>
</examples>

驗證檢查清單

<validation>
	<pre-analysis>
		<check>儲存庫處於乾淨狀態（無未提交變更造成衝突）</check>
		<check>目前分支是適當的起點（feature/release 從 develop，hotfix 從 master）</check>
		<check>遠端儲存庫已更新</check>
	</pre-analysis>

	<analysis-quality>
		<check>變更分析涵蓋所有修改的檔案</check>
		<check>分支類型選擇遵循 Git Flow 原則</check>
		<check>分支名稱語意化且符合慣例</check>
		<check>邊界情況已考慮並處理</check>
	</analysis-quality>

	<execution-safety>
		<check>目標分支（develop/master）存在且可存取</check>
		<check>建議的分支名稱不與現有分支衝突</check>
		<check>使用者有適當權限建立分支</check>
	</execution-safety>
</validation>

最終執行

<execution-protocol>
	<analysis-summary>
		<git-status>git status 指令的輸出</git-status>
		<git-diff>git diff 輸出的相關部分</git-diff>
		<change-analysis>變更所代表內容的詳細分析</change-analysis>
		<branch-decision>選擇特定分支類型的理由說明</branch-decision>
	</analysis-summary>

	<branch-creation>
		<command>git checkout -b [branch-name] [source-branch]</command>
		<confirmation>確認分支建立成功及目前分支狀態</confirmation>
		<next-steps>提供後續動作指引（提交變更、推送分支等）</next-steps>
	</branch-creation>

	<fallback-options>
		<alternative-names>若主要建議不合適，提供 2-3 個替代分支名稱</alternative-names>
		<manual-override>允許使用者指定不同的分支類型（若分析結果似乎不正確）</manual-override>
	</fallback-options>
</execution-protocol>

Git Flow 參考

<gitflow-reference>
	<main-branches>
		<master>生產就緒程式碼，每次提交都是一個發行版本</master>
		<develop>功能整合分支，最新的開發變更</develop>
	</main-branches>

	<supporting-branches>
		<feature>從 develop 分支，合併回 develop</feature>
		<release>從 develop 分支，合併到 develop 和 master</release>
		<hotfix>從 master 分支，合併到 develop 和 master</hotfix>
	</supporting-branches>

	<merge-strategy>
		<flag>一律使用 --no-ff 旗標以保留分支歷史</flag>
		<tagging>在 master 分支上標記發行版本</tagging>
		<cleanup>成功合併後刪除分支</cleanup>
	</merge-strategy>
</gitflow-reference>