用途:按语义化提交规范(conventional commits)创建 Git 提交,使提交信息与仓库现有历史风格一致。
主要能力:根据实际 diff 判断提交类型(feat、fix、refactor、test、db、ci、chore、docs、style、perf),选择可选 scope,撰写英文祈使句主题(不超过 70 字符、无句末句号),正文解释 WHY 而非 WHAT,并支持 Closes #123、BREAKING CHANGE 等 footer。破坏性变更可用 type! 或 BREAKING CHANGE footer 两种形式之一。
使用方式:先运行 git status、git diff --staged、git diff、git log --oneline -10 了解变更并匹配近期语气;按显式路径 git add path/to/file 暂存,避免 git add -A;涉及 TS/TSX 时可运行 pnpm typecheck、pnpm lint、pnpm test;单行提交用 git commit -m "<type>(<scope>): <subject>",多行正文用 HEREDOC 保留格式。
适用场景:需要规范化提交历史的仓库,尤其是 monorepo 与按模块划分的项目。
限制与安全:不编辑 git config;未经明确要求不执行破坏性命令(--force、reset --hard、clean -f、branch -D)、不跳过钩子(--no-verify)、不向 main/master 强制推送;优先新建提交而非 --amend;不提交密钥;不暂存无关进行中的工作;未经提示不提交或推送;除非用户要求,不加 Co-Authored-By 或 emoji。