From 6b324b4bd07cf34931691b4d259f00ead2e7cbb5 Mon Sep 17 00:00:00 2001
From: sky121113 <sky121113@gmail.com>
Date: Thu, 5 Mar 2026 08:49:05 +0800
Subject: [PATCH] =?UTF-8?q?[DOCS]=20=E5=B0=87=20Git=20=E8=A6=8F=E7=AF=84?=
 =?UTF-8?q?=E6=95=B4=E5=90=88=E8=87=B3=E9=96=8B=E7=99=BC=20Rules=20?=
 =?UTF-8?q?=E4=B8=A6=E7=A7=BB=E9=99=A4=E9=87=8D=E8=A4=87=E6=96=87=E4=BB=B6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .agents/rules/git-workflow.md | 47 +++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 .agents/rules/git-workflow.md

diff --git a/.agents/rules/git-workflow.md b/.agents/rules/git-workflow.md
new file mode 100644
index 0000000..baec22a
--- /dev/null
+++ b/.agents/rules/git-workflow.md
@@ -0,0 +1,47 @@
+---
+name: Git 分支管理與開發規範
+description: 強制執行 main 分支保護與開發分支流程，確保主分支僅用於 Bug 修正與版本釋放。
+---
+
+# Git 分支管理與開發規範 (Git Workflow)
+
+為了確保 `main` 分支的穩定性，所有開發者與 AI 助手必須嚴格遵守以下分支管理與合併規範。
+
+## 1. 分支架構與用途
+
+| 分支類型 | 命名規範 | 描述 | 合併目標 |
+| :--- | :--- | :--- | :--- |
+| **Main (穩定版)** | `main` | 生產環境分支，僅存放穩定、已測試的代碼。**禁止直接開發新功能**。 | N/A |
+| **Develop (開發版)** | `dev` | 日常開發整合分支，所有變更在此測試。 | `main` |
+| **Feature (新功能)** | `feature/*` | 用於開發新功能。 | `dev` |
+| **Hotfix (緊急修正)** | `hotfix/*` | 用於修復 `main` 分支的緊急 Bug。 | `main` & `dev` |
+| **Bugfix (修復)** | `bugfix/*` | 用於修復 `dev` 分支中的 Bug。 | `dev` |
+
+## 2. Main 分支約束條款 (Mandatory)
+
+1.  **禁止隨意上功能**：`main` 分支僅接受從 `dev` 合併過來的穩定版本，或用於修復生產環境 Bug 的 `hotfix/*` 分支。
+2.  **新功能隔離**：新功能開發必須在單獨的 `feature/*` 分支進行，並先合併至 `dev` 驗證。
+3.  **禁止直接 Commit**：嚴禁直接在 `main` 進行提交，必須透過合併流程並確保已測試。
+
+## 3. 開發流程 (Standard Operating Procedure)
+
+### 開發新功能
+1. 從 `dev` 建立 `feature/功能名稱`。
+2. 開發完成後合併至 `dev`。
+
+### 修復 Main Bug (Hotfix)
+1. 從 `main` 建立 `hotfix/Bug描述`。
+2. 修復後合併回 `main`，並**務必**同步合併至 `dev`。
+
+## 4. 提交訊息規範 (Commit Messages)
+
+提交訊息必須包含以下前綴：
+- `[FIX]`：修復 Bug。
+- `[FEAT]`：新增功能。
+- `[DOCS]`：文件更新。
+- `[STYLE]`：UI/CSS/格式調整。
+- `[REFACTOR]`：程式碼重構。
+
+---
+> [!IMPORTANT]
+> 身為 AI 助手 (Antigravity)，我在接收到任務時會優先判斷其性質。若為「新功能」且操作分支為 `main`，應主動提醒並引導切換至正確的分支開發。