git-hex

为AI助手提供安全、非交互式的Git历史重构工具

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:git-hex。
它的用途是:为AI助手提供安全、非交互式的Git历史重构工具
完整的 Skill 内容见:https://321skill.com/skills/git-hex/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

‘请帮我将最近三个功能提交合并成一个清晰的提交,并重写提交信息。’,AI会调用git-hex的变基工具,安全地执行交互式变基操作,自动处理可能的冲突,并在完成后提供清晰的变更摘要。或者,当你发现上一个提交有个小错误时,可以说:‘修正上一个提交,加入我刚刚暂存的这个修复文件。’

介绍

git-hex 是一个基于 MCP(Model Context Protocol)的服务器,旨在解决开发者在进行Git历史重构(如变基、修正提交、合并提交)时面临的复杂性和风险问题。它将这些高风险操作封装成安全的、可预测的工具,让AI助手能够安全地执行,而无需开发者手动处理冲突或担心仓库状态损坏。

使用git-hex时,你只需通过支持MCP的AI客户端(如Claude Code)安装并连接该服务器。之后,你可以直接向AI助手下达诸如“将最近三次提交合并成一个”、“修正上一个提交中的拼写错误”或“将某个提交拣选到当前分支”等指令,AI会调用git-hex提供的安全工具自动完成,并在遇到冲突时自动中止并清理现场。

这个工具非常适合那些希望利用AI来优化代码提交历史、保持提交记录整洁,但又担心AI直接操作Git导致仓库损坏的开发者。无论是个人项目还是团队协作,它都能帮助维护一个清晰、线性的Git历史。

建议在使用前仔细阅读其安全文档,理解其“安全第一”的设计原则和备份机制。虽然它极大地降低了风险,但仍建议在重要操作前手动备份分支,并确保你的AI客户端配置了正确的路径权限(MCP roots)。

核心特点

与直接让AI执行Git命令不同,git-hex通过MCP协议提供了一套经过严格安全封装的专用工具,默认在冲突时自动中止并创建备份引用,确保仓库永远不会处于中断状态;同时,它严格遵循客户端的路径沙箱限制,所有操作都限定在允许的目录内。

注意事项

不适合需要复杂、交互式解决Git冲突的场景,也不适用于非MCP协议的AI助手或传统CLI环境。

常见问题

git-hex和直接让AI运行git命令有什么区别?

git-hex提供了安全封装、冲突自动处理、备份和路径沙箱,而直接运行git命令风险高,容易导致仓库损坏或状态中断。

它支持哪些AI客户端?

主要支持Claude Code等实现了MCP协议的客户端。具体配置请参考其文档中的客户端指南。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/git-hex/raw/index.md 读取 git-hex 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。