用途:为 git 提交提供统一的信息格式,使 git log 可读,并让工具解析提交以生成 CHANGELOG.md、映射语义化版本(feat → MINOR,breaking → MAJOR)以及由 CI/CD 触发自动发布。
主要能力:提供类型速查表(feat、fix、docs、style、refactor、perf、test、build、ci、chore、revert)及对应版本变更;规定格式 <type>[optional scope]: <description>,可带可选正文和脚注;支持用 ! 或 BREAKING CHANGE: 脚注标记破坏性变更;规定 AI 代理须在脚注披露协助,格式为 Assisted-by: [Model Name] via [Tool Name]。
使用方式:提交时描述用祈使语气、小写、不加句末句号;正文与主题间空一行,正文按 72 字符换行;脚注用于破坏性变更、问题引用(Closes: #123 等)和 AI 归属;提交必须使用 --signoff 标志,例如 git commit --signoff -m "feat: add user authentication"。提交前按清单自检类型、语气、大小写、破坏性变更标记、AI 归属和正文原因说明。
适用场景:任何使用 git 进行版本控制的团队或项目,尤其适合需要自动化生成变更日志、语义化版本管理和基于提交类型触发发布的 CI/CD 流程。
限制:首次来源未提供具体工具的开箱安装步骤或强制校验工具配置;规范本身为约定,需团队自行遵循或借助外部工具解析;本文不改变任何代码内容。