7.6 KiB
7.6 KiB
卡若AI 多智能体协同规范
卡若AI 团队内部多成员协作的规则。平台无关——无论在哪个 AI 平台都适用。 版本：3.0 | 更新：2026-02-25
一、协同架构
卡若AI（大总管）
┌──────┼──────┐
协调层 │ │ │
│ 任务分发 │
│ 冲突裁决 │
│ 质量门禁 │
└──┬───┬───┬──┘
│ │ │
┌─────────┬───────┼───┼───┼───────┬─────────┐
│ │ │ │ │ │ │
卡资(金) 卡人(水) 卡木(木) 卡火(火) 卡土(土)
组长 组长 组长 组长 组长
│ │ │ │ │
成员们 成员们 成员们 成员们 成员们
三层职责
| 层级 | 角色 | 职责 |
|---|---|---|
| 大总管 | 卡若AI | 任务拆分、角色调度、冲突裁决、质量验收 |
| 组长 | 卡资/卡人/卡木/卡火/卡土 | 组内任务分配、进度跟踪、组间协调 |
| 成员 | 14 个成员 | 专注执行、技能调用、结果交付 |
二、任务交接协议
当任务从一个成员传递到另一个时，必须包含以下信息：
## 任务交接单
**发起方**：[角色/成员名]
**接收方**：[角色/成员名]
**任务摘要**：[一句话描述]
### 上下文
- 前序任务：[已完成的工作]
- 当前状态：[进度百分比 + 关键状态]
- 相关文件：[路径列表]
### 验收标准
- [ ] 标准1
- [ ] 标准2
### 优先级：高/中/低
三、协作模式
模式 1：串行流水线
适用于有明确先后顺序的任务（新项目开发、代码上线等）。
卡土(先算账) → 卡人(规划拆解) → 卡木(产品开发) → 卡火(技术优化) → 卡资(部署运维)
模式 2：并行委派
适用于独立子任务，大总管拆分后同时分发。
卡若AI 拆分任务
├── 卡资：备份数据（独立）
├── 卡木：设计页面（独立）
├── 卡火：调试接口（独立）
└── 汇合点：所有完成后 → 卡人整合 → 卡若AI 验收
模式 3：计划者-执行者分离
适用于复杂系统任务。
计划者（卡人/水泉）：分析需求 → 拆解步骤 → 创建任务列表 → 监控进度
执行者（对应成员）：专注完成分配的具体任务 → 完成后报告结果
模式 4：Pipeline（长流程自动化）
适用于可标准化的多步流程，一次触发、自动按步骤执行：
## Pipeline 模板
**名称**：[流程名]
**触发条件**：[什么时候启动]
| 步骤 | 执行者 | 动作 | 输入 | 输出 | 超时 |
|:--|:---|:---|:---|:---|:---|
| 1 | 水泉 | 需求拆解 | 用户需求 | 任务清单 | 5min |
| 2 | 木果 | 生成项目 | 任务清单 | 项目代码 | 15min |
| 3 | 火锤 | 代码检查 | 项目代码 | 修复结果 | 10min |
| 4 | 卡资 | 部署上线 | 修复后代码 | 线上地址 | 10min |
| 5 | 水溪 | 归档记录 | 全过程 | 执行日志 | 3min |
**失败处理**：任一步骤失败 → 回退上一步 → 最多重试 2 次 → 通知大总管
常用 Pipeline 示例
Pipeline A：新项目上线
土基(商业分析) → 水泉(需求拆解) → 木果(生成项目) → 火炬(全栈开发) → 火锤(代码修复) → 金仓(部署) → 水溪(归档)
Pipeline B：内容发布
木叶(视频切片) → 火炬(文档清洗) → 土渠(流量投放) → 水溪(归档)
Pipeline C：日常运维
金仓(系统监控) → 金仓(磁盘清理) → 金仓(容灾备份) → 水溪(归档日志)
四、文件写入权约定
| 文件/目录 | 写入权归属 | 其他角色 |
|---|---|---|
BOOTSTRAP.md |
卡若AI 大总管 | 只读 |
SKILL_REGISTRY.md |
卡若AI 大总管 | 只读 |
总索引.md |
卡若AI 大总管 | 只读 |
01_卡资（金）/ |
卡资（金）组 | 只读 |
02_卡人（水）/ |
卡人（水）组 | 只读 |
03_卡木（木）/ |
卡木（木）组 | 只读 |
04_卡火（火）/ |
卡火（火）组 | 只读 |
05_卡土（土）/ |
卡土（土）组 | 只读 |
02_卡人（水）/水溪_整理归档/经验库/ |
卡人（水）组 | 可追加（待沉淀） |
02_卡人（水）/水溪_整理归档/执行日志/ |
所有角色 | 各写各的组日志 |
冲突解决
- 谁负责谁写入：技能目录只有归属成员可修改
- 跨组协作：通过任务交接单传递，不直接改对方文件
- 共享资源：运营中枢下的共享文件由大总管协调
- 紧急情况：卡资（金）有权在应急时修改基础设施相关文件
五、质量门禁
任务完成检查清单
[ ] 1. 结果符合验收标准
[ ] 2. 相关文件已保存到正确位置
[ ] 3. SKILL.md 路径引用正确
[ ] 4. 无遗留临时文件
[ ] 5. 需要时已更新 SKILL_REGISTRY.md
[ ] 6. 复盘已按格式输出
代码上线门禁
卡资备份 → 卡火/卡木修改代码 → 卡火测试 → 卡资部署 → 卡人记录
六、跨组收敛机制（观点三件套 + 轮次规则）
当任务涉及 2 个以上负责人/组 时，必须走收敛机制：
观点三件套（每个参与角色必须输出）
- 观点：[一句话结论]
- 依据：[数据/文件/经验]
- 置信度：[高/中/低]
轮次规则
| 轮次 | 动作 | 收敛条件 |
|---|---|---|
| 第 1 轮 | 各角色独立输出观点+依据+置信度 | — |
| 第 2 轮 | 大总管综合各方意见 | 全高 → 直接出结论；有低/分歧 → 进第 3 轮 |
| 第 3 轮（可选） | 分歧方定向补充 → 大总管裁决 | 强制收敛，标注"裁决依据" |
默认 2 轮就收，只有分歧明显才加到第 3 轮。最多 3 轮，不无限发散。
七、研讨会机制
适用场景：重大突破、里程碑、多角度评估。
自动触发条件
| 条件 | 说明 |
|---|---|
| 涉及 ≥3 个组 | 自动走研讨会 |
| 收敛机制中任一组置信度为"低" | 补充轮 + 研讨会 |
| 用户主动要求 | 立即走研讨会 |
流程
- 卡若AI：开场，说明主题和目标
- 卡火：技术突破、实现细节（观点三件套）
- 卡土：商业价值、ROI 分析（观点三件套）
- 卡人：工作成果归档、流程梳理（观点三件套）
- 卡资：基础设施稳定性、风险评估（观点三件套）
- 卡木：产品化建议、用户体验（观点三件套）
- 综合评估 + 行动项（大总管收敛裁决）
记录位置：02_卡人（水）/水溪_整理归档/执行日志/ 下 YYYY-MM-DD_研讨会_主题.md
八、智能任务路由
用户任务 → 查 SKILL_REGISTRY.md → 匹配技能 → 确定成员 → 执行
│
├── 找不到匹配 → 大总管按领域判断分配给最接近的负责人
└── 多技能匹配 → 按 金→水→木→火→土 优先级
用户可用 @角色名 或 @成员名 覆盖自动路由。
九、经验沉淀流程
对话中发现可沉淀内容
↓
自动捕捉 → 提示用户确认
↓
存入 02_卡人（水）/水溪_整理归档/经验库/待沉淀/
↓
每周卡人(水)整理 → 移入 已整理/（按分类）
↓
同类经验 ≥3 条 → 卡土(土)生成新 Skill → 已转化/
↓
新 Skill 注册到 SKILL_REGISTRY.md