256 lines
7.6 KiB
Markdown
256 lines
7.6 KiB
Markdown
# 卡若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
|
||
```
|