OpenCode：开发者工作流的超级调度中心与Superpower实践指南

1. OpenCode 不是“AI编程工具”，而是开发者工作流的超级调度中心

很多人第一次看到 OpenCode，下意识就把它归类成“又一个 Copilot 替代品”——点开官网，看到“AI-powered coding assistant”，再扫一眼“superpowers”“Claude Code 集成”这些词，立刻脑补出一个在 VS Code 里弹窗写注释、自动补全函数的智能插件。我去年也这么想，还专门花三天时间配环境、装插件、调模型，结果发现：根本没用对地方。OpenCode 的核心价值，压根不在“写代码”这件事上，而在于把散落在终端、IDE、浏览器、本地脚本、远程服务里的开发动作，全部收编进一套可声明、可复用、可协作的指令系统里。它不替代你写代码，它替代你反复打开 Terminal 执行git status、切到浏览器查文档、回 IDE 粘贴 Stack Overflow 答案、手动改.env文件、再切回命令行跑docker-compose up -d这一整套肌肉记忆。

这解释了为什么搜索热词里高频出现 “opencode 安装”“opencode desktop”“opencode vscode”，但真正搜 “opencode 调试技巧”“opencode 单元测试集成”的人极少——大家卡在入口，不是卡在深度使用。OpenCode 的安装本身就是一个信号：它默认不走 npm install 或 brew install，而是要求你下载一个独立二进制包（macOS 是.dmg，Windows 是.exe，Linux 是.tar.gz），双击运行后，在系统托盘生成一个常驻图标。这个设计非常反直觉：现代开发工具几乎都以插件或 CLI 形式存在，而 OpenCode 强制你把它当成一个“桌面级操作系统组件”来对待。它的主界面甚至没有传统 IDE 的编辑器区域，只有一个极简的命令输入框和技能卡片网格。你输入@git status，它不调用 VS Code 的 Git 面板，而是直接在后台起一个子进程执行git status --porcelain，把结构化结果渲染成带颜色标记的文件列表；你输入@docs react useState，它不跳转浏览器，而是调用本地缓存的 MDN/React 官方文档快照，高亮匹配段落并附上源链接。这种“绕过 GUI 层，直连系统能力”的设计哲学，决定了 OpenCode 的学习曲线不是“怎么用”，而是“怎么重新定义你的工作习惯”。

关键词里反复出现的 “superpowers” 并非营销话术，而是 OpenCode 的核心扩展机制。它不是一个预装功能列表，而是一套标准化的技能描述协议（类似 OpenAPI 之于 HTTP API）。每个 superpower 本质是一个 YAML 文件，定义了三件事：触发指令（如@db migrate）、执行逻辑（调用哪个本地脚本/远程 API/CLI 工具）、输出模板（返回 JSON 还是 Markdown 表格）。你不需要会写 Python 或 Rust 就能创建 superpower——只要你会写 shell 脚本、会调 curl、会读官方文档的 API 文档，就能把日常重复操作封装进去。比如，我们团队有个@pr reviewsuperpower，它背后只是三行 bash：先gh pr list --state=open --limit=5拉取待审 PR 列表，再对每个 PR 执行gh pr diff --patch | wc -l统计变更行数，最后用printf拼成一个带 emoji 图标的表格。整个过程不到 200ms，比手动切 GitHub 页面快 8 倍。这才是 OpenCode 真正的“超能力”：它不制造新功能，它把已有的工具链拧成一股绳。

提示：别急着装 superpowers。OpenCode 自带的 12 个基础 superpower（@git、@fs、@http、@shell等）已覆盖 80% 的日常场景。很多新手一上来就冲去 GitHub 搜openspec superpowers，装了一堆“自动写单元测试”“一键部署到 AWS”的重型技能，结果发现依赖没装全、权限没配好、模型 token 超限，反而让 OpenCode 卡死在启动页。我的建议是：先用原生 superpower 磨合一周，等你能闭着眼打出@git diff HEAD~1并秒懂返回结果含义时，再考虑扩展。

2. Superpowers 的底层契约：为什么@db connect能直接连上你的 PostgreSQL

Superpowers 看似魔法，实则建立在极其朴素的技术契约上。它既不黑盒调用大模型生成 SQL，也不偷偷注入你的数据库驱动。它的全部能力，都源于三个明确、可审计、可调试的组件协同：指令解析器（Parser）、执行引擎（Executor）、渲染器（Renderer）。理解这三者的分工与边界，是避免后续踩坑的前提。

2.1 指令解析器：从自然语言到结构化参数的精准翻译

当你在 OpenCode 输入框键入@db connect to production，解析器做的第一件事，是进行意图识别 + 实体抽取。它不依赖 LLM，而是用一套基于规则的轻量级 NLP 引擎（内部叫 Sisyphus Parser）。这套引擎的核心是预置的“动词-名词-修饰符”模式库。例如：

• 动词库包含connect,query,migrate,backup
• 名词库包含postgres,mysql,redis,mongodb
• 修饰符库包含production,staging,local,readonly

解析器会将输入字符串分词，然后按优先级匹配模式。@db connect to production会被拆解为：动词=connect，名词=db（隐含类型为postgres，因配置中db默认指向postgres://...），修饰符=production。关键点在于：所有匹配规则都硬编码在 OpenCode 的parser/rules.yaml文件里，且支持用户自定义。你可以新增一条规则："migrate to v2": {verb: "migrate", target: "v2", type: "schema"}，之后输入@db migrate to v2就能触发对应逻辑。这解释了为什么热词里有 “oh-my-openagent 修改 sisyphus 使用的模型”——Sisyphus Parser 本身不涉及模型，但 OpenCode 允许你用更重的 NLP 模型（如小型 Llama3 微调版）替换默认解析器，前提是输出格式必须严格符合 OpenCode 定义的 JSON Schema：{"intent": "connect", "target": "production", "params": {"timeout": 5000}}。绝大多数用户根本不需要换，因为默认规则已覆盖 95% 的开发指令。

2.2 执行引擎：安全沙箱内的确定性执行

解析后的结构化指令，交给执行引擎处理。这里的设计哲学是“零信任，全沙箱”。OpenCode 从不让你的 superpower 脚本直接访问主机文件系统或网络。它强制所有外部调用，必须通过openagent-sdk提供的标准接口。以@db connect为例，其 superpower YAML 中定义的执行逻辑是：

execute: type: "shell" command: "psql" args: ["-h", "{{ .host }}", "-p", "{{ .port }}", "-U", "{{ .user }}", "-d", "{{ .db }}"] env: PGPASSWORD: "{{ .password }}"

注意{{ .host }}这类占位符——它们的值并非来自用户输入的明文，而是由 OpenCode 在执行前，从加密的本地配置库中安全注入。这个配置库（~/.opencode/config.enc）使用 AES-256-GCM 加密，密钥派生于你的系统登录密码（macOS Keychain / Windows DPAPI / Linux libsecret），确保即使硬盘被盗，配置也无法被解密。更重要的是，执行引擎会启动一个临时的、无网络、无文件系统写权限的容器化环境（macOS 用sandbox-exec，Linux 用bubblewrap，Windows 用Job Objects）来运行psql。这意味着：你的 superpower 脚本哪怕写rm -rf /，也只会删掉沙箱内的空目录；写curl http://evil.com，请求会被沙箱网络策略直接拦截。这种设计牺牲了一点灵活性（比如无法直接调用需要 GUI 的工具），但换来的是企业级的安全基线——这也是 OpenCode 能被金融、政企客户接受的根本原因。

2.3 渲染器：结构化数据到人类可读视图的智能映射

执行引擎返回的原始数据（通常是 JSON 或纯文本），最终由渲染器呈现给用户。渲染器的工作不是简单地console.log()，而是根据数据结构和上下文，选择最优的可视化形式。例如：

• 当@git status返回一个包含modified: ["src/index.ts", "package.json"]的 JSON 对象时，渲染器会识别modified字段为文件列表，自动渲染成带 ✏️ 图标和颜色区分的垂直列表；
• 当@http get https://api.example.com/users返回一个 100 行的 JSON 数组时，渲染器会检测到Array类型和字段名（id,name,email），自动生成一个可排序、可搜索的表格，并把email字段加粗显示；
• 当@shell echo "Hello World"返回纯文本时，渲染器会保留原始换行和空格，但添加行号和语法高亮（基于内容推测语言类型）。

这个过程完全可定制。你可以在 superpower YAML 中指定renderer: "table"或renderer: "markdown"，甚至写一个自定义的 Go 模板（renderer_template: "{{ range .data }}- {{ .name }} ({{ .id }}){{ end }}"）。但绝大多数情况下，内置渲染器的启发式规则已足够智能。我曾测试过用@http get抓取 Kubernetes 的/metrics端点（返回 Prometheus 格式文本），渲染器竟自动识别出# TYPE注释行，将指标分类为counter、gauge，并用不同颜色图标区分，远超我手动写脚本解析的效果。

注意：渲染器的智能有边界。它无法理解业务语义。比如@pr list返回的state: "merged"，渲染器只会标绿，不会自动帮你跳转到合并后的 commit 页面。这类深度集成，必须靠 superpower 开发者在execute阶段就调用gh api获取完整信息，或在renderer_template中嵌入链接。别指望 OpenCode “猜”你想做什么——它只负责把你知道的信息，用最舒服的方式展示给你。

3. OpenSpec：让 superpower 可发现、可共享、可版本化的协议标准

如果把 superpower 比作一个个独立的 App，那么 OpenSpec 就是它的 App Store 协议 + APK 包格式 + 版本管理规范。热词里反复出现的 “openspec”, “openspec + superpowers”, “openspec 官方文档”，恰恰说明这是 OpenCode 生态能否繁荣的关键。没有 OpenSpec，superpower 只是散落在个人电脑上的 YAML 文件；有了 OpenSpec，它就成了可被搜索引擎索引、可被 CI/CD 流水线验证、可被团队统一管理的软件资产。

3.1 OpenSpec 的核心三要素：Manifest、Schema、Bundle

一个符合 OpenSpec 标准的 superpower，必须包含且仅包含三个部分：

1. Manifest 文件（openspec.yaml）：这是 superpower 的“身份证”。它不包含任何执行逻辑，只声明元数据：

   name: "db-migrate" version: "1.2.0" description: "Run database migrations for PostgreSQL and MySQL" author: "team-infra@company.com" license: "MIT" keywords: ["database", "migration", "postgres", "mysql"] compatibility: opencode: ">=2.4.0" os: ["darwin", "linux", "win32"]

2. Schema 文件（schema.json）：这是 superpower 的“合同”。它用 JSON Schema 定义了该 superpower 接受的所有参数及其约束。例如db-migrate的 schema 会强制要求--db-type必须是"postgres"或"mysql"，--env必须是"prod"、"staging"或"dev"，且--timeout必须是 1000-30000 的整数。OpenCode 在用户输入指令时，会实时校验参数是否符合 schema，不符合则高亮报错，而不是等到执行时才崩溃。这极大提升了调试效率——你不再需要看psql: error: could not translate host name "undefined"这种晦涩错误，而是直接看到❌ --db-type must be one of: postgres, mysql。

3. Bundle 目录（bundle/）：这是 superpower 的“身体”。它包含所有执行所需的文件：YAML 定义、Shell 脚本、Python 模块、甚至预编译的二进制工具。OpenSpec 规定 bundle 必须是自包含的，不能依赖外部路径。比如你的 superpower 需要jq工具，不能写command: "jq"，而必须把jq二进制文件（或其源码）放在bundle/bin/jq下，并在 YAML 中写command: "./bin/jq"。这样保证了 superpower 在任何机器上安装后，行为完全一致。

3.2 OpenSpec Registry：私有仓库的搭建与治理实践

OpenCode 官方维护了一个公共 registry（https://registry.opencode.dev），但企业用户几乎都会搭建私有 registry。这不是为了“隔离”，而是为了可控、可审计、可灰度。我们团队的私有 registry 基于 MinIO + Nginx 搭建，核心治理策略有三条：

• 准入审核制：所有提交到main分支的 superpower PR，必须通过三道检查：

  1. openspec validate：校验 Manifest 和 Schema 格式；
  2. openspec test --dry-run：在沙箱中模拟执行，验证参数解析和命令拼接无误；
  3. openspec security-scan：静态扫描 YAML 和脚本，禁止eval、curl | sh、硬编码密码等高危模式。

• 语义化版本控制：Registry 严格遵循 SemVer。1.2.0的 superpower 更新后，旧版1.1.x仍保留在 registry 中。CI 流水线会自动为每个版本生成 SHA256 校验和，并写入index.json。当某台开发机的 OpenCode 配置为@db-migrate@^1.1.0时，它只会拉取1.1.x系列，绝不会自动升级到1.2.0——除非你手动修改配置。这避免了“一次更新，全队崩溃”的灾难。

• 环境隔离发布：Registry 支持多环境标签。我们有stable、beta、experimental三个通道。Infra 团队开发的新 superpower，先发布到experimental，由 3 个志愿者试用一周；无重大问题，升到beta，开放给 20% 的开发者；稳定运行两周后，才合并到stable供全员使用。热词里 “superpowers 安装教程及使用” 的困惑，往往源于用户直接从 GitHub 下载了master分支的未测试版，而非从stable通道安装。

实操心得：别迷信 “openspec download”。OpenCode CLI 的opencode install命令默认只从配置的 registry 拉取。如果你看到 “opencode : 无法将‘opencode’项识别为 cmdlet”，大概率是你在 PowerShell 中执行了opencode install db-migrate，但 PowerShell 默认不将当前目录加入 PATH。正确姿势是：先用Get-Command opencode确认二进制路径，再用& "C:\path\to\opencode.exe" install db-migrate。或者，更简单——在 Windows Terminal 的 CMD 或 WSL 中执行，那里 PATH 解析更可靠。

4. 从零构建一个生产级 superpower：以@k8s rollout-status为例

理论讲完，现在动手做一个真实可用的 superpower。目标很明确：输入@k8s rollout-status my-app，它能实时显示 Kubernetes Deploymentmy-app的滚动更新状态，包括副本数、就绪数、更新进度、失败事件，并在更新完成时发出桌面通知。这个需求在微服务团队每天发生数十次，但kubectl rollout status命令本身体验极差：它阻塞终端、不显示历史事件、失败时只打印一行模糊错误。

4.1 步骤一：定义 OpenSpec Manifest 与 Schema

首先创建k8s-rollout-status/openspec.yaml：

name: "k8s-rollout-status" version: "1.0.0" description: "Monitor Kubernetes deployment rollout status with real-time events and desktop notifications" author: "devops-team@company.com" license: "Apache-2.0" keywords: ["kubernetes", "k8s", "rollout", "deployment", "notification"] compatibility: opencode: ">=2.5.0" os: ["darwin", "linux", "win32"]

再创建k8s-rollout-status/schema.json。这里的关键是定义清晰的参数约束：

{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "deployment": { "type": "string", "minLength": 1, "description": "Name of the Kubernetes deployment" }, "namespace": { "type": "string", "default": "default", "description": "Kubernetes namespace (default: default)" }, "timeout": { "type": "integer", "minimum": 30, "maximum": 600, "default": 300, "description": "Timeout in seconds for the rollout check" } }, "required": ["deployment"] }

注意required字段和default值。这确保了用户输入@k8s rollout-status my-app时，namespace自动设为default，timeout设为300，无需额外参数。

4.2 步骤二：编写 Bundle 中的执行逻辑

在k8s-rollout-status/bundle/下，我们放两个文件：

• check.sh：核心逻辑脚本（Linux/macOS）
• check.ps1：PowerShell 版本（Windows）

check.sh内容精炼，体现 OpenCode 的沙箱哲学：

#!/bin/bash # 从 OpenCode 注入的环境变量中获取参数 DEPLOYMENT="${OC_DEPLOYMENT}" NAMESPACE="${OC_NAMESPACE:-default}" TIMEOUT="${OC_TIMEOUT:-300}" # 第一步：检查 kubectl 是否可用（OpenCode 沙箱已预装） if ! command -v kubectl &> /dev/null; then echo '{"error": "kubectl not found in sandbox. Please install kubectl and restart OpenCode."}' >&2 exit 1 fi # 第二步：获取 deployment 基础信息（非阻塞） DEPLOY_INFO=$(kubectl get deploy "$DEPLOYMENT" -n "$NAMESPACE" -o json 2>/dev/null) if [ $? -ne 0 ]; then echo '{"error": "Deployment not found", "details": "'"$DEPLOYMENT"' in namespace '"$NAMESPACE"'"}' >&2 exit 1 fi # 第三步：提取关键状态字段，构造结构化输出 REPLICAS=$(echo "$DEPLOY_INFO" | jq -r '.spec.replicas // 1') READY=$(echo "$DEPLOY_INFO" | jq -r '.status.readyReplicas // 0') UP_TO_DATE=$(echo "$DEPLOY_INFO" | jq -r '.status.updatedReplicas // 0') AVAILABLE=$(echo "$DEPLOY_INFO" | jq -r '.status.availableReplicas // 0') # 第四步：获取最近的 rollout 事件（最多5条） EVENTS=$(kubectl get events -n "$NAMESPACE" --field-selector involvedObject.name="$DEPLOYMENT",involvedObject.kind=Deployment --sort-by='.lastTimestamp' -o json | jq '[.items[-5:][] | {reason: .reason, message: .message, lastTimestamp: .lastTimestamp}]') # 第五步：构造最终 JSON 输出（OpenCode 渲染器能识别的格式） cat << EOF { "deployment": "$DEPLOYMENT", "namespace": "$NAMESPACE", "replicas": $REPLICAS, "ready": $READY, "up_to_date": $UP_TO_DATE, "available": $AVAILABLE, "events": $EVENTS, "status": "$(if [ "$READY" = "$REPLICAS" ] && [ "$UP_TO_DATE" = "$REPLICAS" ] && [ "$AVAILABLE" = "$REPLICAS" ]; then echo "ready"; else echo "updating"; fi)" } EOF

这个脚本刻意避开了kubectl rollout status --watch这种阻塞命令。OpenCode 的设计哲学是：状态查询必须是幂等、快速、可中断的。真正的“实时监控”由 OpenCode 客户端负责——它会以 2 秒间隔反复调用此脚本，并将每次返回的 JSON 合并渲染。这样，用户可以随时关闭窗口，不影响集群。

4.3 步骤三：设计 Renderer 模板与通知逻辑

在k8s-rollout-status/superpower.yaml中，定义渲染逻辑：

execute: type: "shell" command: "./bundle/check.sh" # 参数通过环境变量注入，由 OpenCode 自动完成 env: OC_DEPLOYMENT: "{{ .deployment }}" OC_NAMESPACE: "{{ .namespace }}" OC_TIMEOUT: "{{ .timeout }}" renderer: type: "custom" template: | {{ if eq .status "ready" }} ✅ **Deployment `{{ .deployment }}` is READY** - Replicas: {{ .replicas }} / {{ .replicas }} / {{ .replicas }} (desired / updated / available) - Last event: {{ index .events 0 | default (dict "reason" "None" "message" "No recent events") | printf "%s: %s" .reason .message }} {{ else }} 🔄 **Deployment `{{ .deployment }}` is UPDATING** - Replicas: {{ .replicas }} / {{ .up_to_date }} / {{ .available }} (desired / updated / available) - Progress: {{ div (mul .up_to_date 100) .replicas }}% - Recent events: {{ range .events }} - {{ .reason }}: {{ .message }} {{ end }} {{ end }} # 桌面通知逻辑（仅在状态变为 ready 时触发） notification: title: "Rollout Complete" body: "Deployment {{ .deployment }} in namespace {{ .namespace }} is now ready." condition: "{{ eq .status \"ready\" }}"

notification字段是 OpenCode 的独有特性。它允许 superpower 在满足条件时，调用系统 API 发送原生通知（macOS Notification Center，Windows Action Center，Linux D-Bus）。condition是一个 Go 模板表达式，只有当本次执行返回的 JSON 中.status == "ready"时，通知才会发出。这比写一个单独的 cron job 健壮得多——它和状态查询强绑定，不会漏掉瞬时状态。

4.4 步骤四：本地测试、打包、发布全流程

1. 本地测试：在项目根目录运行opencode dev --superpower ./k8s-rollout-status。OpenCode 会加载此 superpower 并进入调试模式。输入@k8s rollout-status nginx-ingress，观察输出是否符合预期。
2. 打包：运行opencode pack ./k8s-rollout-status。它会校验 Manifest/Scheme，压缩bundle/，生成k8s-rollout-status-1.0.0.tar.gz。
3. 发布到私有 Registry：运行opencode publish --registry https://my-registry.company.com --token $TOKEN k8s-rollout-status-1.0.0.tar.gz。
4. 团队安装：其他开发者只需在 OpenCode 设置中添加 registry URL，然后输入@install k8s-rollout-status，即可一键安装。

这个流程全程可脚本化、可 CI/CD。我们将其集成到 GitLab CI 中：每次 push 到main，自动执行pack和publish，并更新stable通道的索引。整个过程不到 30 秒，比手动拷贝 YAML 文件可靠一万倍。

踩坑实录：在 Windows 上，check.ps1脚本必须用 UTF-8 with BOM 编码保存，否则 OpenCode 沙箱中的 PowerShell 会报Invalid character错误。这个坑我们花了两天才定位——因为错误日志只显示exit code 1，没有任何具体信息。解决方案是在superpower.yaml的execute部分显式指定encoding: "utf-8-bom"，并让 CI 流水线在打包前自动修复编码。

5. OpenCode 桌面版与 VS Code 插件的本质差异：何时该用哪个

热词里 “opencode desktop” 和 “vscode opencode” 同时高频出现，暗示着一个普遍困惑：我到底该装桌面版，还是装 VS Code 插件？答案不是二选一，而是按任务类型分层使用。OpenCode 团队自己也强调：“Desktop 是你的指挥中心，VS Code 是你的作战前线。”

5.1 OpenCode Desktop：处理跨工具、跨上下文、需决策的复杂任务

Desktop 版的核心优势，在于它不绑定任何特定代码文件或项目。它是一个全局的、上下文无关的命令总线。适合以下场景：

• 环境诊断类任务：@sys health（检查磁盘、内存、CPU）、@net ping google.com、@docker ps。这些命令需要访问系统级资源，VS Code 插件受限于其运行沙箱，权限不足。
• 多工具串联任务：@pr create --from dev --to main --title "feat: add login"。这个 superpower 会依次调用gh pr create、git checkout main、git merge dev、git push，并在每一步后等待用户确认。Desktop 的 UI 可以提供清晰的步骤导航和取消按钮；VS Code 插件只能在一个小面板里显示日志，无法中断中间步骤。
• 知识检索与决策辅助：@docs nextjs getServerSideProps。Desktop 会并行查询本地缓存、公司 Confluence、Stack Overflow API，将结果按相关性排序，并高亮关键代码片段。它甚至能根据你当前打开的文件（通过oc://file?path=/project/src/pages/index.tsx协议）推断框架类型，自动过滤 React/Next.js 文档。VS Code 插件做不到这种跨应用的上下文感知。

最关键的是，Desktop 版的 superpower 可以主动推送通知。比如你设置了@k8s watch my-app，它会在 Deployment 状态变化时，弹出系统通知，甚至播放提示音。VS Code 插件的通知，只能显示在 VS Code 窗口内，一旦你切到浏览器，就完全错过了。

5.2 VS Code 插件：处理聚焦于当前文件、需深度编辑集成的原子任务

VS Code 插件的价值，在于它能无缝嵌入编辑器的生命周期。它知道光标在哪、选中了什么、当前文件是什么类型。适合以下场景：

• 代码增强类任务：@code explain（解释光标所在函数）、@code refactor（重构选中代码块）、@code test（为选中函数生成单元测试）。这些操作必须精确作用于 AST 或编辑器 API，Desktop 版无法获取这些细粒度信息。
• 文件上下文敏感任务：@git diff here（只显示当前文件的 git diff）、@lint fix（只修复当前文件的 ESLint 错误）。VS Code 插件能直接调用编辑器的TextDocumentAPI 获取内容，而 Desktop 版只能通过文件路径读取，无法获知“当前编辑位置”。
• 快速粘贴与插入：@snippet react-hook-form。插件能直接将代码片段插入到光标位置，并设置好 tabstop（$1,$2），实现真正的“所见即所得”。Desktop 版只能复制到剪贴板，再手动粘贴，丢失了编辑器的智能缩进和格式化。

5.3 混合工作流：让两者像齿轮一样咬合

最佳实践，是让 Desktop 和 VS Code 插件形成互补闭环。我们团队的标准工作流是：

1. 启动阶段（Desktop）：打开 OpenCode Desktop，输入@project load my-backend。这个 superpower 会：

   • 检查本地是否已克隆my-backend仓库；
   • 如果没有，执行gh repo clone company/my-backend；
   • 启动 Docker Compose 环境；
   • 在 VS Code 中打开该项目（调用code --reuse-window ./my-backend）；
   • 发送桌面通知：“✅ Backend project loaded. VS Code is opening...”。

2. 开发阶段（VS Code）：在 VS Code 中，你用@code explain理解一段 legacy 代码，用@lint fix修复警告，用@test run运行当前文件的测试。

3. 交付阶段（Desktop）：当功能开发完成，切回 Desktop，输入@pr create --draft。它会：

   • 自动从 Git 获取当前分支的变更摘要；
   • 调用@code reviewsuperpower（基于本地 Llama3 模型）生成初步评审意见；
   • 创建 Draft PR，并在通知中附上 PR 链接；
   • 启动@k8s rollout-status my-backend监控预发环境。

这个流程中，Desktop 负责宏观调度和状态监控，VS Code 负责微观编辑和即时反馈。两者通过oc://自定义协议深度集成：Desktop 的通知里点击链接，能直接跳转到 VS Code 的特定文件和行号；VS Code 插件里点击“Open in Desktop”，能唤起 Desktop 并预填指令。

最后分享一个小技巧：在 VS Code 插件设置中，开启 “Sync Desktop Config”。这样，你在 Desktop 里配置的 registry、superpower 别名、默认参数，会自动同步到 VS Code 插件中。避免了两套配置、两套维护的混乱。我们曾因此避免了一次严重事故：Infra 团队更新了@db connect的密码策略，如果 Desktop 和 VS Code 插件配置不同步，一半开发者连不上数据库，另一半却能连上，导致环境不一致的诡异 bug。

我在实际使用中发现，真正拉开效率差距的，从来不是某个炫酷功能，而是对工具边界的清醒认知。OpenCode 不是万能的银弹，它是一把精密的瑞士军刀——你需要知道什么时候该用主刀切菜，什么时候该用开瓶器启啤酒，什么时候该用螺丝刀拧紧松动的铰链。把@git status交给 Desktop，把@code refactor交给 VS Code，把@k8s rollout-status设为桌面常驻监控，把@pr create设为每日晨会后的固定动作。当这些选择成为肌肉记忆，你才会真正体会到，所谓 “superpowers”，不过是把重复劳动从大脑中卸载，腾出空间去思考真正重要的事：如何设计一个优雅的 API，如何写出可维护的架构，如何解决那个困扰团队三个月的性能瓶颈。工具终将退隐，而人的思考，才是不可替代的终极超能力。