OMO Agents - 多代理编排系统
基于 oh-my-opencode 理念的多代理协作系统，让不同专业代理各司其职，协同完成复杂任务。
代理一览
| 代理 | 角色 | 何时调用 | |------|------|----------| | @sisyphus | 主编排者 | 复杂任务规划、多步骤开发、协调其他代理 | | @oracle | 架构顾问 | 架构决策、代码审查、技术选型、调试指导 | | @librarian | 研究员 | 查找文档、研究开源实现、最佳实践挖掘 | | @explore | 搜索专家 | 在代码库中定位代码、追踪依赖、理解结构 | | @frontend-engineer | UI/UX 专家 | 界面设计实现、组件开发、动画交互 | | @document-writer | 文档专家 | README、API 文档、架构文档、注释 | | @multimodal-looker | 视觉分析师 | 图片分析、PDF 提取、图表解读 |
使用方式
直接调用
@oracle 这个架构设计合理吗？[附上架构图或代码]
@librarian Next.js 14 的 Server Actions 怎么处理错误？
@explore 找到处理支付的代码在哪里
@frontend-engineer 创建一个带动画的订阅表单组件
@document-writer 给这个 API 写文档
@multimodal-looker 分析这个错误截图
编排模式
对于复杂任务，使用 @sisyphus 自动编排：
@sisyphus 我要给这个电商项目添加用户评价功能
Sisyphus 会：
1. 分析任务，拆解子任务
2. 启动 @explore 搜索现有相关代码
3. 咨询 @oracle 确定架构方案
4. 请 @librarian 研究评价系统最佳实践
5. 委派 @frontend-engineer 实现评价 UI
6. 安排 @document-writer 编写文档
7. 并行执行独立任务，串行执行依赖任务
代理详情
@sisyphus - 主编排者
擅长:
- 复杂功能开发的任务拆解
- 多代理协调和并行执行
- TODO 驱动的进度追踪
- 在必要时挑战用户需求
工作流程:
Phase 0: 意图判断 → 分类请求类型
Phase 1: 代码库评估 → 理解现有结构
Phase 2A: 探索研究 → 委派 @explore/@librarian
Phase 2B: 实现 → 创建 TODO，并行执行
@oracle - 架构顾问
擅长:
- 架构设计评审和建议
- 技术选型分析
- 代码审查和质量评估
- 复杂问题的调试指导
输出风格:
- 第一层：直接回答（必须）
- 第二层：理由和权衡（按需）
- 第三层：边缘情况（相关时）
@librarian - 研究员
擅长:
- 官方文档和 API 参考查找
- 开源项目实现研究
- GitHub issues/PRs 历史追溯
- 最佳实践总结
三种模式:
- TYPE A: 概念性问题
- TYPE B: 实现参考
- TYPE C: 上下文与历史
@explore - 搜索专家
擅长:
- 在代码库中定位特定代码
- 追踪函数定义和引用
- 理解项目结构
- 搜索特定模式
工具箱:
- glob (文件搜索)
- grep (内容搜索)
- LSP (符号搜索)
- ast-grep (AST 模式搜索)
- git log/blame (历史追溯)
@frontend-engineer - UI/UX 专家
擅长:
- 创建美观的界面组件
- 实现流畅的动画交互
- 响应式设计
- 即使没有设计稿也能创造精美 UI
设计原则:
- 像素级完美
- 动效是灵魂
- 直觉优先
- 大胆而克制
@document-writer - 文档专家
擅长:
- README 编写
- API 文档
- 架构文档
- 用户指南
- JSDoc/注释
写作原则:
- 准确性第一
- 读者导向
- 代码即真相
- 渐进披露
@multimodal-looker - 视觉分析师
擅长:
- 截图分析和信息提取
- PDF 内容解读
- 图表数据提取
- 架构图/流程图解析
- 设计稿分析
核心价值:
- 精准提取关键信息
- 避免上下文 token 浪费
- 结构化输出
最佳实践
1. 选择合适的代理
❌ 问 @frontend-engineer 架构问题
✅ 问 @oracle 架构问题
❌ 让 @oracle 搜索代码
✅ 让 @explore 搜索代码
❌ 让 @librarian 写文档
✅ 让 @document-writer 写文档
2. 提供足够上下文
❌ "@explore 找到那个函数"
✅ "@explore 找到处理用户认证的函数，可能在 auth 或 user 目录下"
❌ "@oracle 这样好吗"
✅ "@oracle 用 Redux 还是 Zustand 管理这个中等规模 React 项目的状态？"
3. 复杂任务用 @sisyphus
简单任务 → 直接调用专业代理
复杂任务 → @sisyphus 编排协调
不确定 → @sisyphus 会帮你判断
代理协作示例
任务: "重构用户模块，改进代码质量"
1. @sisyphus 接收任务，分析范围
2. @sisyphus → @explore
"搜索所有 user 相关的代码文件和依赖"
3. @sisyphus → @oracle
"评审当前用户模块架构，指出问题和改进方向"
4. @sisyphus → @librarian
"研究类似规模项目的用户模块最佳实践"
5. @sisyphus 综合信息，制定重构计划
6. @sisyphus 执行重构
- 核心逻辑：自己处理
- UI 相关：委派 @frontend-engineer
7. @sisyphus → @document-writer
"更新用户模块的 API 文档"
8. 完成，提交 TODO 清单和变更摘要