From 02e5f5d4ead86c89da712457132ba78481a6c713 Mon Sep 17 00:00:00 2001 From: sky121113 Date: Fri, 6 Mar 2026 14:54:54 +0800 Subject: [PATCH] =?UTF-8?q?[DOCS]=20=E9=87=8D=E6=A7=8B=20Git=20=E7=99=BC?= =?UTF-8?q?=E5=B8=83=E8=A6=8F=E7=AF=84=EF=BC=9A=E5=B0=87=E5=AE=89=E5=85=A8?= =?UTF-8?q?=E6=80=A7=E6=AA=A2=E6=9F=A5=E8=A6=8F=E5=89=87=E6=94=B6=E6=94=8F?= =?UTF-8?q?=E8=87=B3=20SKILL.md=20=E4=B8=A6=E8=88=87=20now-push=20?= =?UTF-8?q?=E5=B7=A5=E4=BD=9C=E6=B5=81=E8=A7=A3=E8=80=A6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .agents/skills/git-workflows/SKILL.md | 7 +++--- .agents/workflows/now-push.md | 32 ++++++++++----------------- 2 files changed, 16 insertions(+), 23 deletions(-) diff --git a/.agents/skills/git-workflows/SKILL.md b/.agents/skills/git-workflows/SKILL.md index 388a709..97b9c7d 100644 --- a/.agents/skills/git-workflows/SKILL.md +++ b/.agents/skills/git-workflows/SKILL.md @@ -18,11 +18,12 @@ description: 規範開發過程中的 Git 分支架構、合併限制、環境 ## 2. 發布時段與約束 (Release Window) ### Main 分支發布限制 (Mandatory) -1. **標準發布時間**：週一至週四，**12:00 (中午) 之前**。 -2. **非標準時段提醒**：若於上述時段以外（週五、週末、國定假日或下班時間）欲合併至 `main`： +1. **強制規範**：若執行推送/合併指令時未明確包含目標分支，**嚴禁** 自行預設或推論為 `main`。我必須先詢問使用者：「請問要推送到哪一個目標分支？(dev / demo / main)」。 +2. **標準發布時間**：週一至週四，**12:00 (中午) 之前**。 +3. **非標準時段提醒**：若於上述時段以外（週五、週末、國定假日或下班時間）欲合併至 `main`： - AI 助手**必須攔截並主動提示風險**（例如：週末災難風險）。 - 必須取得使用者明確書面同意（如：「我確定現在要上線」）方可執行。 -3. **合併鏈路**：一般功能/修正必須先上 `demo` 測試。`main` 的程式原則上應從 `demo` 分支合併而來。 +4. **合併鏈路**：一般功能/修正必須先上 `demo` 測試。`main` 的程式原則上應從 `demo` 分支合併而來。 ## 3. 開發與修復流程 (SOP) diff --git a/.agents/workflows/now-push.md b/.agents/workflows/now-push.md index 3fe9709..3b36c3f 100644 --- a/.agents/workflows/now-push.md +++ b/.agents/workflows/now-push.md @@ -8,28 +8,20 @@ description: 將目前的變更提交並推送至指定的遠端分支 (遵守 ## 執行步驟 -1. **檢查變更內容** - 執行 `git status` 與 `git diff` 檢查目前的工作目錄，確保提交內容正確。 +1. **讀取規範 (Mandatory)** + 在執行任何 Git 操作前，**必須** 先讀取 Git 分支管理與開發規範： + `view_file` -> [Git SKILL.md](file:///home/mama/projects/star-erp/.agents/skills/git-workflows/SKILL.md) -2. **撰寫規格化提交訊息 (Commit Message)** - - 訊息一律使用 **繁體中文 (台灣用語)**。 - - 必須使用以下前綴之一： - - `[FIX]`：修復 Bug。 - - `[FEAT]`：新增功能。 - - `[DOCS]`：文件更新。 - - `[STYLE]`：UI/樣式/格式調整。 - - `[REFACTOR]`：程式碼重構。 - - 描述應具體且真實反映修改內容。 +2. **檢查與準備** + - 執行 `git status` 檢查目前工作目錄。 + - 根據 **SKILL.md** 的規範撰寫繁體中文提交訊息。 -3. **目標分支安全檢查 (Release Window & Source Check)** - - 若使用者指定的目標分支包含 **`main`**： - - **來源檢查**：根據規範，上線 `main` 前必須先確保程式碼已在 `demo` 分支驗證完畢。我會優先檢查 `demo` 與 `main` 的差異，並提醒使用者應從 `demo` 合併。 - - **檢查目前時間**：標準發布時段為 **週一至週四 12:00 (中午) 之前**。 - - 若在非標準時段（週五、週末、下班時間），**必須** 先攔截並主動提醒風險，取得使用者明確書面同意（例如：「我確定現在要上線」）後方才執行推送。 +3. **目標分支安全檢查** + - 嚴格遵守 **SKILL.md** 中的「分支架構」、「發布時段」與「強制分支明確指定」規則。 + - 若未指明目標分支，主動詢問使用者，不可私自預設為 `main`。 4. **執行推送 (Push)** - - 依據指令帶入的分支名稱執行推送。 - - 範例：`git push origin [目前分支]:[目標分支]`。 + - 通過安全檢查後，執行：`git push origin [目前分支]:[目標分支]`。 -5. **同步關聯分支** - - 若為 `main` 的 Hotfix，修復後應評估是否同步回 `demo` 或 `dev` 分支。 \ No newline at end of file +5. **後續同步** + - 依照 **SKILL.md** 的「緊急修復流程(Hotfix)」評估是否需要同步回 `demo` 或 `dev` 分支。 \ No newline at end of file