一种为 AI Agent 设计的保护性 Git 优先工作流技能，通过严格的工作前检查、多阶段验证和结构化提交确保仓库完整性。
安装与下载
1. ClawHub CLI
从源直接安装技能的最快方式。
npx clawhub@latest install git-commit-guard
2. 手动安装
将技能文件夹复制到以下位置之一
~/.openclaw/skills/ <project>/skills/ 优先级：工作区 > 本地 > 内置
3. 提示词安装
将此提示词复制到 OpenClaw 即可自动安装。
请帮我使用 Clawhub 安装 git-commit-guard。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
更倾向于下载？
获取包含原生技能文件的ZIP压缩包。
什么是 Git Commit Guard？
Git Commit Guard 是 Openclaw Skills 生态系统中的一个专门扩展，旨在为 AI 编程 Agent 强制执行规范的 Git 优先方法论。它防止了 AI Agent 覆盖未保存工作或用未经验证的更改污染仓库的常见陷阱。通过优先考虑工作树（worktree）健康，该技能确保每一项编码任务——从调试到功能实现——都从清晰了解当前仓库状态开始。
此技能对于在多语言环境中工作的开发人员或偏好高上下文版本历史记录的人员特别有价值。它要求 Agent 检查脏工作树（dirty worktrees），从本地环境推断正确的验证命令，并使用详细的中文提交消息记录所有更改。这种方法在保持高质量、可审计的项目历史的同时，最大限度地降低了回归或代码丢失的风险。
Git Commit Guard 应用场景
- 在 AI Agent 开始新开发任务之前，通过检查现有更改来管理脏工作树（dirty worktrees）。
- 在任何代码提交到仓库之前，强制执行严格的测试和 linting 标准。
- 使用解释实现背后“原因”的高细节中文提交消息来标准化项目历史。
- 通过防止破坏性的 Git 命令或静默覆盖来保护现有的用户工作。
- 在 AI 会话结束时提供一个经过完全验证和提交的清洁移交状态。
Git Commit Guard 工作原理
- Agent 在轮次开始时执行
git status以确定仓库是清洁的还是脏的。 - 如果是脏的，Agent 使用
git diff和文件读取进行深入研究，以总结现有更改和意图。 - 该技能识别仓库中现有的测试套件、linters 或构建工具，以建立验证基准。
- 在新工作开始之前，提交现有的故意更改，以确保为下一个逻辑阶段提供清洁的基础。
- 在开发过程中，使用分层验证标准（先针对性测试，然后是更大范围的扫描）隔离并验证更改。
- 完成后，运行最终验证，并根据中文提交策略生成全面的提交。
Git Commit Guard 配置指南
要使用 Openclaw Skills 将此工作流集成到您的 AI Agent 环境中，请确保您的本地仓库已初始化，并且您的配置指向标准提交模板。
# 确保您位于 git 仓库中
git init
# 如果模板位于以下位置，该技能将自动引用它：
# references/commit-template.md
# 检查状态以查看技能运行情况
git status --short --branch
Git Commit Guard 数据架构与分类体系
该技能围绕标准 Git 元数据和特定的文档模板结构组织其操作：
| 数据类型 | 来源/位置 | 用途 |
|---|---|---|
| Worktree State | git status |
确定初始化逻辑（清洁 vs 脏）。 |
| Diff Logs | git diff --stat |
用于总结更改的意图和影响。 |
| Commit Template | references/commit-template.md |
为中文提交消息提供结构蓝图。 |
| Validation Output | 本地 CLI (npm, pytest 等) | 在提交前记录验证步骤的成功/失败。 |
| Commit History | .git/logs |
存储最终的可审计哈希和详细的中文描述。 |
Git Commit Guard 高级特性
- 多阶段验证：根据更改范围自动从针对性单元测试升级到全系统冒烟测试。
- 可审计的用户更改保留：在 AI 介入之前明确识别并提交预先存在的用户更改，以保持清晰的审计线索。
- 智能验证推断：根据仓库内容动态检测是否使用 linting、类型检查或编译。
- 中文本地化：为需要该语言标准文档的团队强制执行严格的中文提交策略。
- 残留风险报告：在最终轮次响应中准确总结已测试和未测试的内容，以便开发人员更好地监督。
SKILL.md
加载中
Openclaw 相关技能
Deep Research Pro (v2.2 - True Depth)
Deep Research Pro 是一项严谨的 AI 研究技能，它执行强制性的全文解析、结构化数据提取和来源验证，以确保最大的分析深度。
OpenClaw Free Web Search
一个免费的网页搜索工具，使 OpenClaw 智能体能够访问实时网页数据，而无需 Brave 或 Perplexity API 密钥。
精选*
