# 推荐方式：官方安装脚本
curl -fsSL https://opencode.ai/install | bash

# 或通过 npm
npm install -g opencode-ai

# 或通过 Homebrew（macOS）
brew install anomalyco/tap/opencode

# 前提：OpenCode 已安装

# 方式一：npx 安装（推荐）
bunx oh-my-opencode install

# 方式二：npm 全局安装
npm install -g oh-my-opencode

~/.config/opencode/
├── opencode.json                    # OpenCode 主配置（加载 oh-my-openagent 插件）
├── opencode.json.backup-*           # 配置自动备份
├── oh-my-openagent.json             # OhMyOpenCode 代理编排配置
├── oh-my-openagent.json.bak.*       # 旧配置备份
└── oh-my-openagent.json.migrations.json  # 迁移记录

~/.local/share/opencode/
├── auth.json                        # API 密钥存储
├── opencode.db                      # 会话数据库
├── log/                             # 会话日志
└── storage/                         # 持久化状态

~/.cache/oh-my-opencode/
├── connected-providers.json         # 已连接提供商
├── model-capabilities.json          # 模型能力数据（890KB）
└── provider-models.json             # 提供商模型列表（5.6MB）

~/.opencode/
└── skills/                          # 用户自定义技能（可选）
    └── my-skill/
        └── SKILL.md

# 查看版本
opencode --version

# 启动 TUI
opencode

mkdir my-new-project
cd my-new-project
opencode

/init-deep

my-new-project/
├── AGENTS.md                       # 全局架构与约定
├── src/
│   ├── AGENTS.md                   # src 级规范
│   └── components/
│       └── AGENTS.md               # 组件级详细说明
├── backend/
│   └── AGENTS.md                   # 后端规范
└── docs/
    └── AGENTS.md                   # 文档规范

ultrawork

ulw

# 在 TUI 中用自然语言描述需求
我想做一个 React + TypeScript 的任务管理应用，
包含登录注册、看板视图、拖拽排序功能。

{
  "$schema": "https://opencode.ai/config.json",
  // 项目级别的 AGENTS.md 会自动加载，也可手动指定额外指令文件
  "instructions": [
    "CONTRIBUTING.md",
    "docs/coding-style.md"
  ],
  "permission": {
    "edit": "ask",    // 编辑前询问
    "bash": "ask"     // 执行命令前询问
  }
}

{
  "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/dev/assets/oh-my-openagent.schema.json",
  "agents": {
    "sisyphus": { "model": "deepseek/deepseek-v4-pro" }
  },
  "categories": {
    "quick": { "model": "deepseek/deepseek-v4-flash" }
  }
}

1. 进入空目录 → opencode 启动
2. /init-deep           ← 自动生成 AGENTS.md 上下文
3. 用自然语言描述项目需求（越详细越好）
4. ultrawok（或 ulw）   ← 一键全自动开发
5. 阶段性检查 → 继续 ulw 修正
6. 项目完成

cd /path/to/existing-project
opencode

# 项目名称

## 项目概述
- 技术栈：Next.js 14 + TypeScript + Prisma + PostgreSQL
- 部署：Vercel + Railway

## 关键命令
- 开发服务器：`npm run dev`
- 构建：`npm run build`
- 类型检查：`npx tsc --noEmit`
- 测试：`npx vitest run`
- Lint：`npx eslint src/`

## 代码规范
- 使用 TypeScript strict 模式
- ESM 导入（禁止 require()）
- 组件使用 PascalCase，工具函数使用 camelCase

## 架构要点
- 页面路由在 `app/` 目录（App Router）
- 共享组件在 `components/`
- API 路由在 `app/api/`
- 数据库 schema 在 `prisma/schema.prisma`

## 禁止触碰的文件
- `prisma/migrations/` 下的迁移文件
- `public/generated/` 下的构建产物
- `.env` 文件

/init-deep

{
  "instructions": [
    "CONTRIBUTING.md",
    "docs/architecture.md",
    ".cursor/rules/*.md"      // 兼容 Cursor 规则文件
  ]
}

这个组件有个 bug，点击按钮后状态没有更新，帮我排查。

帮我在 src/api/ 下新增一个用户管理模块，包含 CRUD 接口。

/start-work

ulw
# 或
ultrawork

# NewProductApproval - 新产品审批系统

## 技术栈
- 后端：Java 8、Spring Boot 2.7.x、MyBatis-Plus
- 数据库：MySQL
- 缓存：Redis

## DDD 四层架构
- adapter/   - 适配层（Controller、DTO、事件监听）
- application/ - 应用层（ApplicationService、事件发布）
- domain/    - 领域层（Entity、ValueObject、DomainService、Repository 接口）
- infrastructure/ - 基础设施层（Repository 实现、外部 API 调用）

## 构建命令
- 编译：`mvn clean compile`
- 测试：`mvn test -pl backend`
- 启动：`mvn spring-boot:run -pl backend`

## 重要约定
- 所有 API 返回统一包装类 R<T>
- 异常统一使用 GlobalExceptionHandler 处理
- 领域层禁止引入 Spring 依赖
- 数据库操作必须通过 Repository 接口

Explore #1: 搜索认证中间件实现
Explore #2: 搜索 Token 生成和验证逻辑
Explore #3: 搜索登录/注册处理器
Explore #4: 搜索权限控制模式

# 不要这样问（太模糊）
"React 怎么用？"

# 应该这样问（具体、有上下文）
"在我的 Next.js 项目中，如何在 Server Component 中调用 Prisma
进行分页查询？需要处理排序和搜索过滤。"

# 在 TUI 中
@oracle 分析一下当前项目的数据库分库分表方案是否合理，
考虑到我们的业务增长预期是 QPS 从 1000 到 10000。

/start-work

# 用户输入
"首页加载很慢，帮我排查一下性能问题。"

# 用户输入
"项目要用 WebSocket 做实时通知，帮我调研一下技术方案。"

# 启动 TUI
opencode

# 直接执行一条指令
opencode run "修复 src/auth.ts 的类型错误"

# 初始化项目
opencode init

# 启动 Web 服务
opencode web

# 管理会话
opencode session list
opencode session resume <id>

# 创建代理
opencode agent create

# 查看统计
opencode stats

---
description: 代码审查专家，检查代码质量和最佳实践
mode: subagent
model: anthropic/claude-sonnet-4-5
temperature: 0.1
permission:
  edit: deny
  bash: deny
---

你是代码审查专家。审查时关注：
- 代码质量和最佳实践
- 潜在 Bug 和边界情况
- 性能影响
- 安全考虑

{
  "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/dev/assets/oh-my-openagent.schema.json",

  // 覆盖特定代理的模型
  "agents": {
    "sisyphus": {
      "model": "deepseek/deepseek-v4-pro"
    },
    "oracle": {
      "model": "openai/gpt-5.4",
      "variant": "high"
    }
  },

  // 覆盖类别模型映射
  "categories": {
    "quick": { "model": "deepseek/deepseek-v4-flash" },
    "deep": { "model": "deepseek/deepseek-v4-pro" },
    "visual-engineering": { "model": "google/gemini-3.1-pro", "variant": "high" }
  },

  // 禁用不用的代理
  "disabled_agents": ["momus"],

  // 禁用不用的 MCP
  "disabled_mcps": ["grep_app"],

  // 禁用不用的技能
  "disabled_skills": ["ai-slop-remover"]
}

{
  "model_fallback": {
    "enabled": true,
    "rules": [
      {
        "provider": "deepseek",
        "fallback": "minimax/minimax-m2.7"
      }
    ]
  }
}

---
name: my-custom-skill
description: 项目特有的代码生成规则
---

# My Custom Skill

## 适用场景
当用户要求生成数据库迁移文件时使用。

## 规则
1. 所有迁移文件必须包含 up 和 down 方法
2. 表名使用复数形式
3. 外键必须显式命名

## 命令约束
- 迁移只能通过 `npx prisma migrate dev` 执行
- 禁止手动编辑 `prisma/migrations/` 下的文件

my-project/
├── opencode.json                        # 项目级 OpenCode 配置
├── AGENTS.md                            # 全局项目上下文
├── .opencode/
│   ├── oh-my-openagent.jsonc            # 项目级 OhMyOpenCode 配置
│   ├── agents/                          # 自定义代理定义
│   │   └── code-reviewer.md
│   ├── commands/                        # 自定义斜杠命令
│   │   └── deploy.md
│   ├── skills/                          # 自定义技能
│   │   └── my-custom-skill/
│   │       └── SKILL.md
│   └── themes/                          # 自定义 UI 主题
├── src/
│   ├── AGENTS.md                        # src 级上下文
│   └── components/
│       └── AGENTS.md                    # 组件级详细说明
├── backend/
│   └── AGENTS.md                        # 后端上下文
└── docs/
    └── coding-style.md                  # 被 opencode.json 引用的规则文件