RAFA agent 方案的主入口仓库（openrafa）。从这里了解策略：什么场景用哪个 agent、各组件如何共享同一个 skill 目录、以及如何从零安装整套方案。
先快速开始：
docs/install-from-scratch.zh-CN.md（English）或下面的一行命令。安装文档讲「怎么做」；工具分层 讲「为什么」。
RAFA 提供一套多工具 agent 方案。不用单一运行时，而是按优势分层使用四种工具，共用同一个 共享 skill 目录（~/.agents/skills/）——skill 只装一次，处处可用。
| 工具 | 在方案中的角色 | 什么时候用它 |
|---|---|---|
| opencode | 主编码运行时，profile 驱动 | 结构化编码、slash commands、项目 agent |
| pi | 轻量独立 agent | 快速问答、随手写码、脚本化 -p 执行 |
| omp | 带 skills + memory 的完整 harness | 笔记 / wiki / 知识工作、长会话 |
| oh-my-openagents（OMOS） | 编排 + 模型路由 | 多 agent 拆解、模型分级、成本控制 |
四种工具都从 ~/.agents/skills/ 读取 skill —— 这就是共享依赖层：仓库负责装进去，agent 负责读出来。
| 层 | 作用 | 来源 | 安装位置 |
|---|---|---|---|
| 共享 skills | 所有 agent 共用的 skill 目录 | opencode-obsidian-wiki + opencode-writing-skills | ~/.agents/skills/ |
| Command kit | Slash commands + agent persona | opencode-command-kit — 改编自 waybarrios/opencode-power-pack | ~/.config/opencode/ |
| Skill runtime | 按 skill 的 Python venv | opencode-skill-runtime — RAFA 自研 | ~/.config/opencode/.scripts/（或 vault .scripts/） |
| Wiki skills | Vault 工作流，21 个 skill | opencode-obsidian-wiki — fork 自 AgriciDaniel/claude-obsidian；借用 Karpathy llm-wiki + kepano/obsidian-skills 思路 | ~/.agents/skills/wiki* |
| Writing skills | 中英文去 AI 痕迹 | opencode-writing-skills — vendored from blader/humanizer + op7418/Humanizer-zh | ~/.agents/skills/humanizer* |
示例全是占位符。这不是某个人 live 配置的备份。provider / MCP / 插件请自行配置。
二次使用或再 fork 时请致谢上游：
| 部分 | 关系 | 上游 |
|---|---|---|
| OMOS | 依赖，装上游 | https://github.com/code-yeongyu/oh-my-openagent |
| 多数 slash commands | 改编 / 衍生，MIT | https://github.com/waybarrios/opencode-power-pack |
| Power-pack 谱系 | Anthropic skill 工作流移植 | https://github.com/anthropics/skills · https://github.com/anthropics/claude-code |
| Wiki skill 包 | Fork 自 | https://github.com/AgriciDaniel/claude-obsidian |
| Wiki 模式 | 借用思路，claude-obsidian 与本套件背后 | https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f |
| Obsidian substrate | 借用思路 / 优先上游 | https://github.com/kepano/obsidian-skills |
| Defuddle CLI | 外部工具 | https://github.com/kepano/defuddle |
venv-manager.sh |
为本套件编写 | Cyame / openrafa |
本地 git 类命令（commit、simplify…） |
OpenCode 移植 | command-kit 归属 |
写作 skills（humanizer、humanizer-zh） |
Vendored from | https://github.com/blader/humanizer · https://github.com/op7418/Humanizer-zh |
一条命令初始化整套方案（commands、共享 skills、skill 运行时、可选 OMOS）：
bash <(curl -fsSL https://raw.githubusercontent.com/openrafa/RAFA/main/get-started.sh)或走手动路径：docs/install-from-scratch.zh-CN.md。装完后读 docs/tool-layering.zh-CN.md 把工具映射到场景。
| 仓库 | Remote | 安装位置 |
|---|---|---|
| opencode-methodology（本仓库） | openrafa/opencode-methodology | 仅文档 |
| opencode-command-kit | openrafa/opencode-command-kit | ~/.config/opencode/ |
| opencode-skill-runtime | openrafa/opencode-skill-runtime | ~/.config/opencode/.scripts/ |
| opencode-obsidian-wiki | openrafa/opencode-obsidian-wiki | ~/.agents/skills/ |
| opencode-writing-skills | openrafa/opencode-writing-skills | ~/.agents/skills/ |
- 共享优先于专属： 公共依赖（
skills/、commands/）放在所有 agent 都能读的地方——~/.agents/skills/是唯一 skill 源。 - 按场景分层，不绑定单一工具： 按场景选运行时；profile（
opencode.*.json）让同一个运行时按模式切换（clean / OMOS / power-pack / ponytail）。 - 项目规则只用
AGENTS.md；把运行时称作 Agent，不叫某个厂商产品名。 - 发布示例，不发布私有运行时状态。Provider、模型路由、vault 路径保持个人化。
- 中英文文档一视同仁；语言切换链接 EN↔ZH。
| 主题 | English | 中文 |
|---|---|---|
| 从零安装 | install-from-scratch.md | install-from-scratch.zh-CN.md |
| 工具分层（pi / omp / opencode / omo） | tool-layering.md | tool-layering.zh-CN.md |
| 理念 | philosophy.md | philosophy.zh-CN.md |
迁移 / AGENTS.md |
migration-guide.md | migration-guide.zh-CN.md |
| OMOS / oh-my-openagents | omos.md | omos.zh-CN.md |
| 组件 | component-matrix.md | component-matrix.zh-CN.md |
| Wiki 概览 | wiki-workflows.md | wiki-workflows.zh-CN.md |
| Python 运行时 | python-skill-runtime.md | python-skill-runtime.zh-CN.md |
| 案例研究（可选） | case-study.md | case-study.zh-CN.md |
MIT License — Copyright (c) 2026 Cyame。见 LICENSE。
不要发布 live opencode.json、oh-my-openagent.json、auth 文件、本地 vault 路径或 provider 凭证。examples/ 只放占位符。