AgentSkillsCN

Multi Ai

Multi AI

SKILL.md

多AI协调 (Multi-AI Coordination)

概述

VibeCoding 支持多个 AI 引擎协作，通过 .ai_state/ 文件系统实现状态共享和任务交接。

支持的引擎

yaml
配置: orchestrator.yaml → engines

引擎:
  claude:
    优势: 推理、架构、复杂逻辑
    技能: 内置
    
  codex:
    优势: 代码生成、重构
    技能: skills/codex/SKILL.md
    
  gemini:
    优势: 长上下文、多模态
    技能: skills/gemini/SKILL.md

协调架构

code
┌─────────────────────────────────────────────┐
│              orchestrator.yaml               │
│         (引擎配置、路径规则、调度策略)          │
└──────────────────┬──────────────────────────┘
                   │
    ┌──────────────┼──────────────┐
    ▼              ▼              ▼
┌────────┐   ┌────────┐    ┌────────┐
│ Claude │   │ Codex  │    │ Gemini │
└────┬───┘   └────┬───┘    └───┬────┘
     │            │            │
     └────────────┼────────────┘
                  ▼
         ┌───────────────┐
         │  .ai_state/   │
         │ (状态共享层)   │
         └───────────────┘

状态共享

handoff.md - 交接文档

markdown
# AI 交接文档

## 当前状态
- 引擎: claude
- 阶段: Execute
- 任务: 实现用户认证

## 已完成
- [x] 需求分析
- [x] 架构设计
- [x] 任务规划

## 进行中
- [ ] 实现登录 API

## 上下文
### 技术决策
- 认证方案: JWT + Redis
- 框架: Express.js

### 注意事项
- token 过期时间: 24h
- 需要处理刷新逻辑

## 交接给
- 建议引擎: codex (大量 CRUD 代码)
- 任务: 实现 CRUD 接口

共享文件

yaml
状态同步:
  - session.lock: 当前会话
  - active_context.md: 上下文
  - TODO.md: 任务列表
  - kanban.md: 进度状态

知识共享:
  - errors.md: 错误经验
  - knowledge.md: 本地知识

交接协议

交接触发

yaml
触发条件:
  1. 用户显式切换 (/switch codex)
  2. 任务类型更适合其他引擎
  3. 当前引擎遇到限制

不自动切换:
  - 引擎选择权在用户
  - AI 只建议，不强制

交接流程

code
1. 当前引擎完成当前任务
2. 更新 handoff.md
3. 调用寸止 [TASK_DONE] 或 [PHASE_DONE]
4. 建议切换（如需要）
5. 用户确认切换
6. 新引擎读取 handoff.md 恢复

交接清单

markdown
交接前检查:
- [ ] 所有状态文件已更新
- [ ] handoff.md 已写入
- [ ] 当前任务已完成或明确标记
- [ ] 关键上下文已记录

引擎选择建议

Claude 适合

yaml
- 复杂推理
- 架构设计
- 代码审查
- 需求分析
- 问题诊断

Codex 适合

yaml
- 大量样板代码
- CRUD 实现
- 代码补全
- 重复模式生成

Gemini 适合

yaml
- 长文档分析
- 多文件理解
- 图像相关任务
- 大上下文处理

协作模式

串行协作

code
Claude (分析/设计)
    ↓
Codex (代码生成)
    ↓
Claude (审查/优化)

并行协作 (未来)

yaml
注意: 当前版本不支持真正并行
建议: 分任务串行执行

配置示例

orchestrator.yaml

yaml
engines:
  primary: claude
  available:
    - name: claude
      strengths: [reasoning, architecture]
    - name: codex
      strengths: [code-generation]
      skill_path: skills/codex/SKILL.md

multi_ai:
  enabled: true
  coordination_file: .ai_state/handoff.md
  state_sync: .ai_state/

最佳实践

状态一致性

yaml
每次操作后:
  - 更新 kanban.md
  - 更新 active_context.md
  - 必要时更新 handoff.md

交接质量

yaml
好的交接:
  - 上下文完整
  - 决策有记录
  - 待办清晰
  - 注意事项明确

差的交接:
  - 只有代码没有上下文
  - 不清楚做了什么
  - 不知道下一步

冲突处理

yaml
若发现状态不一致:
  1. 以最新时间戳为准
  2. 记录冲突到 errors.md
  3. 必要时请求用户裁决