Conventional Commits
一种轻量级的Git提交信息规范,通过结构化前缀(feat/fix/docs等)传递变更语义,与语义化版本控制(SemVer)紧密结合,是现代开源生态中管理API兼容性的主流实践
核心事实
时间轴 (近 90 天)
Conventional Commits 是一套提交信息格式约定,形如 'feat(api): add bulk import endpoint' 或 'fix: stop dropping empty rows',前缀声明改动类型,可选作用域括号标注模块,冒号后是描述。
relnotes 提供离线回退路径:在没有模型可用时(--offline),基于 Conventional Commits 驱动分组生成 changelog,结构与模型输出保持一致。
在规格驱动开发中,代理使用Conventional Commits意味着每条提交都携带语义信息,便于人类审核和追溯规则变更。
当发布流程完全自动化后,版本号的分配通常由提交信息(如 Conventional Commits 规范中的 fix、feat、BREAKING CHANGE 前缀)自动推导。
Conventional Commits 规范中,破坏性变更需在类型后紧跟感叹号(如 feat!)或在正文添加 BREAKING CHANGE: 脚注
AI工具在符合Conventional Commits规范的commit message末尾追加非标准内容,可能导致自动化工具解析失败或产生错误输出
Angular、Vue.js等知名开源项目强制使用Conventional Commits规范
Conventional Commits规范的核心结构为type(scope): description,其中type表示变更类型如feat、fix、refactor
Conventional Commits格式为type(scope): description,Angular框架本身是Conventional Commits的早期推动者之一
全部知识事实 (13)
Conventional Commits的核心格式为<type>[optional scope]: <description>
65%待验证Conventional Commits(约定式提交)规范最初由Angular团队提出,后经社区标准化
85%待验证Conventional Commits规范由Angular项目率先大规模推广
85%待验证Conventional Commits已成为开源社区的事实标准提交规范
60%待验证Conventional Commits 是一套提交信息格式约定,形如 'feat(api): add bulk import endpoint' 或 'fix: stop dropping empty rows',前缀声明改动类型,可选作用域括号标注模块,冒号后是描述。
50%待验证relnotes 提供离线回退路径:在没有模型可用时(--offline),基于 Conventional Commits 驱动分组生成 changelog,结构与模型输出保持一致。
50%待验证在规格驱动开发中,代理使用Conventional Commits意味着每条提交都携带语义信息,便于人类审核和追溯规则变更。
50%待验证当发布流程完全自动化后,版本号的分配通常由提交信息(如 Conventional Commits 规范中的 fix、feat、BREAKING CHANGE 前缀)自动推导。
50%待验证Conventional Commits 规范中,破坏性变更需在类型后紧跟感叹号(如 feat!)或在正文添加 BREAKING CHANGE: 脚注
50%待验证Angular、Vue.js等知名开源项目强制使用Conventional Commits规范
50%待验证AI工具在符合Conventional Commits规范的commit message末尾追加非标准内容,可能导致自动化工具解析失败或产生错误输出
50%待验证Conventional Commits规范的核心结构为type(scope): description,其中type表示变更类型如feat、fix、refactor
50%待验证Conventional Commits格式为type(scope): description,Angular框架本身是Conventional Commits的早期推动者之一
50%