Opencode Omo

核心用法

opencode-omo 是一套围绕 OpenCode 运行时的编程工作流操作指南，核心依赖 Oh-My-OpenCode 插件及其三大代理角色：

| 代理 | 职责 | 触发方式 |

|------|------|----------|

| **Prometheus** | 复杂任务规划 | `@plan "..."` |

| **Atlas** | 计划执行 | `/start-work` |

| **Sisyphus** | 迭代与 one-shot 交付 | `ulw "..."` 或 `opencode --agent sisyphus` |

三种启动模式：
1. 极速模式：opencode run --agent sisyphus "ulw [具体请求]" —— 单轮完成聚焦式编码
2. 交互模式：opencode --agent sisyphus 后使用 @plan + /start-work 分阶段协作
3. 脚本封装：项目内置 ./scripts/run-ulw.sh 和 check-omo.sh 降低使用门槛

显著优点

• 角色分离清晰：规划、执行、迭代三者解耦，避免单代理"边想边做"的混乱
• one-shot 交付：ulw（ultrawork）指令将自然语言需求直接转为可运行代码+测试
• 质量一致性：通过 opencode.json 配置和可复现脚本确保跨环境输出稳定
• 生态集成：与 agent-selfie、gemini-image-gen、agentgram 等技能形成工作流闭环

潜在局限

• 外部依赖重：必须预装 opencode CLI、git、clawhub 及 Oh-My-OpenCode 插件，新环境配置成本较高
• 交互中断风险：Sisyphus 执行中途可能抛出澄清问题，需手动切回 Prometheus 模式重新规划
• 确定性边界：复杂任务仍需人工介入拆分，过度依赖 ulw 可能导致上下文溢出
• 闭源生态锁定：核心代理逻辑托管于 ClawHub，长期可移植性存疑

适合人群

• 已使用 OpenCode CLI 的开发者，寻求结构化代理协作
• 需要"需求→代码→测试"快速闭环的原型团队
• 希望统一代码风格、减少个人习惯波动的工程组织

常规风险

• 配置漂移：~/.config/opencode/opencode.json 若被误改，代理行为将不可预测
• 凭证泄露：ulw 指令可能携带敏感业务逻辑，需注意 shell history 清理
• 版本错配：插件与 CLI 版本不兼容时，@plan 等指令可能静默失效
• 过度自动化：对安全关键代码（如加密、支付）不建议无人值守执行