tank-battle/multi-agent-workflow.md

多 Agent 协作流程 UML

说明：上一轮实现中，Codex 实际调用的是 Codex 环境内的 worker 子 agent，并不等同于真实调用 zcode(glm-5.2) 和 qoder(qwen3.7-max)。这不满足“不同 agent 实体协作”的测试目标。

本机当前探测结果：

• qoder 可通过命令行调用，并支持 qoder chat。
• ZCode.exe 存在于 D:\Program Files\ZCode\ZCode.exe，但未发现可用的命令行 chat/help 接口。
• 因此，真正的三 agent 协作建议用 Git/Gitea 做中枢：Codex 创建 issue/分支和验收标准，Qoder 可由 CLI 接收任务，ZCode 需要通过 GUI 或你提供的 CLI 入口接收任务。

正确的真实协作流程

@startuml
title 真实三 Agent 协作流程：Codex + ZCode + Qoder

actor User as 用户
participant Codex as "Codex\n统筹/集成/验收"
participant ZCode as "ZCode(glm-5.2)\n真实外部 Agent"
participant Qoder as "Qoder(qwen3.7-max)\n真实外部 Agent"
participant Local as "E:\\Documents\\ai_share\n工作目录"
participant Gitea as "Gitea\nlaidaixi/tank-battle"
participant Web as "splan.laidaixi.com/docs\n在线验证"

用户 -> Codex: 定义目标和验收标准
Codex -> Local: 检查项目状态
Codex -> Gitea: 创建/更新 issue 和分支

Codex -> Gitea: 创建 gameplay 任务单
Codex -> Gitea: 创建 ui 任务单

par 外部 Agent 并行工作
  用户 -> ZCode: 在 ZCode 中打开 gameplay 任务\n处理 src/game.js
  Codex -> Qoder: 通过 qoder chat 发送 UI 任务\n处理 index.html / src/styles.css
end

ZCode -> Gitea: 提交 gameplay 分支或补丁
Qoder -> Gitea: 提交 ui 分支或补丁

Codex -> Gitea: 拉取两个分支
Codex -> Local: 合并、解决冲突、统一接口
Codex -> Web: 在线验证页面和游戏交互
Web --> Codex: 返回验证结果

Codex -> Gitea: 合并到 main 并推送
Codex -> 用户: 交付链接、提交记录、验证结果

@enduml

推荐任务边界

• Codex：项目骨架、issue/branch、集成、测试、Gitea 推送。
• ZCode：核心玩法逻辑，写入 src/game.js，不改 UI 样式和 Git 配置。
• Qoder：页面结构和视觉体验，写入 index.html、src/styles.css，不改核心玩法算法。

当前限制

如果要让 Codex 直接调起 ZCode 工作，需要提供 ZCode 的可脚本化入口，例如：

• CLI 命令格式；
• 可接收 prompt 的本地 API；
• MCP/server 接口；
• 或 ZCode 支持的 headless/agent 模式参数。