我的 OpenCode 使用笔记

折腾了这么久，总算把 OpenCode 这套体系给理顺了。这不仅是个工具，简直就是带了一个顶级的专家团队在写代码。为了以后查阅方便，我把这些核心技巧和”坑”都记在这里。

1. 怎么在 VSCode 里优雅地启动？

1. 先装 CLI，然后在集成终端里直接敲 opencode，去vscode中找opencode插件装好。
2. 快捷键：
   • 打开 opencode使用：Ctrl + Shift + P 打开 VSCode 的通用命令面板，输入 open opencode。
   • Alt + Ctrl + K： 选中一段代码后按这个，直接把代码塞进对话框，不用复制粘贴。

2. 基础中的基础

• 多线操作： session 和 new 配合简直无敌，可以同时让不同的智能体帮我跑不同的任务。
• 用上 Gemini：装 opencode-antigravity-auth 插件，就能在 OpenCode 里白嫖 Google Gemini 模型，还包括 claude 模型 原理好像是Antigravity 反代 。

3. “技能包” (Skills) 系统

这玩意儿就像是给 AI 技能包。如果我发现有些任务经常做，我就写个 Skill。

• 注意路径：.opencode/skill/你的技能名/
• 目录结构长这样：
  • SKILL.md (核心：必须要写 frontmatter，定义好 name 和 description)
  • scripts/main.py (自动化逻辑)
  • references/ (参考文档)
  • assets/ (图片等资源)

SKILL.md 示例：

---
name: my-skill
description: 简短描述技能的作用
license: MIT
compatibility: opencode
---

## What I do
- 描述这个技能做什么
- 列出具体功能

## When to use me
使用这个技能的场景说明

• 发现： 只要放在这个目录下，智能体在干活时会自动发现并调用它们，超级省心。

4. oh-my-opencode：开启”懒人”模式

这个插件是我最喜欢的，有两个功能很好用：

1. /ralph-loop：它会进入一个”死磕”模式，自动循环尝试，直到把问题解决掉。
2. **魔法词 ultrawork (或 ulw)**：
   • 只要在 Prompt 里带上 ulw，智能体就像打了鸡血一样，自动开启并行任务、后台搜索、深度代码探索。
   • 例子：ulw 帮我重构这个复杂的支付逻辑 —— 然后他就会自动调用相关的智能体进行操作，下面会介绍每个只能提功能。

5. 7 个智能体

不用 ulw 的情况下，使用 @ 给专门的专家：

• **Sisyphus (总指挥)**：默认就是他。用的是 Claude Opus 4.5，逻辑超强。他最擅长拆解任务和盯着 Todo 列表，没干完绝不收工。
• **oracle (架构师)**：碰到复杂的架构或者解决不了的 Bug，我就叫 @oracle，它用的是 GPT-5.2 的脑子。
• **librarian (知识渊博)**：帮我翻文档、搜 GitHub 开源实现。
• **explore (探路者)**：帮我在代码库里飞快地找东西。根据配置不同，它会用 Gemini 3 Flash、Claude Haiku 或 Grok。
• frontend-ui-ux-engineer：UI 开发找它，写出来的界面确实比我写的好看（用的是 Gemini 3 Pro）。
• document-writer：我现在的这份文档，找它润色最合适了（用的是 Gemini 3 Flash）。
• multimodal-looker：给它发截图或 PDF，它能看懂里面的图表。

使用例子：

让 @oracle 审查这个设计并提出架构
让 @librarian 看看这是如何实现的——为什么行为一直在变化？
让 @explore 查找这个功能的策略

6. Sisyphus 的模式 (工作 9 原则)

我总结了一下，这套系统干活的逻辑是：

1. 不废话，直接干：主智能体保持上下文精简，脏活累活全丢给后台并行任务。
2. LSP 优先：重构代码用 LSP，稳准狠。
3. 术业有专攻：前端给 Gemini，高智商支援找 GPT-5.2。
4. 实时消化：面对新框架，它会生成子智能体去”吃”源码。
5. 代码洁癖：要么证明注释有用，要么删了，看着舒服。
6. TODO 驱动：没完成 TODO 就会一直待在”推石头”模式，任务完成率 100%。
7. 自主挖掘：Sisyphus 会自己分析结构、收集上下文、挖掘外部源代码。
8. 最终奥义：别读文档了，直接敲 ulw + 你的需求。
9. 省事技巧：打 ulw 比 ultrawork 省事。就 ulw，喝杯咖啡，工作完成。

7. 翻旧账 (会话管理)

会话多了也不怕，有这几个工具：

• session_list：列出所有会话，支持按日期和数量过滤
• session_read：从特定会话读取消息和历史
• session_search：在会话消息中进行全文搜索
• session_info：获取会话的元数据和统计信息
• 快捷命令：
  • session 或 new：新建会话
  • session_list：列出所有会话
  • session_timeline：查看会话时间线

8. 实用小技巧

• 打 ulw 比打 ultrawork 省事。
• 如果你不确定某个功能怎么用，试试 let @librarian check how to use X。
• 定期清理过期的 TODO，保持工作台整洁。
• 善用 session_info 看看当前会话花了多少 Token，心里有个底。
• 选中代码后用 Alt + Ctrl + K 直接塞到对话框，不用复制粘贴。

---