用途:在 AgentTeams 中,Worker 无法访问 git 凭据,因此把所有 git 操作委托给 Manager 执行。Manager 通过宿主机的 /host-share/.gitconfig(软链到 /root/.gitconfig)和宿主机配置的 SSH 密钥、凭据助手完成认证,从而使用正确的作者名、邮箱和身份。
主要能力:可代执行任意 git 操作,包括仓库(clone、init)、分支(branch、checkout、switch)、远程(remote、fetch、pull、push)、提交(add、commit、reset、revert)、历史(log、show、diff)、rebase、cherry-pick、merge、stash、tag、submodule 以及仓库级 config。
使用方式:Worker 发送含 workspace: 与 operations: 字段的 git-request: 块,Manager 提取 task-id、workspace、operations 和可选 context。执行流程为:先用 mc mirror 从 MinIO 同步任务目录,用 check-processing-marker.sh 检查处理标记,再用 create-processing-marker.sh 创建标记;随后 cd 到 workspace 逐条执行 git 命令;完成后用 remove-processing-marker.sh 移除标记,再用 mc mirror --overwrite 同步回 MinIO。成功回复 git-result: 并提示 Worker 运行 hiclaw-sync,失败回复 git-failed: 并给出修复建议。
限制与注意事项:必须等到真正含 workspace: 和 operations: 字段的请求才执行,预览性表述不执行;收到请求须立即执行,不能等待 Worker;重复请求只回复已完成,不重复执行;同一任务多条请求只执行最后一条;不得删除或覆盖远程仓库;git-result 不等于任务完成,仍需等待 Worker 的完成报告。合并冲突、认证失败、分支分叉等需按情况处理或上报。