# 卡若AI 多智能体协同规范

> 卡若AI 团队内部多成员协作的规则。平台无关——无论在哪个 AI 平台都适用。
> 版本：3.0 | 更新：2026-02-25

---

## 一、协同架构

```
                    卡若AI（大总管）
                   ┌──────┼──────┐
          协调层    │      │      │
                   │  任务分发   │
                   │  冲突裁决   │
                   │  质量门禁   │
                   └──┬───┬───┬──┘
                      │   │   │
    ┌─────────┬───────┼───┼───┼───────┬─────────┐
    │         │       │   │   │       │         │
  卡资(金)  卡人(水) 卡木(木) 卡火(火) 卡土(土)
  组长       组长     组长     组长     组长
    │         │       │       │       │
  成员们    成员们   成员们   成员们   成员们
```

### 三层职责

| 层级 | 角色 | 职责 |
|:---|:---|:---|
| **大总管** | 卡若AI | 任务拆分、角色调度、冲突裁决、质量验收 |
| **组长** | 卡资/卡人/卡木/卡火/卡土 | 组内任务分配、进度跟踪、组间协调 |
| **成员** | 14 个成员 | 专注执行、技能调用、结果交付 |

---

## 二、任务交接协议

当任务从一个成员传递到另一个时，必须包含以下信息：

```markdown
## 任务交接单

**发起方**：[角色/成员名]
**接收方**：[角色/成员名]
**任务摘要**：[一句话描述]

### 上下文
- 前序任务：[已完成的工作]
- 当前状态：[进度百分比 + 关键状态]
- 相关文件：[路径列表]

### 验收标准
- [ ] 标准1
- [ ] 标准2

### 优先级：高/中/低
```

---

## 三、协作模式

### 模式 1：串行流水线

适用于有明确先后顺序的任务（新项目开发、代码上线等）。

```
卡土(先算账) → 卡人(规划拆解) → 卡木(产品开发) → 卡火(技术优化) → 卡资(部署运维)
```

### 模式 2：并行委派

适用于独立子任务，大总管拆分后同时分发。

```
卡若AI 拆分任务
├── 卡资：备份数据（独立）
├── 卡木：设计页面（独立）
├── 卡火：调试接口（独立）
└── 汇合点：所有完成后 → 卡人整合 → 卡若AI 验收
```

### 模式 3：计划者-执行者分离

适用于复杂系统任务。

```
计划者（卡人/水泉）：分析需求 → 拆解步骤 → 创建任务列表 → 监控进度
执行者（对应成员）：专注完成分配的具体任务 → 完成后报告结果
```

### 模式 4：Pipeline（长流程自动化）

适用于可标准化的多步流程，一次触发、自动按步骤执行：

```markdown
## 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. **共享资源**：运营中枢下的共享文件由大总管协调
4. **紧急情况**：卡资（金）有权在应急时修改基础设施相关文件

---

## 五、质量门禁

### 任务完成检查清单

```
[ ] 1. 结果符合验收标准
[ ] 2. 相关文件已保存到正确位置
[ ] 3. SKILL.md 路径引用正确
[ ] 4. 无遗留临时文件
[ ] 5. 需要时已更新 SKILL_REGISTRY.md
[ ] 6. 复盘已按格式输出
```

### 代码上线门禁

```
卡资备份 → 卡火/卡木修改代码 → 卡火测试 → 卡资部署 → 卡人记录
```

---

## 六、跨组收敛机制（观点三件套 + 轮次规则）

当任务涉及 **2 个以上负责人/组** 时，必须走收敛机制：

### 观点三件套（每个参与角色必须输出）

```
- 观点：[一句话结论]
- 依据：[数据/文件/经验]
- 置信度：[高/中/低]
```

### 轮次规则

| 轮次 | 动作 | 收敛条件 |
|:---|:---|:---|
| 第 1 轮 | 各角色独立输出观点+依据+置信度 | — |
| 第 2 轮 | 大总管综合各方意见 | 全高 → 直接出结论；有低/分歧 → 进第 3 轮 |
| 第 3 轮（可选） | 分歧方定向补充 → 大总管裁决 | 强制收敛，标注"裁决依据" |

**默认 2 轮就收**，只有分歧明显才加到第 3 轮。最多 3 轮，不无限发散。

---

## 七、研讨会机制

适用场景：重大突破、里程碑、多角度评估。

### 自动触发条件

| 条件 | 说明 |
|:---|:---|
| 涉及 ≥3 个组 | 自动走研讨会 |
| 收敛机制中任一组置信度为"低" | 补充轮 + 研讨会 |
| 用户主动要求 | 立即走研讨会 |

### 流程

1. **卡若AI**：开场，说明主题和目标
2. **卡火**：技术突破、实现细节（观点三件套）
3. **卡土**：商业价值、ROI 分析（观点三件套）
4. **卡人**：工作成果归档、流程梳理（观点三件套）
5. **卡资**：基础设施稳定性、风险评估（观点三件套）
6. **卡木**：产品化建议、用户体验（观点三件套）
7. **综合评估 + 行动项**（大总管收敛裁决）

记录位置：`02_卡人（水）/水溪_整理归档/执行日志/` 下 `YYYY-MM-DD_研讨会_主题.md`

---

## 八、智能任务路由

```
用户任务 → 查 SKILL_REGISTRY.md → 匹配技能 → 确定成员 → 执行
│
├── 找不到匹配 → 大总管按领域判断分配给最接近的负责人
└── 多技能匹配 → 按 金→水→木→火→土 优先级
```

用户可用 `@角色名` 或 `@成员名` 覆盖自动路由。

---

## 九、经验沉淀流程

```
对话中发现可沉淀内容
    ↓
自动捕捉 → 提示用户确认
    ↓
存入 02_卡人（水）/水溪_整理归档/经验库/待沉淀/
    ↓
每周卡人(水)整理 → 移入 已整理/（按分类）
    ↓
同类经验 ≥3 条 → 卡土(土)生成新 Skill → 已转化/
    ↓
新 Skill 注册到 SKILL_REGISTRY.md
```