简介面向需要在 OpenCode 与 TRAE CN 环境中落地 Superpowers 插件及 ui-ux-pro-max 技能的开发者这份源码包提供了一套可直接参考的配置方案帮助实现高质量、可运行代码的高效生成。资源共3个文件包含HTML说明文档、inscode配置示例与gitignore规则文件压缩包仅6KB轻量易用已有2034人学习该资源。安装过程涉及克隆仓库、创建符号链接和目录结构设置ui-ux-pro-max技能则用于强化前端界面与交互质量。内容还涵盖通过AGENTS.md或opencode.json写入严格代码生成规则确保代码可靠且减少潜在错误针对TRAE CN插件路径不一致的问题给出了专项处理方案并附有Windows PowerShell操作命令和常见错误排查思路。整体配置思路清晰示例精简适合前端开发者、AI编程工具使用者快速搭建统一的代码生成环境尤其适合希望提升前端UI/UX设计质量的团队参考。 最近很多人在折腾OpenCode和TRAE CN想把终端里那套AI编码能力接到IDE里同时又把社区里热门的Superpowers技能包也配置上。我前后花了几天时间把这两个工具和Superpowers的搭配完整跑通了一遍整理了一份可以直接复现的项目源码这篇就把整个配置思路、操作步骤、踩坑记录都摊开讲清楚。无论是刚接触终端AI编程的新手还是已经用过一段时间但被各种报错卡住的老手这篇应该都能帮你省下不少折腾时间。1. 项目整体思路OpenCode、TRAE CN 与 Superpowers 是怎么搭到一起的先说我理解的局面。OpenCode是一个终端里的开源AI编码助手主打开放和可配置你可以接各家模型也可以自定义技能skillsTRAE CN是字节跳动出的AI IDE把对话式编程直接做到编辑器里开箱即用对国内用户非常友好。Superpowers则是最近社区里讨论度很高的“技能包”本质是一套预先写好的skills规则让AI在编程时自动带上更强的分析、规划、执行能力有点像给AI编码助手装了一套“方法论外挂”。1.1 OpenCode 和 TRAE CN 各管哪一块这两个工具定位不同没必要二选一。实际使用中我习惯把OpenCode当作“高自由度终端主力”它适合做代码重构、批量文件处理、Git操作、复杂任务拆解因为所有配置都在一个opencode.json里行为可控性极强。而TRAE CN则承担“IDE内对话和补全”的角色它有原生中文支持、可视化界面、代码库索引适合一边看代码一边聊需求。所以这个项目源码里面的配置不是让二者互斥而是让一套Superpowers技能同时作用于两个场景终端里能用自然语言下发任务IDE里也能享受到同样的技能增强。这是整个配置指南的核心思路。1.2 Superpowers 技能包到底是个什么东西Superpowers听起来玄乎其实技术含量就在“结构化的技能定义”。它借鉴了社区里流行的agent技能机制把AI完成任务所需的流程、约束、输出格式都写进可加载的技能文件里。比如一个“代码审查”技能会要求AI先做影响面分析、再列检查清单、最后给出修改建议而不是直接甩一堆结论。这种技能的载体一般是Markdown或JSON格式的规则文件放在约定的目录下就会被OpenCode或TRAE CN识别。Superpowers之所以火是因为它把很多开发者日常沉淀的经验固化成了可复用技能一加载AI的行为模式会立刻上一个档次这也是为什么现在搜索“superpowers skill下载”的人特别多。2. 环境准备与安装避坑配置之前先把工具装好。这里我先说安装不然后面技能加载和模型调用都无从谈起。但安装恰恰是很多人最早被卡住的地方尤其是Windows用户。2.1 OpenCode 安装及 Windows PATH 问题全解OpenCode的官方安装方式很简单在终端里执行一行安装脚本就行。macOS和Linux下一般顺风顺水但Windows用户经常会碰到下面这个报错opencode : 无法将“opencode”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。这个报错的本质是安装程序把可执行文件放到了某个目录但这个目录没有加进系统PATH环境变量所以你敲opencode时PowerShell找不到它。解决办法分两步打开PowerShell执行where.exe opencode如果返回路径说明程序装上了只是PATH不完整如果没返回任何结果大概率安装步骤本身没成功。打开“系统属性 - 环境变量”在“系统变量”里找到Path把OpenCode的实际安装目录通常会在用户目录下的.opencode\bin或安装脚本输出的路径追加进去保存后重开终端。我比较推荐用包管理器安装OpenCode。如果你机器上有Scoop或Chocolatey一句命令搞定环境变量基本上不会碰到PATH问题。如果没有包管理器用官方脚本装完手动加路径也很快只是别在同一个终端窗口里测试必须重开窗口让环境变量生效这是新手最容易忽略的。2.2 TRAE CN 安装、更新与窗口意外终止问题TRAE CN的安装本身没太多坑下载对应平台的安装包一路下一步就行。它的坑主要集中在更新环节不少人在更新后遇到过“窗口意外终止请重启后再次打开软件如依然无法...”的提示。这个问题我反复复现过几次原因主要有三类更新时旧版本进程没完全退出导致新版本覆盖时文件被占用IDE的缓存目录损坏尤其是代码索引和插件缓存显卡驱动或系统集成显卡兼容性导致渲染崩溃。我的处理方式是先彻底退出TRAE CN包括系统托盘里的残留进程再重新打开如果不行就删除它的缓存目录一般在用户目录下的.trae\Cache或类似位置重新启动后让它重新索引。这类问题不要慌属于IDE类软件的老毛病和你的项目代码没关系。2.3 项目源码目录解读我在整理这套配置时刻意把目录设计得能同时服务OpenCode和TRAE CN。项目源码结构大概长这样opencode-trae-superpowers/ ├── opencode/ │ ├── opencode.json # OpenCode主配置 │ ├── AGENTS.md # 全局代理规则 │ └── skills/ # Superpowers技能包 │ ├── code-review.md │ ├── task-breaking.md │ └── git-workflow.md ├── trae/ │ ├── .trae/ │ │ ├── rules/ # TRAE CN规则文件 │ │ └── mcp.json # MCP服务配置 │ └── README.md └── scripts/ ├── install-skills.sh # 技能包一键安装脚本 └── verify-config.ts # 配置校验脚本opencode.json是OpenCode的配置核心模型、skills目录、MCP服务都在这里声明AGENTS.md是给AI看的全局规则所有会话都会加载skills目录存放Superpowers技能。TRAE CN这边.trae/rules是IDE读取的规则目录mcp.json用来声明外部MCP服务。scripts目录里的安装脚本和校验脚本是我自己写的后面细说。3. Superpowers 技能包配置实操现在进入正题Superpowers技能包怎么下载、放哪、怎么让OpenCode和TRAE CN认出来。这一步是整个配置的胜负手。3.1 下载 Superpowers skillsSuperpowers技能包在社区里有多个来源我用的这个版本是从一个开源仓库同步下来的里面打包了十几个常用技能包括任务拆解、代码审查、Git工作流、测试生成、文档编写等。下载时注意选一个明确支持OpenCode的版本因为市面上很多Superpowers分支是为Claude Code定制的目录结构有差异直接搬过来不一定被OpenCode识别。我建议看下技能文件里有没有allowed-tools或类似字段如果有说明它考虑了OpenCode的权限体系。下载解压后你会看到一堆.md文件每个文件对应一个技能。里面是YAML前置元信息加正文指令的结构比如--- name: code-review description: 对指定代码进行系统性审查 --- 你是一名资深代码审查员在审查代码时必须遵循以下步骤...这种结构化格式是OpenCode这类工具能识别技能的基础。3.2 OpenCode 接技能包OpenCode识别技能的位置有两种常见方式全局目录和项目目录。全局目录通常放在用户目录下的.opencode/skills项目目录则是当前项目里的.opencode/skills或opencode/skills。我项目源码里用的是项目级目录这样团队协作时技能包可以随着仓库一起分发大家的行为保持一致。接技能包的核心操作是修改opencode.json{ $schema: https://opencode.ai/config.json, model: anthropic/claude-sonnet-4, skills: { paths: [opencode/skills], autoLoad: true } }这里paths指定技能目录autoLoad控制是否在启动时自动加载全部技能。如果设为falseAI会在需要时按描述匹配加载响应更快但可能漏匹配设为true则所有技能都常驻上下文行为稳定但token开销稍大。我自己一般开true因为技能带来的行为收益远大于额外那点token成本。3.3 TRAE CN 接技能包TRAE CN本身没有和OpenCode完全一致的skills目录机制但它支持通过规则文件和MCP来达到类似效果。我的做法是把Superpowers技能里的核心指令改写成TRAE CN能读取的规则文件放到.trae/rules目录下。规则文件是纯Markdown文件名就是规则名。比如把代码审查技能改写成code-review.md内容头部加上适用范围的描述然后正文保留技能核心逻辑。TRAE CN会在会话时自动加载这些规则AI行为就和OpenCode里加载了Superpowers技能非常接近。如果想要更强的一体化方案可以考虑用MCP作为一个桥梁把OpenCode的技能能力通过MCP服务暴露给TRAE CN。这个后面讲MCP时再展开。4. 模型接入与 MCP 扩展技能加载只是第一步模型接入决定实际输出质量MCP则决定工具链扩展能力。这部分也是热词里“opencode如何切换模型”和“trae code cn如何添加本地的ollama”的来源。4.1 OpenCode 切换模型OpenCode支持很多模型提供商我项目里默认用的是Anthropic系列但你完全可以根据需求切换。单个命令切换opencode model这个命令会列出当前可用的模型列表上下键选择回车生效非常直观。如果你想在配置层面直接指定默认模型改opencode.json里的model字段就行{ provider: { openai: { apiKey: env:OPENAI_API_KEY, baseURL: https://api.openai.com/v1 }, ollama: { baseURL: http://localhost:11434/v1 } }, model: openai/gpt-4o }注意model字段的格式是提供商/模型名和OpenCode内部路由逻辑对应。切换模型后最好重开会话不然上下文里可能残留前一个模型生成的系统提示。4.2 接入本地 Ollama 模型很多人的机器上跑着Ollama想给TRAE CN或OpenCode接本地的Qwen、Llama等模型主要图一个隐私和数据不出本机。OpenCode接Ollama在配置文件里加一段provider配置然后model字段指向ollama开头就行。TRAE CN接本地Ollama的方式略有不同TRAE CN设置里通常有一个“自定义模型”或“模型服务”入口你需要在里面填Ollama的服务地址默认http://localhost:11434和模型名。填完后在对话面板里手动选择这个模型测试如果返回报错先检查Ollama服务是否在跑再确认模型名是否完整比如qwen2.5-coder:14b不要只写qwen2.5-coder。本地模型有个现实问题如果配置不到位生成的代码质量会明显不如云端模型这不是配置的锅而是小参数模型的固有能力上限。配置上你只需要确保上下文长度和硬件显存匹配不要盲目给本地模型塞一堆技能提示否则对话会又慢又差。4.3 MCP 配置与使用场景MCPModel Context Protocol是让AI助手调用外部工具的标准协议。我在这套配置里接了一个MCP服务用于把外部能力注入给OpenCode和TRAE CN。OpenCode配置MCP{ mcp: { server-name: { type: stdio, command: npx, args: [-y, some/mcp-server], env: { KEY: value } } } }TRAE CN则通过.trae/mcp.json声明格式类似它会在IDE启动时自动连接MCP服务。MCP常见的用途包括数据库查询、HTTP请求、读取本地文件、控制外部工具等。之前热词里有“codex使用mcp控制matlab配置指南”思路是一样的只是具体对接的工具不同。我在这套配置里加的MCP是一个本地代码索引服务可以让AI在不依赖IDE原生索引的情况下快速查找到跨文件的函数定义。实际体验下来对大型Java或TypeScript项目非常有效AI答非所问的情况明显减少。5. 高频故障自查清单配置过程不会一帆风顺我把热搜词里出现频率最高的几个问题集中整理成一张速查表附带我实测下来的排查顺序。5.1 命令不识别问题症状终端执行opencodePowerShell报“无法识别”。排查顺序where.exe opencode看程序是否存在无结果先重新安装查PATH里有没有OpenCode安装目录改完PATH必须新开终端窗口如果用了终端代理工具如Cmder、Windows Terminal子配置文件确认它们继承的是改后的系统PATH。我遇到过一个极端案例发现PATH里明明有目录但终端还是找不到最后发现是安装脚本把可执行文件装到了带空格的路径下PowerShell解析时出了问题。解决方式是给安装目录加双引号或者直接换包管理器重装。5.2 TRAE CN 窗口意外终止问题症状更新或启动时弹窗提示窗口意外终止。排查顺序检查系统托盘有没有残留进程强制结束后重开清缓存目录.trae/Cache和.trae/Index重新索引更新显卡驱动尤其是核显和独显切换的笔记本如果还是崩溃去官方社区下载完整的离线安装包覆盖安装一次。这个问题的根源多半不是你的配置而是IDE本身的稳定性所以不要急着删项目配置先按上面顺序定位。5.3 Superpowers 技能未生效症状技能文件放好但AI行为没有任何变化。排查确认技能目录路径是否写对OpenCode是看opencode.json的skills.paths确认技能文件本身的元信息格式是否正确YAML头有问题会被直接忽略确认autoLoad是否为true设为false时AI是否主动加载取决于提示词触发方式在OpenCode会话里输入skills相关命令直接列出当前已加载技能一目了然TRAE CN规则文件则要确认文件名和内容大小写、编码建议用UTF-8无BOM。5.4 模型请求失败症状能选择模型但发送消息就报错。排查顺序检查API Key是否配置正确并已导入环境变量检查远程模型服务地址是否可达网络是否通畅检查上下文长度设置很多token超限报错会在界面上伪装成请求失败本地Ollama模型则先确认端口占用和模型是否已拉取成功。这5类问题基本覆盖了我在配置过程中遇到的大部分状况建议遇到问题按表排查不要一上来就重装工具大概率只是配置细节没到位。6. 最后再补充一点实操心得这套配置我实际用了两三周最大的体感变化是AI处理任务的“节奏”正常了。没加载Superpowers时AI经常急着给结论问一句答一句加载技能后它会先拆任务、列步骤、再动手遇到复杂点还会主动确认确实更像个正经结对编程的同事。不过也要说实话技能包不是万能药它只能优化AI的行为模式不能弥补模型本身能力的短板。关于项目源码我强烈建议你用的时候先跑一下scripts/verify-config.ts它会自动检查技能文件格式、目录路径、MCP配置是否完整能省掉很多手动排查的时间。这个脚本是我在踩了几次“技能不生效”的坑之后写的虽小但很实用。最后分享一个小技巧Superpowers技能包不要一次性全开先挑两三个最贴合你日常工作的技能比如代码审查和任务拆解用一周看效果再逐步扩。技能全开虽然很酷但会让AI的提示词库变得臃肿对话变慢不说还容易把主次搞混。循序渐进比我一开始图省事全开的效果好太多了。本文还有配套的精品资源点击获取