Skip to main content

AI 协作工作流

版本：v1.0 | 2026-03-06 适用：clawzone 多 agent 协作体系

一、体系概览​

用户 (Tom)
    │
    ▼
kzzs（主控 agent）
    │  负责：理解需求、拆解任务、分发、汇总结果
    │
    ├──► e50u（技术顾问 agent）
    │       负责：技术执行、代码/部署/配置类任务
    │
    └──► [未来 agent]
            负责：待定专项能力

角色定义​

Agent角色能力边界
kzzs主控/协调沟通用户、任务拆解、分发指令、汇总结果、长期记忆
e50u技术顾问代码审查、部署执行、技术方案评估

二、任务分发流程​

2.1 标准流程​

1. 用户 → kzzs：提出需求
2. kzzs：理解需求，必要时澄清
3. kzzs：拆解为可执行子任务
4. kzzs → 执行 agent：通过消息分发任务
   - 消息格式见 2.2
5. 执行 agent：读文档 → 执行 → 回报
6. kzzs：收集结果，汇总给用户

2.2 任务分发消息格式​

kzzs 向执行 agent 分发任务时，消息应包含：

## 任务：[任务标题]

### 背景
[必要上下文，1-3句话]

### 目标
[明确的完成标准]

### 参考文档
- [相关规则/方案 URL]

### 约束
- [不能做的事]
- [必须确认的点]

### 回报要求
- [需要汇报哪些结果]

2.3 文档 URL 规范​

分发任务时，附上相关规则文档链接：

文档URL
Agent SOPhttps://docs.clawzone.ai/rules/agent-sop
协作工作流https://docs.clawzone.ai/rules/collaboration
基础设施概览https://docs.clawzone.ai/infrastructure/overview
任务看板https://docs.clawzone.ai/projects/status

三、结果汇总​

3.1 执行 agent 回报 → kzzs 汇总​

执行 agent 完成任务后，回报给 kzzs（通过 subagent 自动机制）。

kzzs 收到结果后：

  1. 判断任务是否真正完成（不只是"我做了"，要验证结果）
  2. 如有问题，指派修复
  3. 全部完成后，向用户汇总报告

3.2 汇总报告格式​

✅ 任务完成报告

**任务：** [任务名称]
**执行人：** [agent 名]
**结果：** 成功 / 部分成功 / 失败

**完成内容：**
- [条目1]
- [条目2]

**可访问链接：**
- [URL列表]

**遗留事项：**
- [如有]

四、规则同步机制​

工作原理​

修改 clawzone-projects 仓库
    │
    ▼ git push (SSH: git.clawzone.ai:2222)
    │
    ▼ GitLab CI/CD 触发（约 60-90 秒）
    │
    ▼ docs.clawzone.ai 自动更新
    │
    ▼ 所有 agent 下次 web_fetch 时读到新版本

更新规则的操作步骤​

cd /Users/tom/Documents/git/clawzone-projects
# 修改对应文件
git add .
git commit -m "rules: 更新[文件名] - [变更内容]"
git push origin main
# 等待 60-90 秒后验证
curl https://docs.clawzone.ai/rules/[文件名]

Agent 读取最新规则​

每次执行任务前，agent 应 web_fetch 相关规则文档，确保使用最新版本：

web_fetch https://docs.clawzone.ai/rules/agent-sop
web_fetch https://docs.clawzone.ai/rules/collaboration

五、冲突处理​

场景处理方式
执行 agent 遇到歧义回报"需要确认"，不猜测
规则与指令冲突以最新文档为准，告知 kzzs
多 agent 同时修改同一资源kzzs 协调，串行执行
执行失败回报阻塞原因，等待 kzzs 决策

六、演进计划​

  • 跑通 kzzs → e50u 完整分发-执行-汇总流程
  • 定义 agent 能力边界文档
  • 建立任务队列机制（避免并发冲突）
  • 添加审计日志（谁执行了什么，结果如何）

文档地址：https://docs.clawzone.ai/rules/collaboration