SuperAPI AI 工具集

custom-skills-git-commit

编程与开发

查看项目

更新于 10-16 04:41

技能介绍

Git Commit Custom Skill 是一組 Git 提交工作流的模組化功能,主要供 git-commit 指令調用。依資料所述,此技能不應直接使用,而是在調用時根據路由邏輯讀取對應的模組檔案。

用途 此技能用於將 Git 提交相關流程拆分為多個模組,涵蓋同步、分析、提交、推送、合併與 PR 建立等環節,並透過路由決定實際執行哪些模組。

主要能力(模組清單)

  • 共用工具 _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,取得主分支名稱判斷與共用函式。

路由邏輯:

  • 若為 pr 子指令,讀取並執行 pr.md(內部調用 pr-analyze.md),結束。
  • 若為 merge 子指令,讀取並執行 merge.md,結束。
  • 若當前分支為主分支(main/master):使用 --direct 時跳過同步,直接執行分析與提交;否則發出警告「⚠️ 目前在主分支上,建議切換至開發分支。若要直接提交,請使用 --direct 參數。」並中止流程。
  • 若為開發分支:1. 讀取並執行 sync.md 進行環境同步;2. 讀取並執行 analyze.md 進行變更分析;3. 讀取並執行 commit.md 執行提交;4. 若帶 --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. 若帶 --push,讀取並執行 push.md 推送至遠端。

角色定義 執行此 Skill 時,扮演資深的 DevOps 工程師與代碼審查專家,根據使用者指定的參數執行對應的提交流程。

適用場景 適用於需要以 git-commit 指令執行提交、推送、合併、建立 PR 等 Git 工作流的開發情境,並透過模組化與路由控制不同分支與參數下的行為。

限制 此技能由 git-commit 指令調用,不應直接使用。其餘關於支援平台、安裝方式、收費、價格、效果等資訊,資料暫未提供。