OpenCode + OMO 工作流 · 入门到精通教程

2026-07-11

一句话摘要：这份文档教你把一套“别人调教顺手的 AI 编程方案”，拆成 5 个能循序渐进的阶段——先练想清楚需求的心法，再逐步加工具，最后才碰最重的多智能体编排。每一步都能拿到收益，不会被配置和名词劝退。

这套方案是什么（先看懂全貌）

你要学的方案，原文是这样写的：

我自己的 mimo 使用方案：
* opencode + oh my open agent
* openspec + grill-me + to-prd + code-review + /ultrawork

它其实是两个层次拼在一起：

第一行 = 运行环境（用什么 agent 跑）
第二行 = 工作流（按什么流程做事）

⚠️ 三个必须先纠正的认知

在开始之前，有三点是我交叉查证后发现、和字面理解不一样的地方，先记住能少走弯路：

1. grill-me / to-prd 不属于 openspec。 它们是另一个人（前 Vercel 工程师 Matt Pocock）做的一套 skills。原文方案本质是把两个不同项目拼着用。

2. to-prd 已经改名了（已核对官方仓库目录树确认）。 /to-prd → /to-spec、/to-issues → /to-tickets——旧路径在仓库里已 404，只剩新名。本文正文用新名，保留旧名对照。验证方法：装到 opencode 后查 ~/.config/opencode/skills/（不是 ~/.claude/skills，那是 Claude Code 的路径）。

3. openspec 和 to-spec 不是冗余，是上下游。 我一开始以为它们职责重叠，查证后发现是接力关系（下面工具地图会画清楚）。

mimo 是什么

mimo = 小米开源的大模型（MiMo 系列）。它在这套方案里扮演“驱动 agent 的模型”这个角色。整套方案的隐含卖点是：用相对便宜/开源的模型 + 强编排，去接近闭源大模型的效果。 所以成本控制在后面是个重点。

前置条件（开动前先备齐）

阶段 0、1 零安装，跳过本节即可。从阶段 2 起需要下面这些：

⚠️ 同名混淆：本文的 opencode 指 sst 家的终端 AI agent（包名 opencode-ai），不是某个同名 VSCode 插件。别装错。

工具地图：每个部件属于谁、在哪一步用

这是全文最重要的一张表，看懂它整套方案就通了：

两条流水线怎么接起来

Pocock 生态（想清楚需求）              OpenSpec（把需求变成可实现的规格 + 代码）
grill-me → to-spec → to-tickets   ─→   /opsx:propose → /opsx:apply → /opsx:archive
  拷问     出 spec    拆任务               提案          实现          归档
                                    ↑
                             全程跑在 opencode + OMO 上，
                             用 ultrawork 触发多 agent，code-review 兜底

一句话：先用 Pocock 的技能把需求磨清楚，再交给 openspec 去做规格化实现，底座是 opencode + OMO。

爬坡路线总览

阶段 0  心法      ── 理解"为什么"          （0 安装，今天就能开始）
阶段 1  纯流程    ── 在现有 AI 里练"规格先行" （0 安装，最高性价比）
阶段 2  底座      ── 装 opencode + slim 精简版
阶段 3  规格链    ── 上 grill-me + to-spec + openspec
阶段 4  全编排    ── 完整 OMO + /ultrawork + code-review
精通    调教      ── 自定义 agent + 成本控制

核心原则：先练心法，再加工具，最重的多 agent 编排放到最后。 每个阶段都有“过关标准”，不过关别往下走。

阶段 0 · 心法（0 安装，先想通）

目标：理解这套流的底层逻辑，否则工具装了也用不对。

一句话记住：

AI 编程最大的坑，不是“AI 写不出代码”，而是“AI 顺着你模糊的需求瞎写”。

这套方案所有的前置动作，都在解决同一件事——在写码前把需求想清楚。把这个顺序背下来：

想清楚（规格）→ 被拷问（补漏）→ 定稿（PRD）→ 写码 → 审查

✅ 过关标准：你能用自己的话说出“为什么要在写码前折腾这么多文档”。

阶段 1 · 纯流程练习（0 安装，最高性价比）

目标：不碰任何新工具，就用你手边现有的 AI，把流程跑顺。

这一步是整份教程性价比最高的一步。因为后面所有工具，本质都是把这个流程自动化——心法没建立，工具就是负担。

怎么做

找一个你真实想做的小功能（别用玩具例子），然后：

1. 写规格：用 3–5 句话描述“要做什么、给谁用、成功长什么样”。
2. 让 AI 拷问你：直接说“针对这个需求，反过来问我 5 个最容易被忽略的问题”。→ 这就是 grill-me 的精神手动版。
3. 定稿：把问答整理成一小段 PRD。→ 这就是 to-spec 的手动版。
4. 再让 AI 写码，最后让它自我审查一遍。→ code-review 的手动版。

为什么这样练

你在阶段 1 手动做的每一步，都对应后面的一个工具。先练手动版，以后装工具就是“把已经会的习惯自动化”，完全无缝。

✅ 过关标准：你亲身感受到“被拷问后再写码” vs “上来就写码”的质量差距。这一步不过关，别往下走。

阶段 2 · 装底座（第一次动手安装）

目标：让 opencode 在你机器上跑起来，并用精简版感受多 agent。

步骤

1. 装 opencode（sst 家的开源终端 AI agent）：

   # 三选一
   curl -fsSL https://opencode.ai/install | bash   # 官方脚本，最简单
   npm i -g opencode-ai@latest                       # npm
   brew install sst/tap/opencode                     # macOS Homebrew

   装完认证：opencode auth login（或设 OPENROUTER_API_KEY 等环境变量）。
2. 先装精简版 oh-my-opencode-slim（alvinunreal 维护），不要直接上完整版——门槛低一个数量级：

   bunx oh-my-opencode-slim@latest install          # 交互式

3. 随便丢个小任务，观察它怎么“分派给不同 agent”。

说明：slim 是第三方瘦身分支（非 code-yeongyu 官方版），定位“更省 token、默认非破坏性”，适合入门先感受。完整版在阶段 4 再装。

⚠️ 安全红线（重要）

OMO 有一个假冒的“官方”付费网站在骗钱。

• ✅ 官方发布只在 GitHub：code-yeongyu/oh-my-openagent（旧名 oh-my-opencode）
• ❌ 任何“官网”要你输支付信息，一律是骗局

关于 OMO 的 agent 团队

完整版 OMO 自带一支专职 agent 团队，用神话名字命名，各配合适的模型和限定的工具权限。下表分工摘自官方 overview 文档（非推测）：

阶段 2 你用 slim 版先不用记这些名字，感受“多 agent 协作是什么体验”即可。

✅ 过关标准：能跑通一个完整任务，大致看懂“哪个 agent 在干什么”。

阶段 3 · 规格链上线（把阶段 1 的习惯工具化）

目标：用 grill-me + to-spec + openspec，把“规格先行”从手动变自动。

步骤

1. 装 grill-me / to-spec（Matt Pocock 的 skills）：

   npx skills@latest add mattpocock/skills
   # 装完运行 /setup-matt-pocock-skills 配置 issue tracker 与文档偏好

   • grill-me 极简、零依赖，本质就是几句提示词，上手几乎没门槛。
   • 触发：/grill-me，或直接说 “grill me”；还有个带文档上下文的变体 /grill-with-docs。
2. 装 openspec（Fission-AI）：

   npm install -g @fission-ai/openspec@latest
   openspec init        # 生成 openspec/ 目录并向 AI 工具注册斜杠命令

3. 跑一个真实功能，全程走：

/grill-me（拷问需求）
   → /to-spec（定稿成 spec）
      → /to-tickets（拆成任务，可选）
         → /opsx:propose（提案）→ /opsx:apply（实现）→ /opsx:archive（归档）

openspec 核心命令就是 /opsx:propose、/opsx:apply、/opsx:archive 三个（还有 /opsx:explore 把模糊想法先磨成计划）。更多扩展命令需切到 workflows profile 再 openspec update。

命令名对照（防止你装的版本对不上）

若你装的版本命令名仍是旧的，查实际目录为准：opencode 在 ~/.config/opencode/skills/，Claude Code 在 ~/.claude/skills/。

✅ 过关标准：你能顺畅走完“拷问 → 定稿 → 交给 openspec 实现”，并理解这是一条上下游流水线，不是重复劳动。

阶段 4 · 完整编排（最后才碰最重的）

目标：上完整 OMO，用 /ultrawork 火力全开，code-review 兜底。

步骤

1. 从 slim 升级到完整 oh-my-openagent：

   bunx oh-my-openagent install          # 装到 OpenCode
   bunx oh-my-openagent doctor           # 装完自检

   （要求 OpenCode ≥ 1.4.0；旧名 oh-my-opencode 已弃用，命令用新名。）
2. 在 opencode 里用关键词 ultrawork（别名 ulw）触发多 agent 并行。
3. 每次跑完，固定用 code-review 审查。

⚠️ 两个高发坑

1. 烧钱：多 agent 并行 = token 成倍消耗。第一次跑必须全程盯着消耗量。（这也是为什么 mimo 这种便宜/开源模型在这套方案里有意义。）
2. 失控：agent 越多越难盯住它在干嘛，别一次给太大的任务。

✅ 过关标准：你能预判“这个任务值不值得开 ultrawork”，而不是无脑全开。

精通阶段 · 调教成自己的方案

目标：从“用别人的方案”变成“有自己的方案”（就像原文那位一样）。

三件要做的事

1. 自定义 agent：改模型搭配、工具权限，砍掉你用不上的 agent。比如你从不做视觉任务，就关掉 Multimodal Looker。

2. 成本控制（分层用模型）：这是 mimo 这类便宜/开源模型的用武之地。一个可参考的分层：

   任务类型	模型档位	例子
   侦查 / grep / 简单改动	便宜/开源（如 mimo）	Explore、Librarian 类活
   规划 / 审查 / 复杂调试	贵的闭源大模型	Prometheus、Oracle、code-review
   批量实现	中档，按量权衡	Sisyphus 分派的并行子任务

3. 形成你自己那句“我的 XX 方案”——能一句话说清底座 + 流程。

✅ 过关标准：你能对别人解释“我这套为什么这么配”，尤其是“哪步用便宜模型、哪步用贵的、为什么”。

决策速查：我现在该跑哪个？

装好全套后，遇到一个新需求时按这张表判断从哪起步：

常见坑速查

立即行动建议

别一次装全套。 按这个顺序拿到 80% 的收益：

1. 今天就开始阶段 1：找一个你手头真实的小需求，用“规格 → 拷问 → spec → 写码 → 审查”走一遍——在任何 AI 里都能立刻用上，零安装。
2. 感受到收益后，再进阶段 2 装底座（用 slim）。
3. 顺手了再上规格链（阶段 3），最后才碰完整编排（阶段 4）。

参考来源

（以下命令与分工均于 2026-07-11 核对官方仓库/文档）

• opencode 官方文档：https://opencode.ai/docs/
• oh-my-openagent 安装文档：https://github.com/code-yeongyu/oh-my-openagent/blob/dev/docs/guide/installation.md
• oh-my-openagent overview（agent 分工原文）：https://github.com/code-yeongyu/oh-my-openagent/blob/dev/docs/guide/overview.md
• oh-my-opencode-slim（精简版）：https://github.com/alvinunreal/oh-my-opencode-slim
• OpenSpec README + 命令文档：https://github.com/Fission-AI/OpenSpec/blob/main/docs/commands.md
• mattpocock/skills 仓库（已核对目录树确认 to-prd→to-spec、to-issues→to-tickets）：https://github.com/mattpocock/skills
• grill-me 官方介绍：https://www.aihero.dev/skills-grill-me
• grill-me / to-spec / to-tickets 衔接讨论：https://github.com/mattpocock/skills/issues/102

仍存疑的一点：Matt 的 skills 装到 opencode 后的确切目录，官方 doc 未明写；本文按 opencode 通用约定标注为 ~/.config/opencode/skills/，建议你 npx skills add 后实际确认落地位置。

姊妹文档：这套方案的 Matt Pocock 部分，本库已有更详细的 [[mattpocock-skills 手把手新手教程]] 和 [[openspec-tutorial]]，进阶时可交叉阅读。