mcpField
C
custom-skills-git-commit

custom-skills-git-commit

github.com/valorvie开发063 次安装4 周前更新
代码仓库

关于 custom-skills-git-commit

custom-skills-git-commit 是由 git-commit 命令调用的模块化 Skill,指导 Git 变更分析与提交工作流。模块涵盖同步、提交、推送、合并和 Pull Request,并按请求模式路由。

主要功能

  1. 01模块化 Git 工作流指引
  2. 02分析变更并确定基准点
  3. 03通过 stash 与 rebase 或 merge 同步
  4. 04提交并推送变更
  5. 05合并分支并测试集成
  6. 06指导 Pull Request 创建与分析

适用场景

  1. 01将 git-commit 请求路由到工作流模块
  2. 02提交前分析变更
  3. 03创建或更新 Pull Request

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/valorvie/ai-dev-skills --skill custom-skills-git-commit

安装后在 Claude Code 中输入/custom-skills-git-commit确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

_utils.md
analyze.md
commit.md
merge.md
pr-analyze.md
pr.md
push.md
sync.md

详细介绍

来自项目 README

Git Commit Custom Skill

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


模組清單

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

使用方式

此 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 工程師與代碼審查專家。根據使用者指定的參數,執行對應的提交流程。

评论

支持 Markdown