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 清单和变更摘要