**参考文献（存档）：** [SCAFFOLD_SKILLS_ARCHIVE_MAP.md]() — 受 claude-flow v3 git-commit 启发的提交验证逻辑钩子，一切克劳德代码 commitlint。 ### 第 1 步：验证提交消息根据常规提交格式验证提交消息字符串： **格式** : `<类型>(<范围>): <主题>` **类型**： * `feat`：一个新功能 * `fix`：错误修复 * `docs`：仅更改文档 * `style`：代码风格改变（格式等） * `refactor`: 代码重构 * `perf`：性能改进 * `test`：添加或更新测试 * `chore`：维护任务 * `ci`：CI/CD 更改 * `build`：构建系统更改 * `revert`: 恢复之前的提交 **验证规则**： 1.必须以type开头（必填） 2. 范围是可选的（括号内） 3. 主题为必填项（冒号和空格后） 4. 使用祈使句、现在时（“添加”而不是“添加”） 5、首字母不要大写 6. 末尾没有句号 7. 可以包含正文和页脚（以空行分隔）使用此正则表达式模式进行验证：常量 CONVENTIONAL_COMMIT_REGEX = /^(feat|fix|docs|style|refactor|perf|test|chore|ci|build|revert)($.+$)?: .{1,72}/; 函数 validateCommitMessage(消息) { constlines = message.trim().split('\n'); const header =lines[0]; // 检查格式 if (!CONVENTIONAL_COMMIT_REGEX.test(标题)) { 返回{ 有效：假，错误：“提交消息不遵循常规提交格式”， }; } // 检查长度 if (header.length > 72) { 返回{ 有效：假，错误：“提交标头超过 72 个字符”， }; } 返回 { 有效: true }; } **有效示例**： feat(auth)：添加 OAuth2 登录支持修复（api）：解决用户端点中的超时问题文档（自述文件）：更新安装说明重构（组件）：提取通用按钮逻辑 test(utils)：添加日期格式的单元测试 **无效示例**：添加了新功能 # 缺少类型 feat:新功能 # 冒号后缺少空格 FEAT：添加功能 # 类型应为小写 feat: 新增功能 # 应使用祈使时态 **预提交挂钩** (`.git/hooks/pre-commit`)： #!/bin/bash commit_msg=$(git log -1 --pretty=%B) 如果！节点 .claude/tools/validate-commit.mjs "$commit_msg";然后 echo "提交消息验证失败" 1号出口菲 <代码示例> **CI/CD 集成**： # .github/workflows/validate-commits.yml - name: 验证提交消息运行： | git log origin/main..HEAD --pretty=%B | git log origin/main..HEAD --pretty=%B | git log origin/main..HEAD --pretty=%B |读取消息时；做节点.claude/tools/validate-commit.mjs“$msg”|| 1号出口完成返回结构化验证结果： { “有效”：真实， “类型”：“壮举”， “范围”：“验证”， "subject": "添加OAuth2登录支持", “警告”：[] } 或者对于无效消息： { “有效”：假， "error": "提交消息不遵循常规提交格式", “建议”：[ "使用格式：<类型>(<范围>):<主题>", “有效类型：feat、fix、docs、style、refactor、perf、test、chore、ci、build、revert” ] } # 验证提交消息 node .claude/tools/validate-commit.mjs "feat(auth): 实现 jwt 登录" # 从标准输入验证（例如在钩子中） echo“修复：变量名称不正确”|节点.claude/tools/validate-commit.mjs ## 铁律 1. **始终在预提交挂钩和 CI 中验证提交消息** — 预提交捕获本地违规； CI 捕获钩子被绕过或未安装的情况；两层都是必需的。 2. **永远不要接受没有类型前缀的提交消息** - 传统提交格式（`type: subject`）是基础；没有类型的消息无法解析变更日志生成和语义版本控制。 3. **始终强制主题行长度限制（72 个字符）** — 超过 72 个字符的主题将在 git log --oneline 和 GitHub PR 视图中被截断；简洁性是被强制执行的，而不仅仅是被鼓励的。 4. **永远不会因为正文/页脚格式问题而阻止提交** — 只有类型、主题和长度会被阻止；可选部分（正文、页脚、共同作者）应该发出警告，而不是阻止。 5. **始终在拒绝消息中提供正确的格式示例** - 没有示例的错误消息会导致开发人员猜测格式；在每次拒绝旁边显示“功能：添加用户身份验证”。 ## 反模式反模式|为什么失败 |正确的做法 ---|---|--- 仅在 CI 中验证（不是预提交）|开发人员直到推送后才发现格式问题 |添加预提交挂钩以获取本地即时反馈阻止正文/页脚格式 |过多的摩擦导致开发人员绕过钩子 |仅阻止缺少类型前缀和主题长度的情况无格式拒绝示例|开发人员必须猜测正确的格式 |始终在错误消息中显示传递的示例允许自由形式的主题而无需类型 |破坏变更日志生成和语义版本控制 |无条件要求“类型：主题”格式单行验证（无正文检查）|缺少共同作者和页脚未被发现 |配置时验证所需页脚是否存在 ## 内存协议（强制） **开始之前：**阅读 `.claude/context/memory/learnings.md` **完成后：** * 新模式 -> `.claude/context/memory/learnings.md` * 发现问题 -> `.claude/context/memory/issues.md` * 做出决定 -> `.claude/context/memory/decisions.md` > 假设中断：如果它不在内存中，则它没有发生。

提交验证器

包含技能