任务 ID: task-cd890493  |  文件: task.md  |  最后修改: 2026-03-03 19:37:57

Task task-cd890493 — Kizuna 返工机制(Step 7)

文件路径

原始需求

开发 Kizuna 返工机制(Phase 1 Step 7),实现 Coordinator 指定 subtask 返工。

参考文档/root/.openclaw/workspace/memory/docs/kizuna-design-phase1-v5.md

交付物
- CLI 子命令:kizuna-ctl retry
- Hub API:POST /tasks/{id}/retry/{subtask_id}
- 返工目录:subtask-xxx/retry-1/
- FEEDBACK.md 生成

验收标准
- ✅ Coordinator 能指定 subtask 返工
- ✅ Worker 能读取 FEEDBACK.md
- ✅ 返工输出写入 retry-1/ 目录
- ✅ 超过 1 次返工后任务失败

源码位置
- Hub: /srv/kizuna/kizuna-hub/main.py(扩展)
- CLI: /srv/kizuna/cli/kizuna-ctl(扩展)

代码要求
- 最小化实现
- 完善的错误处理


执行链

coder → reviewer → 爱衣质检


各 Agent 职责


Ai.Dev(session key: agent:coder:main

任务:开发返工机制

具体要求
1. 阅读设计文档中的返工机制部分
2. 在 Hub 中添加 retry API
3. 在 CLI 中添加 retry 命令
4. 实现返工目录和 FEEDBACK.md 生成
5. 提供测试用例

输出
- 更新后的 Hub 和 CLI 源码
- 测试用例

开始时:
1. 发工作日志:
bash /root/.openclaw/workspace/scripts/log-to-channel.sh coder receive "Kizuna 返工机制开发" task-cd890493

完成后:
1. 将执行日志追加到 session.md
2. 发工作日志:
bash /root/.openclaw/workspace/scripts/log-to-channel.sh coder handoff "Kizuna 返工机制开发" reviewer task-cd890493
3. sessions_send 通知 reviewer(agent:reviewer:main必须传 timeoutSeconds=0):
task_id=task-cd890493 task=/root/.openclaw/workspace/tasks/task-cd890493/task.md


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

任务:审核返工机制并测试

具体要求
1. 代码审查
2. 功能测试:
- 指定 subtask 返工
- 验证 FEEDBACK.md 生成
- 验证 retry-1/ 目录创建
- 测试返工次数限制
3. 问题记录

输出
- review.md(审查报告 + 测试结果)

开始时:
1. 发工作日志:
bash /root/.openclaw/workspace/scripts/log-to-channel.sh reviewer receive "Kizuna 返工机制开发" task-cd890493

完成后:
1. 将执行报告追加到 session.md
2. 发工作日志:
bash /root/.openclaw/workspace/scripts/log-to-channel.sh reviewer handoff "Kizuna 返工机制开发" main task-cd890493
3. sessions_send 通知爱衣(agent:main:main必须传 timeoutSeconds=0):
task_id=task-cd890493 task=/root/.openclaw/workspace/tasks/task-cd890493/task.md


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

Step 1:评估工作区大小

du -sb /root/.openclaw/workspace/tasks/task-cd890493/

Step 2:读取 session.md

wc -l /root/.openclaw/workspace/tasks/task-cd890493/session.md

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

Step 3:质检要点

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

任务特定检查:
- 是否实现了所有功能?
- Reviewer 的测试是否通过?

Step 4:输出结论

通过
1. 发工作日志:
bash /root/.openclaw/workspace/scripts/log-to-channel.sh main done "Kizuna 返工机制开发" task-cd890493
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 "Kizuna 返工机制开发" "<新执行链>" <起始role> 1 task-cd890493

rejectCount >= 1(第二次仍失败)
1. 发工作日志:
bash /root/.openclaw/workspace/scripts/log-to-channel.sh main fail "Kizuna 返工机制开发" task-cd890493
2. message 主人,归纳问题和两次失败原因,请主人裁决

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

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