概述
firm-orchestration 是一个面向 OpenClaw 的多智能体金字塔编排框架,实现了经典的A2A(Agent-to-Agent)层级协作模式。该技能模拟企业组织架构,将任务从CEO智能体逐层下发至部门、服务、员工三个层级,并通过严格的合约机制确保任务闭环。
核心用法
用户通过简洁的 YAML 风格指令触发完整编排流程:
@firm-orchestration run objective: "任务描述" departments: ["指定部门列表"] delivery_format: "输出格式"
系统激活四大核心工具:
sessions_list— 发现活跃会话sessions_spawn— 按需创建子会话sessions_send— 向下层级分发任务sessions_history— 收集并合并结果
显著优点
1. 工业级并行调度
严格遵循 Anthropic 团队的"永不顺序执行"原则,所有部门任务通过 sessions_send 同时派发,避免串行等待瓶颈。
2. 智能阻塞处理机制
不直接干预部门间冲突,而是生成联合协调会话让冲突方自主迭代解决,最多两轮后上报CEO,保持系统解耦。
3. 硬截止与部分接受策略
30秒强制收敛窗口,超时自动标记为 timeout 而非无限等待,确保交付确定性。
4. 完整的质量闸门
每份部门输出必须满足 definition_of_done 才能进入合并流程,未达标明确标记为 quality: partial,拒绝静默丢弃。
5. 强制 Git 检查点
涉及工程部门时,要求子任务级提交、PR 草案化、标签化审查流程,防止直接污染主分支。
潜在缺点与局限性
复杂度门槛高:金字塔架构要求使用者理解层级合约、依赖顺序、并发控制等多维概念,小型团队可能过度设计。
30秒截止的刚性代价:对复杂任务可能迫使系统接受大量 timeout 和 partial 结果,需要人工后续补全。
spawn 上限约束:单次运行最多20个子会话,大规模组织模拟场景可能触顶。
纯 WebSocket 路由限制:无外部网络调用能力,与第三方 API 协作需额外代理层。
适合人群
- 多智能体系统研究者:需要验证层级编排理论的实际效能
- 企业自动化团队:寻求将组织架构映射到 AI 工作流的工程实践
- AI 代理平台开发者:为 OpenClaw 或类似框架扩展编排能力
常规风险
- 孤儿会话风险:虽然强制
reply_session: "main",但异常中断仍可能导致僵尸会话堆积 - 合约逃逸:schema 验证仅检查格式,语义层面的
definition_of_done仍需人工复核 - 级联阻塞:若 Strategy 部门超时,下游 Engineering/Quality/Ops 的依赖序合并将产生空值传播
> ⚠️ 技能输出携带强制免责声明:"Contenu généré par IA — validation humaine requise avant utilisation en production"