一款智能工具，可在数秒内将 git diff 或文字描述转换为标准化的约定式提交消息。
安装与下载
1. ClawHub CLI
从源直接安装技能的最快方式。
npx clawhub@latest install git-commit-formatter
2. 手动安装
将技能文件夹复制到以下位置之一
~/.openclaw/skills/ <project>/skills/ 优先级：工作区 > 本地 > 内置
3. 提示词安装
将此提示词复制到 OpenClaw 即可自动安装。
请帮我使用 Clawhub 安装 git-commit-formatter。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
更倾向于下载？
获取包含原生技能文件的ZIP压缩包。
什么是 Git 提交格式化工具？
Git 提交格式化工具是一款专为自动化创建高质量、标准化提交消息而设计的专业工具。它严格遵守 Conventional Commits v1.0.0 规范，确保您的项目历史保持整洁、专业且易于导航。该工具是 Openclaw Skills 生态系统的核心组件，帮助开发人员在团队范围的版本控制工作流中保持 100% 的一致性。
无论您是处理复杂的代码更改还是简单的文档更新，此技能都会分析您的工作上下文，以建议最合适的类型、范围和主题行。它消除了与手动格式化相关的猜测和精神疲劳，让您能够专注于技术实现，而由智能体处理您的进度记录。
Git 提交格式化工具 应用场景
- 在快速开发周期中将原始 git diff 输出转换为格式化的提交消息。
- 标准化开源项目的提交历史，以实现自动生成变更日志。
- 通过为消息结构提供单一的事实来源，解决团队提交风格不一致的问题。
- 使用清晰的祈使语气描述记录重大变更（Breaking Changes）和多模块重构。
Git 提交格式化工具 工作原理
- 用户提供输入，可以是原始 Git diff 输出，也可以是对更改的手动文字描述。
- 技能解析输入以提取关键信息，如修改的文件、添加的逻辑或删除的行。
- 根据关键字逻辑和更改模式确定正确的提交类型（feat, fix, docs, style, refactor, test 或 chore）。
- 如果更改局限于特定的模块或文件路径，则识别可选的范围（kebab-case 格式）。
- 使用祈使语气生成简洁的主题行，确保字数在 50 个字符以内。
- 对于复杂的更改，构建一个每行限制为 72 个字符的正文，以解释修改背后的“原因”。
- 最终消息在呈现给用户之前会根据严格的检查清单进行验证。
Git 提交格式化工具 配置指南
要将此工具集成到您的 Openclaw Skills 工作流中，请确保该技能在您的工作区配置中处于激活状态。
# 验证技能是否存在于您的技能目录中
ls /data/workspace/skills/git-commit-formatter
# 要在没有手动提示的情况下启用自动激活，请更新您的白名单
nano /data/workspace/whitelist.yml
将 git-commit-formatter 添加到 YAML 文件中的 skills_allowed_auto_add 列表，以简化您的开发过程。
Git 提交格式化工具 数据架构与分类体系
该技能基于以下分类组织提交元数据，以确保与标准 git 解析器的兼容性：
| 组件 | 必要性 | 验证规则 |
|---|---|---|
| 类型 | 强制 | 必须是以下之一：feat, fix, docs, style, refactor, test, chore |
| 范围 | 可选 | 必须为小写并使用 kebab-case 格式 |
| 主题 | 强制 | 最多 50 个字符，祈使语气，末尾不加句号 |
| 正文 | 可选 | 主题后留空行，每行最多 72 个字符 |
| 页脚 | 可选 | 用于 BREAKING CHANGE 标签或引用 Issue/PR 编号 |
Git 提交格式化工具 高级特性
- 智能输入解析：自动区分 Git diff 代码块和自然语言描述。
- 白名单自动集成：支持通过系统白名单进行无缝网关部署，实现零摩擦配置。
- 重大变更检测：识别高影响力的修改并自动构建 BREAKING CHANGE 页脚。
- 多逻辑更改处理：提供将超大提交拆分为多个逻辑单元的建议，以便更好地进行代码审查。
- 终端优化格式：确保所有生成的文本遵守 72 字符宽度限制，以便在 CLI 环境中完美渲染。
SKILL.md
加载中
Openclaw 相关技能
精选*
