Multi-Agent CN

核心用法

multi-agent-cn 是一款通用多Agent调度系统模板，核心设计理念是主Agent纯调度化——主Agent不再执行任何实际任务，而是作为调度员接收需求、评估难度、分派给5个持久化子Agent（Alpha/Bravo/Charlie/Delta/Echo）执行。

关键机制

1. 轮询调度：任务按顺序循环分配给5个子Agent，避免单点过载
2. 先回复再派遣协议：必须先输出文字告知用户任务分配方案，再调用sessions_spawn，防止用户因看不到tool call而误以为系统无响应
3. sessionKey固定复用：强制使用alpha/bravo/charlie/delta/echo五个固定key，确保子Agent状态持久化
4. 并行派遣：单条用户指令含多个独立任务时，拆解后同时派发给多个子Agent

任务等级体系

采用S/A/B/C/D五级评估：S级（架构重构/生产事故）、A级（复杂开发/性能优化）、B级（常规功能/bug修复）、C级（小改动/信息收集）、D级（纯查询/简单问答），每次派遣前必须公示等级与风险。

显著优点

• 架构清晰：彻底解耦调度与执行，主Agent专注意图理解和协调，子Agent专注具体技能
• 高可定制性：调度员角色、子Agent名称/人设、任务等级体系均可自由替换，支持军事、企业、动漫等主题改造
• 并行效率：多任务场景下突破单Agent串行瓶颈，理论提速5倍
• 状态持久：固定sessionKey保证子Agent上下文连续性，适合长周期复杂任务

潜在局限

• 平台依赖：核心依赖sessions_spawn工具，仅支持Claude Code/Claw等具备该能力的平台
• 协调复杂度：多Agent并行时，任务依赖关系需人工判断，错误拆解可能导致资源浪费或逻辑错误
• 调试难度：子Agent独立运行，故障定位需跨session追踪
• 无自动负载均衡：纯轮询机制，未考虑子Agent实际负载差异

适合人群

• 需要同时处理多个独立任务的重度用户（如全栈开发、内容创作）
• 希望构建主题化AI助手人格的爱好者
• 团队协作场景下需模拟"经理-员工"分工模式的用户

常规风险

• sessionKey遗漏：未传或错传sessionKey将创建垃圾session，造成资源泄漏
• 静默失败：子Agent执行异常时主Agent需主动捕获并汇报，禁止静默忽略
• 过度拆解：强行拆分有依赖关系的任务将导致逻辑错误，需严格遵循"B依赖A则不拆"原则

核心用法

multi-agent-cn 是一个纯提示词模板型 Skill，无实际可执行代码。安装后，主 Agent 角色转变为「调度员」，所有实际任务通过 sessions_spawn 工具委派给 5 个固定 sessionKey 的子 Agent（alpha/bravo/charlie/delta/echo）。

关键机制：

• 轮询调度：任务按顺序循环分发给 5 个子 Agent
• 并行派遣：用户一句多任务时，自动拆解为独立子任务，同时 spawn 多个 Agent
• 先回复再派遣：必须先用文字告知用户任务评估与分配方案，再调工具
• 难度分级：S/A/B/C/D 五级评估体系，强制在派遣前输出风险评估

典型工作流：
1. 接收用户请求 → 2. 评估难度等级 → 3. 文字回复任务分配方案 → 4. 调用 sessions_spawn 并指定 sessionKey → 5. 静默等待子 Agent 回报 → 6. 向用户转达结果

显著优点

• 架构清晰：调度与执行彻底分离，避免单 Agent 负载过重
• 并行提效：多任务场景下 5 个 Agent 同时工作，显著缩短总耗时
• 灵活可定制：调度员角色、子 Agent 名称/人设、任务等级体系均可自由修改
• 安全可控：纯 Markdown 实现，无代码注入风险，经 CLS-Certify 认证 A 级（92分）
• 中文优化：专门针对中文语境设计，指令风格干练、等级评估直观

潜在缺点与局限性

• 平台依赖：依赖宿主系统支持 sessions_spawn 工具，非通用标准
• 调试复杂：子 Agent 独立运行，错误追踪需手动查看各 session 日志
• 协调成本：任务拆解不当可能导致重复工作或结果冲突
• 无自动重试：文档未提及子 Agent 失败时的自动容错机制
• session 管理：固定 5 个 sessionKey，无法动态扩缩容

适合人群

• 需要高频并行处理多任务的开发者/团队
• 熟悉 sessions_spawn 机制的平台深度用户
• 希望自定义多 Agent 协作角色的提示词工程师
• 中文语境下追求「指挥官」风格交互体验的用户

常规风险

| 风险项 | 说明 | 缓解建议 |

|--------|------|---------|

| 子 Agent 超时 | 固定 300 秒超时，长任务可能中断 | 拆解大任务为子任务 |

| sessionKey 误用 | 错传 key 会创建垃圾 session | 严格核对 alpha~echo 五值 |

| 上下文丢失 | 子 Agent 看不到主对话历史 | task 字段务必自包含完整背景 |

| 静默失败 | spawn 后无反馈易误判为成功 | 强制要求子 Agent 明确回报机制 |

| 过度拆解 | 本可单任务硬拆导致协调混乱 | 遵循「有依赖不拆」原则 |

来源与认证

• 作者：cloudboy
• 平台：ClawHub（T3 社区级，经基础审核）
• 安全认证：CLS-Certify A 级（92/100），纯文档无可执行代码，无网络调用，无敏感信息泄露