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 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/commit-tidy-x/raw/index.md(查看排版版本)