多 Agent 协作的
正确姿势

一句话定位

中文：一套开源的多 agent 协作工作流 skill：按能力路由、单写入者锁、独立复核、验收门禁、token 成本优化。

English: Coordinate 3+ AI agents with capability-based routing, single-writer ownership, independent verification, and token-efficient workflows.

目录

• 一、多 Agent 协作的四个经典事故
• 二、四层设计：能力发现 · 单写入者 · 风险分级 · 验收门禁
• 三、token 成本控制：省钱不省正确性
• 四、诚实的边界
• 五、获取方式

一、多 Agent 协作的四个经典事故

二、四层设计

1. 能力发现，不靠名字猜

任务开始前每个 agent 提交能力清单：模型、工具、读写权限、专长、成本等级、可用状态。角色按证据打分（3 有直接工具+反复证据 / 2 合理+部分证据 / 1 间接 / 0 不可用），选最高分，再偏好低成本、低争用。

2. 单写入者：一个文件，一个主人

同一资源同一时间只允许一个主写入者；评审者只写隔离产物（测试/报告/补丁）。换主人必须走正式交接：旧主人、新主人、原因、基线、下一步检查。

3. 风险分级：routine / important / critical

日常走短路径；重要走 规划-实现-验证-验收 全流水线且验证者独立；关键再加领域评审，部署/发布/发送/删除必须人工批准。"这是重要任务"一句话即可升级。

4. 验收门禁：没证据，不许说"完成"

验收覆盖真实运行行为、目标环境（桌面+移动）、核心交互、错误输出、键盘可达性、资源加载、回退与减动效模式。门禁失败退回对应阶段。

三、token 成本控制：省钱不省正确性

• 一个规范任务包，而非完整聊天记录复制粘贴
• 有界输出：JSON 或带必填字段的短报告
• 并行只读、串行写入；独立检查并行跑
• 模型分层：便宜模型干机械活，强模型留给架构与验收
• 按 revision/hash 缓存稳定结果；设停止阈值
• 绝不压缩：需求、权限、报错、代码、路径、哈希、证据

四、诚实的边界

这不是"保证不出错"的银弹，而是一套让错误可见、可回滚、可追责的控制：停止条件、可恢复基线、批准记录、残余风险报告。

五、获取方式

git clone https://github.com/<用户名>02669-ops/agent-orchestra.git
cd agent-orchestra
# Windows
powershell -ExecutionPolicy Bypass -File scripts/install.ps1
# Linux/macOS
./scripts/install.sh

协议：MIT · 落地页：https://<用户名>02669-ops.github.io/agent-orchestra/