适用于 Openclaw 的 Git 提交信息助手

根据暂存的 Git 差异摘要生成简洁的规范提交主题、可选正文和备选方案。

hmahmadcs
v1.0.2
2026年10月17日
0
115
0

安装与下载

1. ClawHub CLI

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

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

2. 手动安装

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

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

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

3. 提示词安装

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

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

更倾向于下载?

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

什么是 Git 提交信息助手?

Git 提交信息助手是一个 Openclaw Skills 工作流,可将暂存的变更摘要转换为清晰、一致的规范提交信息。它会识别合适的提交类型,例如 feat、fix、docs、refactor、test 或 chore,并生成不超过 72 个字符的祈使句主题。

此技能专为希望快速获得提交信息建议、但不授予提交或推送权限的开发者设计。它可以根据用户提供的差异或统计信息工作;用户批准后,也可以选择运行只读 Git 命令。

Git 提交信息助手 应用场景

  • 使用 git add 暂存变更后撰写提交信息。
  • 将暂存区差异摘要转换为规范提交主题。
  • 为功能、修复、文档更新、重构、测试或维护变更选择合适的提交类型。
  • 获取一条推荐信息和两条简洁的备选方案。
  • 在保持只读、无网络工作流的同时,统一提交措辞。
  • 没有可用的变更摘要时,要求提供所需的差异或统计信息。

Git 提交信息助手 工作原理

  1. 检测用户是否在请求提交信息,通常发生在变更暂存之后。
  2. 检查是否有用户提供的差异或摘要。如果没有,请用户粘贴一份,或运行缓存差异统计命令。
  3. 查看变更上下文,并选择一种规范提交类型:feat、fix、docs、refactor、test 或 chore。
  4. 撰写一条使用祈使语气、不超过 72 个字符且末尾不带句号的主要主题。
  5. 在有助于提供额外上下文时,可选地添加简洁正文。
  6. 除主要建议外,再提供两条简短的备选信息。
  7. 生成建议后即停止;此技能不会提交、推送、访问网络或修改仓库状态。

Git 提交信息助手 配置指南

此技能未指定单独的软件包安装或配置命令。在 Openclaw Skills 环境中启用 Git 提交信息助手;如有需要,再暂存相关变更。

如果尚无摘要,用户可以批准运行以下只读命令:

git diff --cached --stat

唯一声明的可执行依赖项是 git;如果用户直接提供差异或统计信息,则无需使用它。此技能不需要网络访问,也不会执行提交或推送。

Git 提交信息助手 数据架构与分类体系

此技能使用精简的输入与输出结构,而不生成仓库文件。

元素 格式或规则
输入 用户提供的暂存差异摘要、差异或缓存的 Git 统计信息
可选命令 git diff --cached --stat
提交类型 feat、fix、docs、refactor、test 或 chore
主题 祈使语气,最多 72 个字符,末尾不带句号
范围 根据变更推断的可选规范提交范围,例如 auth
正文 有帮助时添加的可选说明文字
建议 一条主要信息和两条简短备选方案
生成的文件 无;此技能只返回信息建议
仓库变更 无;不会提交、推送或修改文件

分类示例:fix(auth): handle empty password field 中,fix 是类型,auth 是范围,祈使句主题描述了变更。

Git 提交信息助手 高级特性

  • 在功能、错误修复、文档、重构、测试和维护变更之间选择规范提交类型。
  • 可根据暂存变更上下文推断可选范围。
  • 提供三个选项:一条主要建议和两条备选方案。
  • 可选提交正文,用于补充实现背景。
  • 通过经批准的缓存统计命令进行只读 Git 检查。
  • 无网络运行,不具备提交、推送或修改文件的能力。
  • 遵循权限要求;缺少必要上下文时会请求提供差异或统计信息。

SKILL.md


加载中

Openclaw 相关技能

METADATA

Github Stars: 0
forks: 0

精选*