用途:在任何 git commit 命令执行前使用,确保提交信息遵循 Conventional Commits 规范。
格式:类型(范围): 描述,之后可接空行分隔的正文与页脚。类型包括 feat(新功能)、fix(修复)、docs(文档)、style(格式)、refactor(重构)、perf(性能)、test(测试)、build(构建/依赖)、ci(CI 配置)、chore(维护)、revert(回滚)。
规则:描述使用祈使语气,不以句号结尾,长度控制在 72 字符以内;正文用空行与主题分隔,用于说明意图、细节或背景,而非复述 diff。破坏性变更可在类型/范围后加 !,或在页脚写 BREAKING CHANGE:。范围可选,用于标明变更区域,如 api、ui、auth、db。
分支命名:新建分支时使用 类型/kebab-描述,类型与提交信息一致,例如 feat/add-user-auth、fix/broken-symlinks。例外:环境已指定分支(如 Claude 云沙箱的 claude/... 分支)时保留原名,不得重命名或另建分支。
身份、签名与署名:由环境配置(本地 gitconfig 或云沙箱 SessionStart 钩子)决定。提交信息只描述变更,不包含 Co-Authored-By、“Generated with”行、会话链接或模型名。由 git 从配置解析作者,提交时不加 --author 或 -c user.name=.../-c user.email=...。由配置解析签名,提交时不加 -S、--gpg-sign 或 --no-gpg-sign,签名相关配置保持不变。