适用于 Openclaw 的 Git Commit Message Generator

一个智能工具,通过分析暂存的 Git 变更,自动生成格式完美的 Conventional Commit 消息。

michaelatamuk
v1.0.0
2026年4月30日
0
744
0

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install git-commit-message-generator

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式
~/.openclaw/skills/
工作区
<project>/skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 git-commit-message-generator。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

更倾向于下载?

获取包含原生技能文件的ZIP压缩包。

什么是 Git Commit Message Generator?

Git Commit Message Generator 是一个专门设计的工具,旨在消除记录代码变更时的心理摩擦。通过与 Openclaw Skills 集成,它读取您的暂存 git diff 并解读代码背后的意图,从而生成严格遵守 Conventional Commits 规范的消息。这确保了您的项目历史保持专业、易读,并为自动化工具做好准备。

除了简单的文本生成,此技能还理解软件开发的细微差别。它可以区分 feat 和 refactor,识别变更的具体架构范围,甚至标记需要大版本更新的 breaking changes。它将繁琐的手动任务转化为开发工作流中无缝的一部分,促进更好的协作和更清晰的版本历史。

Git Commit Message Generator 应用场景

  • 使用 git add 暂存更改后,需要对工作进行即时、准确的描述。
  • 为自动化 changelog 生成维护整洁、机器可读的 git 历史记录。
  • 在无需手动执行的情况下,确保团队范围内提交格式的一致性。
  • 自动突出显示 API 或公共导出中的 breaking changes。
  • 记录影响跨越多个模块或组件的复杂重构。

Git Commit Message Generator 工作原理

  1. 该技能执行 git diff --staged 命令以获取修改后的确切代码行。
  2. 它分析文件路径和模式,以确定主要影响区域(例如 src/components/ 与 docs/)。
  3. 智能检测逻辑根据 diff 的内容分配变更类型,例如 feat、fix、docs 或 refactor。
  4. 它通过查看目录结构和组件名称来提取特定的 scope。
  5. 生成器检查 breaking changes,例如更改的函数签名或移除的导出。
  6. 使用常规格式构建最终消息,包括主题行、可选正文和页脚。
  7. 对输出的长度和祈使语气进行验证,以符合行业最佳实践。

Git Commit Message Generator 配置指南

要开始使用此技能,请确保系统中已安装 git,并在 Openclaw Skills 环境中执行以下步骤:

# 导航到您的 git 仓库
cd your-project-repo

# 照常暂存您的更改
git add .

# 通过您的 AI agent 调用技能
"Generate a commit message for my staged changes"

Git Commit Message Generator 数据架构与分类体系

该技能根据 Git 内部状态和 Conventional Commits 分类法组织数据:

属性 描述 示例
Type 变更的性质 feat, fix, chore, build
Scope 特定的模块或文件区域 (ui), (auth), (api)
Subject 祈使语气的简明摘要 add validation to login form
Body “为什么”的详细解释 解释逻辑变更
Footers 元信息,如 breaking changes BREAKING CHANGE: ...

Git Commit Message Generator 高级特性

  • Breaking Change 检测: 当检测到 API 破坏性编辑时,自动在 type/scope 后附加 ! 或添加 BREAKING CHANGE 页脚。
  • Issue Tracker 集成: 自动解析分支名称(如 feature/PROJ-123),在提交页脚中包含 "Closes PROJ-123"。
  • Monorepo 支持: 智能识别工作区包,为多包仓库建议准确的 scope。
  • Co-author 支持: 通过要求技能在生成的提交消息中包含特定的联合作者,轻松添加署名。
  • 自定义风格适配: 根据要求支持在标准 Conventional Commits、Angular 风格或 Gitmoji 格式之间切换。

SKILL.md


加载中

Openclaw 相关技能

METADATA

Github Stars: 0
forks: 0

精选*