Skip to content

tool-layering.zh-CN.md

Latest commit

 

History

History
78 lines (53 loc) · 4.39 KB

tool-layering.zh-CN.md

File metadata and controls

78 lines (53 loc) · 4.39 KB
Raw

工具分层：pi / omp / opencode / omo

Language: English · 中文

RAFA 方案刻意做成多工具：没有一个运行时能包打天下，所以方案按优势分层使用四种工具、按场景路由。它们共享同一个依赖层——~/.agents/skills/——skill 只装一次，处处可用。

四层

1. opencode — 主编码运行时，profile 驱动

一个二进制，多套 profile。每个 profile 是一对配置（opencode.*.json + tui.*.json），由启动器选择。Profile 把插件实验隔离：某个 profile 的插件坏了，不影响其他 profile。

Profile 配置对 插件 用途
oc（默认） opencode.json + tui.json 无 干净运行、隔离插件问题
oc-omo opencode.omo.json + tui.omo.json oh-my-openagent@latest 编排式多 agent 工作
oc-super opencode.super.json + tui.super.json opencode-power-pack + superpowers power-pack / superpowers 工作流
oc-vanilla opencode.vanilla.json + tui.vanilla.json @dietrichgebert/ponytail 最小插件、快速启动

启动器 wrapper 每次显式导出 OPENCODE_CONFIG / OPENCODE_TUI_CONFIG，避免 shell 里残留的 export 悄悄换 profile。wrapper 写法见 examples/zsh-profiles.example。

2. pi — 轻量独立 agent

用于快速会话：pi "总结一下"、脚本化 pi -p、随手写码。读同一份 ~/.agents/skills/。扩展以 npm 包安装（pi install npm:@dietrichgebert/ponytail）。

3. omp — 带 skills + memory 的完整 harness

用于长会话、记忆密集的工作：wiki / 笔记 / 知识工作、迭代式调研。加载同一套共享 skills，按 agent 保存状态（~/.omp/agent/）。

4. omo / oh-my-openagents — 编排 + 模型路由

不是直接敲命令的运行时，而是 opencode（oc-omo）里的路由插件：把模型分级、把任务拆解。按 profile 保存配置（~/.omo/omo.jsonc），为 agent 角色和任务分类分配模型档位。可保存多套 profile（omo.jsonc.<tag>），用 switcher 把当前激活的一份拷贝到位。详见 omos.md 和 examples/oh-my-openagent.json.example。

共享依赖层：~/.agents/skills/

~/.agents/
├── .skill-lock.json        # 安装元数据（来源、版本、hash）
└── skills/
    ├── wiki*               # 21 个 wiki skills（opencode-obsidian-wiki）
    ├── humanizer           # 英文写作 skill
    ├── humanizer-zh        # 中文写作 skill
    └── ...                 # 你安装的第三方 skills

每个工具都读这个目录，所以 skill 的安装/升级只做一次：

bash scripts/install.sh            # 任意 skill 仓库 → 合并进 ~/.agents/skills/
bash scripts/install.sh --prune    # 干净重装该仓库的 skills

Skill 不再放进某个工具的私有配置目录——那是旧的单工具布局（~/.opencode/skills/）。迁移方式：重跑各仓库的安装脚本，其它什么都不用改。

场景路由

场景 用哪个 为什么
结构化编码、PR review、feature 开发 opencode / oc slash commands、agents、项目上下文
多 agent 编排、深度调研 oc-omo OMOS 拆解任务并按模型档位路由
power-pack 工作流、superpowers oc-super 这两个插件的原生模式
快速问答、脚本化运行、一次性修改 pi -p 轻量，无会话开销
wiki / 笔记 / 知识工作、长会话 omp memory + skills + harness 状态
模型档位 / 成本调优 omo profile 切换 use-omo-<tag> 换路由配置

Provider 可用性比偏好更重要：如果廉价档位只在某家 provider 上有，那 omo profile 就由它决定。各 profile 的 provider 在你的个人 opencode.*.json 里配。

哪些保持个人化

  • opencode.json[c] / opencode.*.json — provider、MCP、插件
  • ~/.omo/omo.jsonc — 模型路由（仓库只发布 examples/）
  • vault 路径与凭证 — 放在你的私有 AGENTS.md 或配置里

另见