star-erp/.agents/workflows/now-push.md

description

description
將目前的變更提交並推送至指定的遠端分支 (遵守專案規範)

快速推送工作流 (now-push)

本工作流旨在規範化 Git 提交與推送流程，確保符合專案的開發規範 (繁體中文、規範前綴) 與發布紀律 (Release Window)。

執行步驟

1. 讀取規範 (Mandatory) 在執行任何 Git 操作前，必須 先讀取 Git 分支管理與開發規範： view_file -> Git SKILL.md

2. 檢查與準備

   • 執行 git status 檢查目前工作目錄。
   • 根據 SKILL.md 的規範撰寫繁體中文提交訊息。

3. 目標分支安全檢查

   • 嚴格遵守 SKILL.md 中的「分支架構」、「發布時段」與「強制分支明確指定」規則。
   • 若未指明目標分支，主動詢問使用者，不可私自預設為 main。
   • 【最嚴格限制】：main 分支的程式碼只能, 必須從 demo 分支合併而來。絕對禁止將 dev (或 feature/*) 直接合併進 main。

4. 執行推送 (Push) 與嚴格合併鏈路

   • 若目標為 dev：直接 git push origin [目前分支]:dev 或 commit 後 merge 到 dev。
   • 若目標為 demo：必須先確保變更已在 dev 且無衝突，然後 git checkout demo && git merge dev && git push origin demo。
   • 若目標為 main： 必須確保變更已經依照順序通過前置環境，嚴格執行以下流程（缺一不可）：
     1. git checkout dev && git merge [目前分支] && git push origin dev
     2. git checkout demo && git merge dev && git push origin demo
     3. git checkout main && git merge demo && git push origin main (就算遭遇衝突，也必須在對應的分支上解衝突，絕對不可略過 demo 直接 dev -> main)

5. 後續同步 (針對 Hotfix)

   • 依照 SKILL.md 的「緊急修復流程(Hotfix)」：若有從 main 開出來的 hotfix 分支直接併回 main 的例外情況（需使用者明確指示），必須同步將 main 分支 merge 回 demo 與 dev 分支，維持全環境版本一致。