commit-tidy

智能分析提交并推荐拆分/压缩策略

安装使用

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

帮我安装这个 AI Skill:commit-tidy。
它的用途是:智能分析提交并推荐拆分/压缩策略
完整的 Skill 内容见:https://321skill.com/skills/commit-tidy-x/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

'帮我拆分当前git暂存区中的变更,将每个逻辑独立的修改单独提交,并生成符合Conventional Commit格式的提交消息。' 它会分析暂存区文件,识别出多个无关联的变更(如修复bug、添加文档、重构函数),然后通过git apply --cached逐块暂存,依次执行commit并自动添加合适的标签(如fix、docs、refactor)。

介绍

commit-tidy 是一个专注于 Git 提交管理的智能工具,帮助开发者分析暂存区或已提交的变更,并推荐最佳的拆分、压缩或提交消息策略。它解决了在非交互式环境(如 CI/CD 或远程终端)中无法使用 git add -p 进行逐块暂存的痛点,通过 git apply —cached 实现单块暂存,同时提供安全扫描、提交规范检查、消息格式校验等功能,确保每次提交都符合团队规范且无敏感信息泄露。

使用方式非常灵活:你可以直接对暂存区执行 git tidy 命令,它会自动分析变更,给出建议的拆分方案;也可以对已提交的 N 个提交执行 git tidy --interactive,进入工作区修改循环,支持软重置后选择性重新提交。此外,它还内置了安全扫描(PUBLIC 仓库的 4-grep 密钥模式检查)和提交纪律检查(如敏感目录门禁、Conventional Commit 标签、英文强制等),所有操作均通过命令行完成,适合自动化集成。

适合用户:全栈开发者、后端开发者、运维工程师,以及任何需要精细管理 Git 提交历史的团队。尤其适合在 CI/CD 流程中自动化提交质量门禁,或为开源项目贡献代码时确保提交符合规范。对于需要频繁调整提交历史、拆分或压缩提交的开发者,此工具能显著提升效率。

使用建议:建议首次使用时先在小仓库上测试,熟悉其工作流(如 hunk-split、interactive-amend 等)。注意它的安全扫描主要针对 PUBLIC 仓库,若在私有仓库中使用可将其关闭。另外,它对提交消息的英文强制和 Conventional Commit 标签要求可能不适合所有团队,可根据需要调整配置。

核心特点

commit-tidy 不仅是单一的提交拆分或压缩工具,而是集成了安全扫描、提交规范、交互式修改和门禁审计的综合性提交管理方案,特别支持非交互式逐块暂存和敏感目录控制,避免在 CI 环境中无法使用 git add -p 的尴尬。

注意事项

不适合需要图形化界面或大规模仓库的复杂合并操作,且对提交消息的强制英文和 Conventional Commit 标签可能不适用于非标准化团队。

常见问题

如何拆分当前暂存区中多个无关的修改?

运行 `git tidy` 或 `commit-tidy split`,工具会分析文件变更并建议按逻辑分组,你可以选择是否逐块暂存。

如何压缩最近几个提交为一个?

使用 `git tidy --squash HEAD~3` 将最近3个提交压缩为一个,并自动生成合并后的提交消息。

给 AI 助手的安装指引

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

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