用途:帮助用户按 Conventional Commits 规范提交当前已暂存(indexed)的 git 文件,并提供提交信息最佳实践。
主要能力:提交前运行 git status 与 git diff --cached 检查暂存内容,若无暂存则停止,不创建空提交。支持格式 <type>[optional scope]: <subject>,可选正文与脚注;类型含 feat、fix、docs、style、refactor、perf、test、build、ci、chore、revert。scope 可选,推荐小写 kebab-case;主题用祈使语气、首字母小写、不加句号、建议 50 字符以内、硬限制 72。正文说明 what 与 why,每行 72 字符换行。脚注支持 BREAKING CHANGE、Refs/Closes、Co-authored-by、Signed-off-by。
使用方式:先分析暂存 diff,判断是否含多个不相关变更并建议拆分与提交顺序;再确定类型与 scope,编写主题与正文,展示信息待用户确认后执行。执行用 git commit -m,多行消息用 HEREDOC;不使用 --no-verify,不用 --amend(除非用户明确要求);钩子失败需排查后重新提交。fixup 场景用 git commit --fixup <target-sha>,必要时执行 GIT_SEQUENCE_EDITOR=true git rebase --autosquash $(git merge-base HEAD origin/main)。
限制:仅处理已暂存文件;不创建空提交;提交前需用户批准;不提交密钥等敏感文件;不擅自改写共享历史。具体平台、收费与价格资料暂未提供。