custom-skills-git-commit

Git Commit Custom Skill

此 Skill 提供 Git 提交工作流的模組化功能，供 git-commit 指令調用。

---

模組清單

模組	檔案	說明
共用工具	_utils.md	主分支判斷（main/master）、衝突處理、提交規範
同步	sync.md	Stash、Rebase/Merge、Stash Pop
分析	analyze.md	定義基準點、檢查變更
提交	commit.md	Normal/Final 模式提交
推送	push.md	推送至遠端、處理分叉
合併	merge.md	多分支整合測試
PR	pr.md	建立 Pull Request 流程
PR 分析	pr-analyze.md	PR 專用的變更分析與摘要生成

---

使用方式

此 Skill 由 git-commit 指令調用，不應直接使用。

調用時，根據路由邏輯讀取對應的模組檔案：

前置準備（必須）

1. 讀取 _utils.md：取得主分支名稱判斷與共用函式

路由邏輯

IF pr 子指令:
    → 讀取並執行 `pr.md`（內部調用 `pr-analyze.md`）
    → 結束

IF merge 子指令:
    → 讀取並執行 `merge.md`
    → 結束

IF 當前分支為主分支 (main/master):
    IF --direct:
        → 跳過同步，直接執行分析與提交
    ELSE:
        → 警告：「⚠️ 目前在主分支上，建議切換至開發分支。若要直接提交，請使用 --direct 參數。」
        → 中止流程

ELSE (開發分支):
    1. 讀取並執行 `sync.md`   — 環境同步
    2. 讀取並執行 `analyze.md` — 變更分析
    3. 讀取並執行 `commit.md`  — 執行提交
    4. IF --push:
        → 讀取並執行 `push.md` — 推送至遠端

pr 模式路由

當使用 git-commit pr 時：

1. 讀取 `_utils.md`      — 取得主分支名稱
2. 讀取並執行 `pr.md`    — PR 主流程
   ├─ 前置檢查（分支、gh CLI）
   ├─ 範圍判定
   ├─ 讀取並執行 `pr-analyze.md` — 變更分析與摘要生成
   ├─ ⚠️ 檢查現有 PR（必須在 squash 前執行）
   │   ├─ 若 MERGED/CLOSED → 繼續建立新 PR
   │   └─ 若 OPEN → 詢問使用者：更新現有 PR / 建立新分支+新 PR / 中止
   ├─ 提交整理（除非 --no-squash）
   ├─ 推送
   └─ 建立 PR（預設草稿，--direct 為正式）

⚠️ 重要：PR 檢查必須在 squash 之前執行。 若分支已有 OPEN 的 PR，squash 會覆蓋該 PR 的所有提交。 未經使用者確認就執行 squash 可能導致不可逆的問題。

--direct 模式路由

當使用 --direct 在主分支提交時：

1. 讀取並執行 `analyze.md` — 變更分析
2. 讀取並執行 `commit.md`  — 執行提交
3. IF --push:
    → 讀取並執行 `push.md` — 推送至遠端

---

角色定義

執行此 Skill 時，你是一個資深的 DevOps 工程師與代碼審查專家。根據使用者指定的參數，執行對應的提交流程。