commit-tidy

分析提交并推荐拆分/压缩/消息策略

安装使用

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

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

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

使用示例

'使用 commit-tidy 分析当前暂存区,并推荐是否需要拆分提交。' 它会自动运行 audit,输出每个变更块的分类建议,比如将配置文件和业务代码拆分,并生成对应的 git add 命令。如果你指定了 '--security-scan',它还会扫描暂存区中是否有疑似密钥的字符串,避免意外提交到 PUBLIC 仓库。

介绍

commit-tidy 是一个专为 Git 提交流程设计的智能辅助工具,帮助开发者分析和优化暂存区或已提交的变更。它提供六大核心功能:hunk-split(非交互式单块暂存,适用于 git add -p 不可用场景)、interactive-amend(基于工作树的 amend + rebase 循环)、soft-reset-amend(软重置顶部 N 次提交后选择性重新提交)、staging-discipline(通过 git diff —cached —name-only 审计暂存区,并检查敏感目录规则)、security-scan(在提交前扫描 PUBLIC 仓库中的密钥模式)、message-discipline(强制 Conventional Commit 标签、英文提交信息、操作类型连续性等)。

使用方式非常直接:在 Git 仓库中运行 commit-tidy 命令,它会自动分析当前暂存区或最近提交,给出针对性的操作建议。例如,当你发现一次提交内容过多时,它可以推荐如何拆分为多个逻辑提交;当多个提交可合并时,它推荐压缩策略;同时会检查提交信息是否符合规范,并扫描潜在的安全风险。所有操作均基于 Git 底层命令(如 git apply —cached、git rebase 等),确保安全可靠。

该工具特别适合后端开发、全栈开发以及运维工程师,尤其是在团队协作中需要统一提交规范、防止误提交敏感信息、或频繁进行提交调整的场景。对追求代码整洁和提交历史的开发者而言,它是高效管理 Git 提交历史的得力助手。

使用前建议先熟悉 Git 的基本操作和 Conventional Commit 规范。注意,interactive-amend 和 soft-reset-amend 会改写提交历史,在共享分支上使用需谨慎,推荐在个人分支或未推送的提交上操作。security-scan 仅扫描预设的密钥模式,无法覆盖所有安全风险,应结合其他工具加强防护。

核心特点

与同类工具相比,commit-tidy 不仅提供提交拆分/压缩建议,还集成了安全扫描、暂存区审计和提交信息强制规范,覆盖提交前、中、后全流程,且所有操作均非交互式,适合自动化脚本和 CI/CD 环境。

注意事项

不适合需要图形化交互或复杂分支合并的场景,改写历史操作在已推送的共享分支上可能造成冲突。

常见问题

如何用 commit-tidy 拆分一个包含多个逻辑变更的提交?

运行 commit-tidy 后选择 hunk-split 模式,它会分析暂存区中的每个块,推荐如何拆分,然后通过 git apply --cached 非交互式暂存指定块。

commit-tidy 可以检查提交信息是否符合 Conventional Commit 吗?

可以,message-discipline 功能会强制要求提交信息包含 Conventional Commit 标签(如 feat, fix 等),并检查是否为英文,同时确保操作类型连续。

给 AI 助手的安装指引

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

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