commit-tidy

智能分析提交历史,推荐拆分、压缩或规范化策略

安装使用

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

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

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

使用示例

‘请帮我分析当前暂存区的变更,将其中与数据库配置相关的修改单独拆分出来,并确保所有提交消息遵循 Conventional Commit 规范,同时扫描是否有密钥泄露。’ 它会调取 commit-tidy 的 hunk-split 功能识别出数据库配置部分,生成新的提交块,然后使用 message-discipline 生成规范消息,最后执行 security-scan 扫描暂存区,返回完整建议。

介绍

commit-tidy 是一个专注于 Git 提交治理的智能工具,帮助你分析暂存区或已提交的变更,并提供精准的拆分、压缩、消息改写建议。它集成了六大核心功能:非交互式 hunk 拆分(通过 git apply —cached 实现,适合无法使用 git add -p 的场景)、基于工作树的交互式修改与 rebase 循环、软重置后选择性重新提交、暂存区审计与敏感目录门禁、提交前密钥模式扫描(针对公开仓库的 4 种 grep 模式)、以及完整的提交消息规范(包括 Conventional Commit 标签、强制英文、操作类型连续性检测等)。

使用方式极为简单:在 Git 仓库中运行 commit-tidy,它会自动分析当前状态,然后以对话形式引导你选择操作,例如拆分一个过大的提交、压缩多个小提交、修正历史提交消息、或扫描是否存在密钥泄露。所有操作均基于安全的 Git 操作,不会破坏你的工作区。

适合所有需要精细化 Git 提交管理的开发者,尤其是后端开发、前端开发、运维工程师等在日常工作中频繁使用 Git 的群体。对于需要遵循严格提交规范(如 Conventional Commit)的团队,或者需要确保公开仓库不泄露敏感信息的项目,commit-tidy 能显著提升工作流效率和安全性。

建议在开发流程中作为常规钩子或 CI 环节使用,但由于其涉及修改提交历史,请确保在非共享分支上操作,或与团队成员充分沟通。对于完全依赖交互式 git add -p 的用户,非交互式 hunk 拆分功能提供了完美替代方案,但需注意它不支持交互式选择。

核心特点

与同类工具相比,commit-tidy 将提交拆分、压缩、消息规范、安全扫描、暂存区审计等六大功能整合为一个统一的对话式工具,无需在多个 CLI 命令或 GUI 工具之间切换,且所有操作均可通过 AI 助手自然语言驱动。

注意事项

不适合未使用 Git 的项目,也无法处理需要实时交互式选择(如 git add -p 的逐块确认)的场景。

常见问题

如何拆分一个过大的提交?

运行 commit-tidy 后,选择 hunk-split 模式,它会自动分析暂存区并建议如何将变更拆分为多个逻辑独立的提交,非交互式地通过 git apply --cached 完成。

如何压缩最近的几个提交?

使用 soft-reset-amend 功能,指定要压缩的提交数量 N,commit-tidy 会软重置到第 N 个提交之前,然后引导你重新选择性提交,并合并为一个新的提交。

给 AI 助手的安装指引

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

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