用途:为 git 生成符合 Conventional Commits 1.0.0 规范的提交信息。工作流程:先运行 git status 和 git diff HEAD 分析改动,然后只暂存用户指定的文件,或使用 git add -A 暂存全部,最后用 HEREDOC 格式提交:git commit -m "$(cat <<'EOF' <type>(<scope>): <description> EOF )"。输出格式为 <hash> <subject>。
格式规范:<type>[scope][!]: <description>。类型包括 feat、fix、perf、refactor、style、test、docs、build、ci、revert、chore。主题使用祈使语气(如 Add 而非 Added),首字母大写,结尾不加句号,约 50 字符(最多 72)。scope 为可选名词,表示受影响范围(如 auth、api、parser)。破坏性变更在冒号前加感叹号,例如 feat(api)!: Remove deprecated endpoints。关联 issue 使用 footer:Closes #123 或 Fixes #456。非平凡改动需写正文,说明是什么和为什么而非如何,每行不超过 72 字符。
限制:不得修改代码;除用户要求外不得推送;未经请求不得执行 amend。其余细节暂未提供。