mcpField
G
git-commit

git-commit

github.com/tisfeng开发052 次安装6 天前更新
代码仓库

关于 git-commit

为 Agent 提供安全的 Git 本地提交流程，涵盖范围判断、预览、暂存和提交校验。可按只读、确认或授权自动提交模式运行，并避免 push、rebase 和 merge。

主要功能

  1. 01按授权范围检查变更
  2. 02预览并校验提交消息
  3. 03限制暂存范围并复核差异
  4. 04提交后核对消息与统计
  5. 05支持只读汇报既有提交

适用场景

  1. 01根据已暂存内容起草提交
  2. 02获准后提交限定路径的变更
  3. 03查询指定提交的消息和统计

安装

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

$npx skills add https://github.com/tisfeng/skills --skill git-commit

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

包含的文件

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

agents/
openai.yaml
references/
branch-naming.md
commit-message.md
post-commit-report-example.md
reporting.md
scripts/
branch_name.py
commit-change-stats.py
validate-commit-message.py
tests/
test_branch_name.py
test_commit_change_stats.py
test_validate_commit_message.py

详细介绍

来自项目 README

Git 提交流程

以经范围校验的 staged diff 创建本地提交。只读预览可使用尚未暂存的候选， 但必须标为草稿。<git-commit-skill-dir> 指实际加载的本 Skill 目录。

任务与边界

任务结果
起草或预览根据 staged 内容或获准候选返回草稿，不改变 Git。
创建提交在有效提交授权下完成范围判断、预览、暂存、提交和校验。
汇报已有提交读取指定提交或范围的真实消息与统计，不启动新提交。
为组合 Skill 推导分支名只返回合法候选，不暂存、提交或创建分支。

本 Skill 不运行 git push、rebase 或 merge。调用方传入真实任务、允许范围和已有证据， 不需要采用本 Skill 的内部字段。

选择模式

  • 只命名或汇报已有提交：只完成该任务；未指定提交对象时先明确对象。
  • 仅预览、起草或只读：不暂存、不创建消息文件、不提交。已有 staged 内容时 只用其起草；索引为空时使用获准范围内的候选。
  • 确认模式：展示完整预览并等待批准。未单独获准时，确认前不暂存。
  • 默认模式：明确调用本 Skill 或宿主已授权自动本地提交时，展示预览后直接提交。

用户的禁止、范围、确认和暂缓要求持续有效；“不提交”不自动授权暂存。

范围与 Git 状态保护

  1. 记录调用目录，使用 git rev-parse --show-toplevel 定位仓库根目录；相对路径先按原调用目录解析。
  2. 读取 HEAD、分支、status、最近提交、staged/unstaged raw diff 和相关 untracked 内容， 区分用户已有变更与本任务候选。
  3. 准备写入时复验 HEAD、索引、候选路径和内容。发现冲突、归属不明或非预期漂移时 停止，不覆盖、清理或自动 amend。
  4. 获准后只执行一次选定的暂存动作，并比较 staged paths 与 raw patch 是否与候选完全一致。 不一致时停止，不通过第二次 git add 修正范围；不创建空提交。
情况暂存动作
已有索引不运行 git add，只提交既有 staged 内容；超出请求范围时停止。
显式交付、空索引、限定路径一次 git add -- <selected-paths>。
显式交付、空索引、未限定路径未禁止暂存且非 staged-only 时，在仓库根目录一次 git add .。
宿主授权自动提交一次 git add -- <expected-commit-paths>，禁止 git add .。

宿主自动提交还必须有首次写入前的 HEAD、初始 Git 状态、允许路径和内容归属证据。 初始索引非空、唯一暂存前出现非 Agent staged 内容、验证失败或仍有暂缓要求时， 停止自动提交。这不反向限制用户已明确授权的 staged-only 提交。

提交主流程

  1. 起草提交时读取 提交信息契约。在主对话以 text 代码围栏展示 完整、将要使用的消息；仅预览到此结束，确认模式等待批准。
  2. 完成唯一暂存并复验后，将与预览完全一致的内容写入本任务专用消息文件。 候选或消息变化时重新审核和展示；用户要求确认时不复用旧批准。
  3. 使用 Skill 内校验器检查消息，再运行 git commit -F <message-file>。
  4. 以新建完整 commit hash 执行提交后消息一致性校验。校验失败时保留消息文件， 不 amend，不声称交付完成。
  5. 校验通过后删除本任务消息文件，读取 统计与提交回执，根据 Git 真实结果交付。

任何技能或 Agent 需要拟定、分类或校验分支名称时，读取 统一分支命名 并使用其中工具，不进入提交流程。

完成与停止条件

只有范围与 staged raw patch 一致、必要验证通过、Git 真实消息与预览一致，且最终 状态和统计已核对时，才算创建提交完成。范围无法证明、出现冲突或漂移、权限被拒、 提交前/后校验失败、hook 改写结果或统计不一致时保留现场并报告具体阶段， 不自动扩大暂存、重试写入、amend 或清理用户状态。

评论

支持 Markdown