用途:按 Conventional Commits 规范创建标准化、语义化的 Git 提交,通过分析实际 diff 确定合适的类型、范围与提交信息。
主要能力:支持标准提交格式 <type>[optional scope]: <description>,可附带 body 与 footer;覆盖 feat、fix、docs、style、refactor、perf、test、build、ci、chore、revert 等类型;支持破坏性变更标记,如类型或范围后加感叹号(feat!: remove deprecated endpoint),或使用 BREAKING CHANGE footer。
使用方式:先分析 diff,已暂存时用 git diff --staged,未暂存时用 git diff,并用 git status --porcelain 查看状态;需要时暂存文件,可用 git add path/to/file1 path/to/file2、git add .test.、git add src/components/* 或交互式 git add -p;随后生成提交信息并执行 git commit -m "<type>[scope]: <description>",多行信息可用 heredoc 形式提交。
适用场景:用户要求提交改动、创建 Git 提交或需要规范化提交信息时。
限制与安全:绝不提交密钥(.env、credentials.json、私钥);绝不更新 git 配置;未经明确要求不运行破坏性命令(--force、hard reset);除非用户要求,不跳过钩子(--no-verify);不向 main/master 强制推送;若因钩子导致提交失败,应修复后创建新提交而非 amend。最佳实践包括每次提交一个逻辑变更、使用现在时与祈使语气、描述控制在 72 字符内、引用 issue(Closes #123、Refs #456)。