任务 ID: task-cc128cd1  |  文件: task.md  |  最后修改: 2026-03-03 18:15:24

Task task-cc128cd1 — Kizuna Hub 核心 API 开发(Step 1.1)

文件路径

原始需求

开发 Kizuna Hub 的核心 API(Phase 1 Step 1.1),实现任务管理的基础功能。

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

交付物
- FastAPI 服务,监听 127.0.0.1:8891
- REST API:
- POST /tasks/create — 创建任务
- POST /tasks/{id}/validate — 验证 TASK.md
- POST /tasks/{id}/start — 启动任务
- POST /tasks/{id}/submit/{subtask_id} — 提交 subtask
- GET /tasks/{id}/status — 查询任务状态
- 状态存储:tasks.json(JSON 文件)

验收标准
- ✅ API 能正常响应(用 curl 测试)
- ✅ tasks.json 能正确读写
- ✅ 日志输出到 logs/hub.log

源码位置/srv/kizuna/kizuna-hub/(保持干净,不放临时文件)

代码要求
- 最小化实现,只写必需功能
- 清晰的代码结构和注释
- 错误处理完善


执行链

coder → reviewer → 爱衣质检


各 Agent 职责


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

任务:开发 Kizuna Hub 核心 API

具体要求
1. 阅读设计文档 /root/.openclaw/workspace/memory/docs/kizuna-design-phase1-v5.md
2. 在 /srv/kizuna/kizuna-hub/ 创建项目结构
3. 实现 FastAPI 服务和所有 API 端点
4. 实现 tasks.json 状态存储
5. 配置日志输出
6. 提供基本的 curl 测试命令示例

输出
- 完整源码(/srv/kizuna/kizuna-hub/
- README.md(启动方法、API 文档、测试命令)
- requirements.txt

开始时:
1. 发工作日志:
bash /root/.openclaw/workspace/scripts/log-to-channel.sh coder receive "Kizuna Hub 核心 API 开发" task-cc128cd1

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


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

任务:审核代码质量并进行功能测试

具体要求
1. 代码审查:
- 代码结构是否清晰
- 错误处理是否完善
- 是否符合最小化实现原则
- API 设计是否符合设计文档
2. 功能测试:
- 启动服务
- 用 curl 测试所有 API 端点
- 验证 tasks.json 读写
- 验证日志输出
3. 问题记录:
- 发现的 bug
- 需要改进的地方
- 测试结果

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

开始时:
1. 发工作日志:
bash /root/.openclaw/workspace/scripts/log-to-channel.sh reviewer receive "Kizuna Hub 核心 API 开发" task-cc128cd1

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


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

Step 1:评估工作区大小

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

Step 2:读取 session.md

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

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

Step 3:质检要点

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

任务特定检查:
- Hub 源码是否在 /srv/kizuna/kizuna-hub/
- 是否实现了所有 5 个 API 端点?
- Reviewer 的测试是否通过?
- 是否有严重 bug 或设计问题?

Step 4:输出结论

通过
1. 发工作日志:
bash /root/.openclaw/workspace/scripts/log-to-channel.sh main done "Kizuna Hub 核心 API 开发" task-cc128cd1
2. 用 message 工具发送给主人(telegram, 92763607),归纳任务结果
⚠️ 必须调用 message 工具,不能只在主对话回复

不通过(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 Hub 核心 API 开发" "<新执行链>" <起始role> 1 task-cc128cd1

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

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

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