任务 ID: git-mgmt-v2  |  文件: task.md  |  最后修改: 2026-02-26 09:08:32

Task git-mgmt-v2 — Git 版本管理方案分析(回滚视角)

文件路径

原始需求

为 OpenClaw 多 Agent 工作区设计 Git 版本管理方案。

核心目标:版本管理用于回滚——当错误改动导致 Agent(爱衣或其他 Agent)出现问题时,能快速回滚到正常状态。不是备份(已有定期备份),是版本控制。

背景信息:
- 主工作区 /root/.openclaw/workspace/ 已有 .git(零提交)
- 三个 Agent 工作区:workspace-coder/workspace-reviewer/workspace-researcher/(无 git)
- SOUL.md / USER.md 在 Agent 工作区是软链接,指向主工作区
- 已有 .gitignore(排除 secrets/、.jsonl、.json)

分析重点:
1. 哪些文件的错误改动会导致 Agent 出现问题?(这些才是需要版本管理的)
2. 主工作区和 Agent 工作区是一起管还是分开管?
3. MEMORY.md 如何管理(它的错误改动会影响 Agent 行为)
4. 提交策略:什么时候 commit?commit 粒度?
5. 回滚操作应该怎么做(要简单可操作)


执行链

爱衣分析 → reviewer 评估 → 爱衣质检


各 Agent 职责


爱衣(主 session,已完成分析)

任务:从"回滚"视角重新分析 Git 管理方案,产出分析报告。

分析报告路径:/root/.openclaw/workspace/tasks/git-mgmt-v2/analysis.md


Ai.Rev(session key: agent:reviewer:main

任务:评估爱衣的分析报告,从回滚可操作性角度给出意见。

开始时:
1. 发工作日志:
bash /root/.openclaw/workspace/scripts/log-to-channel.sh reviewer receive "Git版本管理方案分析" git-mgmt-v2

评估重点:
- 回滚场景覆盖是否完整(哪些文件改坏了会出问题)
- 提交粒度是否合理(太粗回滚代价大,太细噪音多)
- 回滚操作步骤是否简单可操作
- 有无遗漏的风险点

完成后:
1. 将评估报告写入 /root/.openclaw/workspace/tasks/git-mgmt-v2/review.md
2. 将执行日志追加到 session.md
3. 发工作日志:
bash /root/.openclaw/workspace/scripts/log-to-channel.sh reviewer handoff "Git版本管理方案分析" main git-mgmt-v2
4. sessions_send 通知爱衣(agent:main:main必须传 timeoutSeconds=0,禁止省略):
task_id=git-mgmt-v2 task=/root/.openclaw/workspace/tasks/git-mgmt-v2/task.md


⚠️ 爱衣质检 SOP(收到最终通知后执行)

Step 1:评估工作区大小

du -sb /root/.openclaw/workspace/tasks/git-mgmt-v2/

Step 2:读取 session.md

wc -l /root/.openclaw/workspace/tasks/git-mgmt-v2/session.md

若行数 N > 0,read session.md 全文。

Step 3:质检要点

通用检查(每次必须):
- 产出是否符合原始需求?
- 执行过程是否有明显问题?

任务特定检查:
- 分析是否以"回滚"为核心视角,而非备份视角
- 审查爱的评估是否有实质性补充
- 综合报告是否可以直接作为执行依据

Step 4:输出结论

通过
1. 发工作日志:
bash /root/.openclaw/workspace/scripts/log-to-channel.sh main done "Git版本管理方案分析" git-mgmt-v2
2. 用 message 工具发送给主人(telegram, 92763607),综合呈现分析+评估结论

不通过(rejectCount == 0)
1. 分析问题根因,设计新执行链
2. 创建新的 task.md(task_id 加后缀 -retry1),session.md 独立
3. 在原 session.md 末尾追加一行 rejectCount=1
4. sessions_send 给新执行链起始 Agent
5. 发工作日志:
bash /root/.openclaw/workspace/scripts/log-to-channel.sh main retry "Git版本管理方案分析" "reviewer → main" reviewer 1 git-mgmt-v2

rejectCount >= 1(第二次仍失败)
1. 发工作日志:
bash /root/.openclaw/workspace/scripts/log-to-channel.sh main fail "Git版本管理方案分析" git-mgmt-v2
2. message 主人,归纳问题和两次失败原因,请主人裁决

超限处理(工作区 > 80KB)

  1. 仅读 task.md(了解需求)
  2. 读 session.md 末尾 200 行
  3. message 主人:任务已完成,但工作区内容繁多,建议人工审计