用途:为 Sentry 项目创建符合约定的提交信息,避免直接提交代码。
提交前检查:先运行 git branch --show-current 查看当前分支。若处于 main 或 master,必须先创建特性分支(除非用户明确要求在 main 上提交),无需询问用户,直接使用 create-branch 技能创建;创建后再次用 git branch --show-current 验证分支已切换,若仍在 main/master 则停止提交。
格式:<type>(<scope>): <subject> 加正文和页脚,所有行不超过 100 字符。类型包括 feat、fix、ref、perf、docs、test、build、ci、chore、style、meta、license。主题行用祈使现在时、首字母大写、结尾不加句号、最长 70 字符。正文说明做了什么和为什么,而非如何做。页脚用 Fixes 或 Refs 引用 issue,如 Fixes GH-1234、Fixes #1234、Fixes SENTRY-1234、Refs LINEAR-ABC-123;Fixes 会在合并时关闭 issue,Refs 仅关联。AI 生成变更需在页脚添加 Co-Authored-By: Claude noreply@anthropic.com,且不在别处添加其他 AI 标记。破坏性变更用 feat(api)! 并在页脚写 BREAKING CHANGE。回滚用 revert 格式并说明原因。
原则:每次提交是单一稳定变更、可独立审查、提交后仓库处于可工作状态。