# opencode-quickstart

**Repository Path**: coxio/opencode-quickstart

## Basic Information

- **Project Name**: opencode-quickstart
- **Description**: AI 编程宝藏组合 OpenCode + Oh My OpenCode 完整上手攻略
- **Primary Language**: Python
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-21
- **Last Updated**: 2026-02-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# opencode-quickstart
Simplified Chinese(zh_CN)

| Agent 名称 | 使用模型 | 角色定位 | 主要职责说明 |
|------------|----------|----------|--------------|
| Hephaestus | anthropic/claude-opus-4-5 | 自主深度工作者 | 目标导向，只给高层次目标；先并行探索代码库与资料（explore/librarian）；精确匹配现有代码风格；生成最小化、精准代码；端到端完成任务，包括验证与证据闭环。|
| Prometheus | anthropic/claude-opus-4-5 | 战略规划者 | 通过"访谈式"交互澄清需求，逐步生成详细、可执行的工作计划；强调全局目标、阶段划分与资源配置。 |
| Sisyphus | anthropic/claude-opus-4-5 | 默认主控 / 编排器 | 系统默认的任务编排中枢，负责整体规划、任务拆解、子 Agent 调度与并行执行；采用 Todo 驱动工作流，支持长上下文深度思考（32k），在主模型不可用时自动多级降级切换。 |
| Atlas | anthropic/claude-opus-4-5 | 主控 / 执行编排器 | 工作流执行中枢，通过 `/start-work` 命令激活。负责管理整个任务生命周期：混合 Categories 和 Skills 为每个子任务部署最高效的 Agent； obsessive verification（执着验证）每一步执行结果，失败时自动恢复并重试。|
| oracle | openai/gpt-5.2 | 架构顾问 / 代码审查 | 提供高质量的架构设计建议、代码审查与疑难调试分析；只读咨询角色，不直接执行任务，偏重严谨逻辑与系统性推理，定位类似 AmpCode 风格的"技术裁判"。 |
| librarian | zai-coding-plan/glm-4.7 | 资料专家 / 代码库分析 | 擅长多仓库分析、文档检索、开源实现考证；能够结合代码与文档给出有证据支撑的结论，适合理解"为什么现在是这样实现的"。 |
| explore | anthropic/claude-haiku-4-5 | 快速探索 / 代码检索 | 用于高速扫描代码库、上下文定位与类 grep 行为；适合快速理解项目结构、接口分布与策略定义，强调速度与覆盖面。 |
| multimodal-looker | google/gemini-3-flash | 多模态分析专家 | 专注于 PDF、图片、图表、示意图等视觉内容的解析与信息抽取；在涉及文档视觉结构或非纯文本输入时优先使用。 |
| Metis | anthropic/claude-opus-4-5 | 规划前分析顾问 | 在正式制定计划前进行审视，识别隐藏意图、歧义点、潜在失败模式与 AI 易误判区域，属于"计划前的风控层"。 |
| Momus | openai/gpt-5.2 | 计划评审 / 质量控制 | 对既定计划进行审查，重点评估清晰度、可验证性与完整性，指出逻辑漏洞或不可执行之处，确保计划可落地。 |
| （Invoking）@oracle | 同 oracle | 显式调用接口 | 当用户显式请求时，用于对设计或实现方案进行架构级评审与技术判断。 |
| （Invoking）@librarian / @explore | 同各自 Agent | 显式调用接口 | 允许用户直接指定进行实现考证（@librarian）或策略/代码快速定位（@explore），绕过主控自动调度。 |

[Oh-My-OpenCode 3.2.1从新手到专家完整操作手册](https://mp.weixin.qq.com/s/SrS0LxzDyC-0Dv9nbXUcYg)

[AI 编程宝藏组合 OpenCode + Oh My OpenCode 完整上手攻略](https://mp.weixin.qq.com/s/pLeM11jHnM3EjPfFNy4WXA)

## 一、Oh-My-OpenCode 3.0 到底升级了什么？一句话：架构换代
3.0 不是“多了几个命令”，而是把工作流从“写prompt”升级成“工程编排”。
核心总结:
- Hephaestus：自主深度工作者（目标导向，只给高层次目标；先并行探索代码库与资料（explore/librarian）；精确匹配现有代码风格；生成最小化、精准代码；端到端完成任务，包括验证与证据闭环）
- Prometheus：战略规划者（先把需求问清楚）
- Atlas：总指挥官（负责拆解、调度、验证）
- Sisyphus：执行者（真正写代码、跑命令、改文件）

### 1. Prometheus 让“需求不清”不再是 AI 的锅
以前你用 AI 编程，经常出现这种情况：

你说：“帮我把登录流程优化一下”

它回：“好的，我给你加个缓存。”

你心里：“我特么说的是安全、风控、验证码、设备绑定……”

这不是模型笨，是你没把需求说清楚。

#### 1.1 Prometheus 的价值：先“面试”你，再动手
Prometheus 的定位就是：像一个资深技术负责人一样，先把需求问清楚再输出计划。
你可以这样用它（示例写法）：
```sh
@prometheus 我需要把现有的登录模块改成支持：短信登录、邮箱登录、第三方 OAuth。
请先帮我把需求拆清楚，列出风险点和迁移步骤。
```
Prometheus 会做的事通常包括：
- 把需求拆成明确的功能列表
- 追问边界条件（老系统怎么迁？数据怎么兼容？）
- 给你一个可执行的计划
这一步做对了，后面 Atlas 和 Sisyphus 才能真正“像团队一样干活”。

### 2. Atlas 把 AI 从“建议者”变成“项目经理 + QA”

#### 3.0 里最关键的命令就是：
```sh
/start-work
```
PDF 里明确说 Atlas 是“总指挥官”，接管整个任务生命周期：拆解、分配、持续验证。

#### 2.1 Atlas 到底解决什么问题？
我见过太多人用 AI 的方式是：
- AI 写一段
- 你复制粘贴
- 报错了再问
- 再复制粘贴

这不是协作，这是“人工搬运”。

Atlas 的思路是：
- 先拿到计划（Prometheus）
- 再拆成任务卡片
- 每个任务派给最合适的 agent
- 干完还要验收，不通过就返工
换句话说：它把AI从“能写代码”升级成“能交付任务”。

### 3. Sisyphus 不再闷头写，它会主动委派和求助
Sisyphus 是“执行者”，但 3.0 对它做了大量 prompt 优化：更主动、更会求助、更会委派。

这点很重要，因为真实项目里永远存在：

- 不确定的需求
- 不熟悉的代码
- 复杂的依赖关系
- 大量重复劳动（Lint、格式化、迁移）

一个只会“闷头写代码”的 agent 很快就卡死。
一个会求助、会拆分、会找工具链的 agent 才能把活干完。

## 二、安装 / 使用示例
```sh
npm i -g opencode-ai@latest
npx oh-my-opencode install
```
### 快速开始
用oh-my-opencode.json/opencode.json配置 替换默认配置
### 使用
```sh
# 激活完整功能
帮我分析这个项目的架构，ultrawork

# 使用简写
重构这个模块，ulw

# 调用架构师
@oracle 审核这个设计并提出架构方案

# 调用研究员
@librarian 说明这是如何实现的——为什么行为总在变化？

# 调用探索者
@explore 查询这个功能的策略
@oracle 请先设计整体微服务架构图和数据库 schema
@librarian 请搜索项目中所有与支付相关的代码，总结现有逻辑和潜在风险
@frontend-ui-ux-engineer 请实现一个现代的响应式侧边栏，支持折叠和动态路由
```



































bunx oh-my-opencode install --no-tui --claude=no --chatgpt=no --gemini=no
bunx oh-my-opencode install --no-tui --claude=yes --chatgpt=yes --gemini=yes