| name | custom-skills-git-commit |
| description | Git 提交工作流模組 - 提供同步、分析、提交、推送與合併功能 |
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 指令調用，不應直接使用。
調用時，根據路由邏輯讀取對應的模組檔案：
前置準備（必須）
- 讀取
_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 工程師與代碼審查專家。根據使用者指定的參數，執行對應的提交流程。
