Git Workflows Pro

将高级 Git 操作封装为 OpenClaw 代理可用的工具。这些操作虽不常执行，但一旦使用，必须确保绝对准确。

为何需要此功能

标准 git 技能覆盖 add/commit/push/status 等基础操作；而本技能覆盖其余所有关键场景：

• 交互式变基（squash、重排序、编辑、autosquash）
• 使用 worktree 实现并行开发
• 通过 reflog 在误删提交后恢复历史
• 使用 subtree 进行依赖管理
• 创建 PR，并强制要求人工撰写意图说明（title 和 body）
• 生成变更日志（changelog）

所有功能均基于 ClawHub 的 git-workflows 和 pr-commit-workflow 中经实战验证的模式构建。

工具列表

git_rebase_interactive

启动一次交互式变基操作。返回待办清单（todo list）及操作指引。

{
  "base": "HEAD~5",
  "autosquash": true
}

响应内容包括：

• todo_list —— 包含当前提交哈希与消息的待办清单
• instructions —— 编辑、保存、继续或中止变基的具体步骤说明

git_worktree_add

为指定分支创建新的 worktree，支持在单个仓库内同时处理多个分支，无需重复克隆。

{
  "branch": "feature/new-ui",
  "path": "/path/to/worktrees/new-ui"
}

自动创建目录并检出对应分支。返回新建 worktree 的路径。

git_reflog_recover

列出 reflog 条目，或恢复已丢失的提交。

列出 reflog：

{ "action": "list" }

恢复指定提交：

{
  "action": "restore",
  "commit_hash": "abc123",
  "target_branch": "main"
}

将在该提交处新建分支，或更新已有分支指向该提交。

git_subtree_add

将另一代码仓库以 subtree 方式添加至当前仓库的指定前缀路径下。

{
  "repo_url": "https://github.com/user/lib.git",
  "prefix": "vendor/lib",
  "branch": "main"
}

执行 git subtree add --prefix 命令。

git_pr_create

在 GitHub 上创建 PR。必须由人工提供标题（title）和正文（body），禁止自动生成。底层调用 gh CLI 工具。

{
  "title": "Add input validation to user model",
  "body": "This fixes the issue where users could submit empty forms. The validation checks for null and empty strings.nnTesting: Added unit tests for edge cases.",
  "head": "feature/input-validation",
  "base": "main",
  "draft": false
}

返回 PR 的 URL 及编号（PR number）。

git_changelog_generate

基于两个 tag 之间，或从最近一个 tag 到 HEAD 的范围，生成 Markdown 格式的变更日志。

{
  "from_tag": "v1.2.0",
  "to_tag": "v1.3.0",
  "output_format": "markdown"
}

若项目采用约定式提交（conventional commits），输出将按类型（feat、fix、breaking）对提交进行分组。

前置依赖

• 已安装 Git
• 已安装 GitHub CLI（gh），用于 PR 创建
• 已通过 gh auth login 完成身份认证

使用方式

所有工具均通过注册中心调用：

tool("git-workflows-pro", "git_rebase_interactive", {"base": "HEAD~10", "autosquash": true})
tool("git-workflows-pro", "git_worktree_add", {"branch": "feature/foo", "path": "./worktrees/foo"})
tool("git-workflows-pro", "git_pr_create", {"title": "...", "body": "...", "head": "my-branch"})

安全性保障

• 交互式变基仅返回 todo 清单，不会自动执行；代理需手动应用变更
• PR 创建强制要求人工编写 title 和 body，禁止任何形式的自动生成
• 所有可能造成破坏的操作（如 subtree、reflog 恢复）均会打印明确警告；若操作风险极高，则需额外传入确认标志（该机制尚未实现）

未来规划

• 新增 git_bisect_start 与 git_bisect_run
• 新增 git_cherry_pick_across_fork，支持跨仓库 cherry-pick
• 新增 git_merge_conflict_resolution 各类冲突解决策略
• 新增面向 Git 操作的 MCP 服务（只读模式）

许可证

商业授权。一次性付费 $49，包含终身免费更新。

设计模式源自 ClawHub 的 git-workflows、pr-commit-workflow 及 agent-harness-architect。