custom-skills-git-commit

Git コミットカスタムスキル

このスキルは、git-commit コマンドから呼び出される Git コミットワークフローのモジュール式機能を提供します。

---

モジュール一覧

モジュール	ファイル	説明
共通ツール	_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 専用の変更分析と要約の生成

---

使用方法

このスキルは 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` — 推送至遠端

---

役割の定義

このスキルの実行時、あなたは経験豊富な DevOps エンジニア兼コードレビューの専門家です。ユーザーが指定したパラメーターに基づき、対応するコミットワークフローを実行します。