简介这份源码包面向使用 OpenCode 与 TRAE CN 进行开发的工程师聚焦 Superpowers 插件与 ui-ux-pro-max 技能的配置落地解决插件路径不一致、代码生成规则松散等实际问题。包内共 3 个文件以 inscode 工程配置、html 页面与 gitignore 忽略规则为主压缩包约 6KB体量轻巧便于直接解压后对照搭建本地环境。内容围绕克隆仓库、创建符号链接、设置目录结构展开并给出通过 AGENTS.md 或 opencode.json 约束代码生成规则的具体做法同时针对 TRAE CN 环境补充了路径适配与常见问题处理思路。已有 2102 人学习适合希望把插件、技能与规则组合起来、稳定产出可运行代码的前端与全栈开发者参考也可作为团队统一开发配置的入门模板。1. OpenCode 与 TRAE CN 的 Superpowers这套组合到底解决什么问题如果你最近在折腾 AI 编程工具链大概率同时刷到过 OpenCode 和 TRAE CN 这两个名字。OpenCode 是一个终端里的 AI 编程代理能读代码、改文件、跑命令TRAE CN 是字节跳动推出的 AI IDE国内网络环境下开箱即用。两者单独用都不差但真正让一线开发者兴奋的是 Superpowers——一套给 AI 代理加装「技能包」的配置体系让模型不再只会聊天而是按预设流程干活。标题里的「配置指南」四个字核心痛点在于OpenCode 和 TRAE CN 各自有独立的配置入口Superpowers 的注入方式也不一样。很多人卡在「装完了但技能不生效」「模型能对话但不会调工具」这两步。这篇内容面向已经上手过至少一个 AI 编程工具、想把这套组合跑通的开发者从配置原理讲到可复现的操作步骤再到实际踩过的坑。2. Superpowers 的加载机制为什么你的技能包不生效2.1 Superpowers 到底往哪里注入Superpowers 本质上是一组结构化的提示词模板加工具调用声明它需要被注入到 AI 代理的系统提示system prompt或项目级配置文件中。OpenCode 和 TRAE CN 的注入点完全不同。OpenCode 的配置走的是项目根目录下的配置文件加全局配置目录。它读取配置的优先级是项目级配置覆盖全局配置。Superpowers 的技能定义通常放在一个独立的目录里通过配置文件里的指令字段引入。如果你只把技能文件丢进目录却没在配置里声明OpenCode 启动时根本不会加载。TRAE CN 的机制不一样。它作为 IDE配置入口在设置面板和项目级的规则文件里。Superpowers 在 TRAE CN 里通常以「自定义指令」或「规则集」的形式存在需要手动粘贴或通过规则文件导入。TRAE CN 不会自动扫描某个目录下的技能文件这一点和 OpenCode 有本质区别。理解这个差异之后很多「装了没反应」的问题就说得通了——你把 OpenCode 的技能目录结构直接搬到 TRAE CN 里它当然不认。2.2 配置文件的最小可用结构先看 OpenCode 这边。一个能让 Superpowers 生效的最小配置结构大致如下{ instructions: [ ./superpowers/skills/*.md ], provider: { default: your-provider-name }, model: your-model-id }这段配置做了三件事instructions字段告诉 OpenCode 去哪个路径加载技能定义文件provider指定默认的模型提供方model指定具体调用的模型。技能文件本身是 Markdown 格式每个文件描述一个技能的名称、触发条件和执行步骤。参数说明instructions支持数组可以写多个路径也支持 glob 通配。路径是相对于项目根目录的。如果你把技能文件放在全局配置目录里需要用绝对路径或者~开头的路径。provider和model这两个字段必须和你实际使用的服务匹配写错了会在启动时报错。TRAE CN 这边没有 JSON 配置文件这种形式它的规则注入走的是 IDE 设置里的自定义指令区域。你需要把 Superpowers 的技能描述整理成一段连续的文本粘贴进去。TRAE CN 对指令长度有限制所以技能包不能太大通常只保留最常用的三到五个技能。2.3 验证技能是否加载成功配置写完不代表生效。OpenCode 里可以用一个简单的方法验证启动后输入一个会触发技能的命令看它是否按照技能定义的流程走。比如某个技能定义了「先读文件再改代码」的流程如果模型直接开始改代码而没读文件说明技能没加载。TRAE CN 的验证更直接——在对话里问它「你当前有哪些技能可用」如果它能列出你配置的技能名称说明注入成功。如果它回答「我没有技能」或者答非所问检查指令区域是否保存成功以及是否重启了 IDE。提示TRAE CN 修改自定义指令后需要重启 IDE 才能生效这一点和 OpenCode 的热加载不同。3. OpenCode 侧配置实操从安装到技能跑通3.1 安装 OpenCode 与首次初始化OpenCode 的安装方式取决于你的操作系统。常见做法是通过包管理器安装比如在 macOS 上用 Homebrew在 Windows 上用 Scoop 或直接下载二进制文件。安装完成后在终端里执行初始化命令opencode init这个命令会在当前目录下生成一个基础配置文件。如果你是在已有项目里操作它会检测项目类型并给出推荐配置。初始化完成后你会得到一个配置文件里面包含了 provider 和 model 的占位符需要你填入实际值。参数说明opencode init默认在当前目录生成配置。如果你想在全局范围初始化加--global参数。初始化不会覆盖已有配置如果目录下已经有配置文件它会提示你是否合并。3.2 接入模型提供方与常见报错处理OpenCode 支持多种模型提供方。配置的时候需要注意不同提供方的字段名可能不一样。一个常见的配置片段{ provider: { openai: { apiKey: your-key-here, baseURL: https://your-endpoint/v1 } }, model: gpt-4o }这里apiKey和baseURL是最容易出问题的两个字段。baseURL如果写错启动时会报连接错误apiKey如果无效会在第一次调用模型时报鉴权失败。有一个高频报错值得单独说error from provider (console): opencodes free tier can only be used from within opencode。这个报错的意思是你使用的免费额度只能在 OpenCode 自身的界面内使用不能通过外部 API 调用。解决办法是确认你是在 OpenCode 的交互界面里操作而不是通过脚本或其他工具去调它的接口。如果你确实需要外部调用需要升级到付费方案或者换一个提供方。另一个常见问题是模型 ID 写错。不同提供方的模型命名规则不一样有的用gpt-4o有的用openai/gpt-4o。写错了不会报「模型不存在」而是会报一个模糊的连接错误让人以为是网络问题。排查的时候先确认模型 ID 是否和提供方文档一致。3.3 把 Superpowers 技能包挂载到项目技能包的挂载分两步放文件、写配置。先把技能文件放到项目下的一个目录里比如superpowers/skills/。每个技能文件是一个 Markdown 文件结构大致如下# 技能名称代码审查 ## 触发条件 当用户要求审查代码时触发。 ## 执行步骤 1. 读取目标文件 2. 逐行分析潜在问题 3. 输出审查报告然后在 OpenCode 的配置文件里引用这个目录{ instructions: [ ./superpowers/skills/*.md ] }逻辑说明OpenCode 启动时会读取instructions字段里的所有路径把匹配到的 Markdown 文件内容加载到系统提示中。技能文件里的「触发条件」和「执行步骤」会被模型用来判断何时调用该技能以及如何执行。参数说明glob 模式*.md只会匹配当前目录下的 Markdown 文件不会递归子目录。如果你的技能文件有分类目录结构需要写成./superpowers/skills/**/*.md。路径分隔符在 Windows 上要用正斜杠或者双反斜杠单反斜杠会被当成转义字符。3.4 用一条命令验证技能是否生效配置完成后用下面这个方式快速验证opencode run 请列出你当前可用的技能如果配置正确模型会列出你挂载的技能名称。如果它说「没有可用技能」或者列出的技能不对按以下顺序排查配置文件路径是否正确、glob 是否匹配到了文件、文件内容格式是否符合要求。注意OpenCode 对技能文件的格式有一定要求如果 Markdown 文件里没有明确的标题结构模型可能无法正确解析技能名称和触发条件。4. TRAE CN 侧配置实操规则注入与技能对齐4.1 TRAE CN 的规则入口在哪里TRAE CN 作为 IDE配置入口和 OpenCode 完全不同。打开 TRAE CN 后进入设置面板找到「AI 规则」或「自定义指令」区域。不同版本的 TRAE CN 这个入口的位置可能有差异常见做法是在设置里搜索「规则」或「指令」关键词。找到入口后你会看到一个文本输入区域。这里就是注入 Superpowers 技能的地方。和 OpenCode 不同TRAE CN 不支持引用外部文件路径你需要把技能内容直接粘贴进去或者通过规则文件导入功能上传。TRAE CN 对指令文本有长度限制通常在几千字符左右。这意味着你不能把所有技能都塞进去需要做取舍。我一般会保留最常用的三到四个技能比如代码审查、单元测试生成、重构建议。4.2 把 Superpowers 技能转成 TRAE CN 规则格式OpenCode 的技能文件是 Markdown 格式TRAE CN 的规则区域接受纯文本。转换的时候需要做精简去掉 Markdown 的格式标记保留核心的触发条件和执行步骤。一个转换后的规则文本示例技能代码审查 触发用户要求审查代码时 步骤 1. 读取目标文件内容 2. 检查命名规范、错误处理、边界条件 3. 按严重程度分级输出问题列表这段文本粘贴到 TRAE CN 的规则区域后保存并重启 IDE。重启后在对话里测试触发条件看它是否按照步骤执行。参数说明TRAE CN 的规则文本没有严格的格式要求但结构清晰的内容更容易被模型正确解析。建议每个技能之间用空行分隔技能名称用「技能」开头触发条件用「触发」开头步骤用数字列表。4.3 两个工具的技能如何保持一致如果你同时用 OpenCode 和 TRAE CN最好让两边的技能定义保持一致。做法是维护一份「母版」技能文件然后分别转换成两个工具需要的格式。OpenCode 直接用 Markdown 母版TRAE CN 用精简后的纯文本版本。这样做的价值在于你在 OpenCode 里调试好的技能流程可以快速同步到 TRAE CN不用重新设计。同步的时候注意 TRAE CN 的长度限制如果母版技能太长需要做裁剪。一个实用的技巧是给每个技能标注优先级。高优先级的技能完整保留低优先级的只保留触发条件和核心步骤省略详细说明。这样可以在有限的字符数里塞进更多技能。4.4 TRAE CN 里技能不触发的排查路径TRAE CN 里技能不触发是最常见的问题。排查按以下顺序走先确认规则文本是否保存成功。TRAE CN 有时候保存按钮不显眼改完没点保存就关掉设置内容就丢了。保存后重启 IDE这一步不能省。然后检查触发条件是否太模糊。如果你写的是「用户需要帮助时触发」这个条件太宽泛模型可能在任何对话里都触发也可能因为判断不了而完全不触发。触发条件要具体比如「用户明确要求审查代码时触发」。最后看技能数量是否过多。TRAE CN 的模型在解析规则时如果规则文本太长可能会截断或者忽略后面的内容。把不常用的技能删掉只留核心的几个。5. 避坑与常见问题那些让你白折腾半天的细节5.1 配置文件路径写错导致技能静默失效现象OpenCode 启动正常模型也能对话但技能完全不生效没有任何报错。原因instructions字段里的路径写错了或者 glob 没匹配到任何文件。OpenCode 对匹配不到文件的路径不会报错而是静默跳过。解决先用ls或dir确认路径下的文件确实存在然后检查 glob 写法。Windows 上特别注意路径分隔符建议统一用正斜杠。如果路径里有空格需要用引号包裹。5.2 TRAE CN 规则文本超长被截断现象粘贴了一大段技能规则保存后只有前几个技能生效后面的完全没反应。原因TRAE CN 对规则文本有长度上限超出部分被截断。不同版本的上限不一样但通常在几千字符级别。解决精简技能描述去掉冗余说明只保留触发条件和核心步骤。如果技能确实多考虑分批次使用或者把低频技能做成手动触发的形式。5.3 模型提供方切换后技能格式不兼容现象换了一个模型提供方之后之前能用的技能突然不生效了或者执行步骤乱套。原因不同模型对系统提示的解析能力不一样。有的模型对结构化提示的遵循度高有的模型会忽略部分指令。技能文件里的格式如果过于依赖某种解析方式换模型后就可能失效。解决技能文件尽量用自然语言描述减少对特定格式的依赖。触发条件和执行步骤用明确的短句避免嵌套结构。换模型后重新测试一遍核心技能。5.4 免费额度限制导致的调用失败现象配置都正确但调用模型时报错提示免费额度只能在特定环境使用。原因部分提供方的免费额度有使用范围限制比如只能在官方客户端内使用不支持 API 调用。解决确认你的使用方式是否在免费额度允许的范围内。如果确实需要 API 调用需要升级方案或更换提供方。这个限制和 OpenCode 或 TRAE CN 本身无关是提供方的策略。5.5 技能冲突导致执行流程混乱现象配置了多个技能后模型在执行时把不同技能的步骤混在一起输出结果不符合任何一个技能的预期。原因多个技能的触发条件有重叠模型无法判断该用哪个于是把几个技能的步骤拼凑在一起。解决检查各技能的触发条件是否有交集。如果有调整措辞让它们互斥。比如一个技能触发条件是「审查代码」另一个是「重构代码」这两个在语义上有重叠需要明确区分。可以在触发条件里加上更具体的限定词。6. 进阶让 Superpowers 技能包可维护、可迁移6.1 用版本管理管住技能文件技能文件多了之后手动同步两个工具很容易漏。我现在的做法是把技能母版放在 Git 仓库里OpenCode 直接引用仓库里的文件TRAE CN 那边写一个简单的转换脚本把 Markdown 转成纯文本后粘贴。转换脚本不需要复杂一个 Python 脚本几十行就够import re from pathlib import Path def md_to_trae(md_text): # 去掉 Markdown 标题标记保留文本 text re.sub(r^#\s*, , md_text, flagsre.MULTILINE) # 去掉加粗和斜体标记 text re.sub(r\*{1,2}(.?)\*{1,2}, r\1, text) # 压缩连续空行 text re.sub(r\n{3,}, \n\n, text) return text.strip() skills_dir Path(./superpowers/skills) output [] for f in sorted(skills_dir.glob(*.md)): output.append(md_to_trae(f.read_text(encodingutf-8))) Path(./trae_rules.txt).write_text(\n\n---\n\n.join(output), encodingutf-8) print(f转换完成共 {len(output)} 个技能)逻辑说明脚本遍历技能目录下的所有 Markdown 文件逐个去掉格式标记然后拼接成一个纯文本文件。---分隔符用来在 TRAE CN 里区分不同技能。参数说明skills_dir指向你的技能目录根据实际情况修改。输出文件trae_rules.txt的内容直接粘贴到 TRAE CN 的规则区域即可。如果 TRAE CN 有长度限制可以在脚本里加一个截断逻辑只保留前 N 个字符。6.2 技能效果的量化验证方法技能配好了怎么知道它真的有用我一般用一组固定的测试用例来验证。准备五个典型场景的输入比如「审查这段代码」「给这个函数写测试」「重构这个模块」然后看模型的输出是否符合技能定义的流程。验证的时候关注三个指标触发准确率该触发的时候触发了吗、流程遵循度执行步骤和技能定义一致吗、输出质量结果是否可用。这三个指标不需要精确量化但要有记录方便对比不同配置的效果。6.3 技能包的迁移与复用换项目或者换机器的时候技能包的迁移是个实际问题。OpenCode 这边简单把技能目录和配置文件一起复制过去就行。TRAE CN 那边需要重新粘贴规则文本如果之前用脚本生成的重新跑一遍脚本就好。我自己的习惯是技能母版永远放在 Git 仓库里配置文件和转换脚本也一起管。换环境的时候 clone 下来跑一遍脚本两个工具都能快速恢复。这个习惯帮我省了很多重复配置的时间也避免了「上次配好的技能这次忘了怎么配」的尴尬。希望帮到你。本文还有配套的精品资源点击获取
OpenCode 与 TRAE CN 配置指南：Superpowers 技能包注入与避坑
简介这份源码包面向使用 OpenCode 与 TRAE CN 进行开发的工程师聚焦 Superpowers 插件与 ui-ux-pro-max 技能的配置落地解决插件路径不一致、代码生成规则松散等实际问题。包内共 3 个文件以 inscode 工程配置、html 页面与 gitignore 忽略规则为主压缩包约 6KB体量轻巧便于直接解压后对照搭建本地环境。内容围绕克隆仓库、创建符号链接、设置目录结构展开并给出通过 AGENTS.md 或 opencode.json 约束代码生成规则的具体做法同时针对 TRAE CN 环境补充了路径适配与常见问题处理思路。已有 2102 人学习适合希望把插件、技能与规则组合起来、稳定产出可运行代码的前端与全栈开发者参考也可作为团队统一开发配置的入门模板。1. OpenCode 与 TRAE CN 的 Superpowers这套组合到底解决什么问题如果你最近在折腾 AI 编程工具链大概率同时刷到过 OpenCode 和 TRAE CN 这两个名字。OpenCode 是一个终端里的 AI 编程代理能读代码、改文件、跑命令TRAE CN 是字节跳动推出的 AI IDE国内网络环境下开箱即用。两者单独用都不差但真正让一线开发者兴奋的是 Superpowers——一套给 AI 代理加装「技能包」的配置体系让模型不再只会聊天而是按预设流程干活。标题里的「配置指南」四个字核心痛点在于OpenCode 和 TRAE CN 各自有独立的配置入口Superpowers 的注入方式也不一样。很多人卡在「装完了但技能不生效」「模型能对话但不会调工具」这两步。这篇内容面向已经上手过至少一个 AI 编程工具、想把这套组合跑通的开发者从配置原理讲到可复现的操作步骤再到实际踩过的坑。2. Superpowers 的加载机制为什么你的技能包不生效2.1 Superpowers 到底往哪里注入Superpowers 本质上是一组结构化的提示词模板加工具调用声明它需要被注入到 AI 代理的系统提示system prompt或项目级配置文件中。OpenCode 和 TRAE CN 的注入点完全不同。OpenCode 的配置走的是项目根目录下的配置文件加全局配置目录。它读取配置的优先级是项目级配置覆盖全局配置。Superpowers 的技能定义通常放在一个独立的目录里通过配置文件里的指令字段引入。如果你只把技能文件丢进目录却没在配置里声明OpenCode 启动时根本不会加载。TRAE CN 的机制不一样。它作为 IDE配置入口在设置面板和项目级的规则文件里。Superpowers 在 TRAE CN 里通常以「自定义指令」或「规则集」的形式存在需要手动粘贴或通过规则文件导入。TRAE CN 不会自动扫描某个目录下的技能文件这一点和 OpenCode 有本质区别。理解这个差异之后很多「装了没反应」的问题就说得通了——你把 OpenCode 的技能目录结构直接搬到 TRAE CN 里它当然不认。2.2 配置文件的最小可用结构先看 OpenCode 这边。一个能让 Superpowers 生效的最小配置结构大致如下{ instructions: [ ./superpowers/skills/*.md ], provider: { default: your-provider-name }, model: your-model-id }这段配置做了三件事instructions字段告诉 OpenCode 去哪个路径加载技能定义文件provider指定默认的模型提供方model指定具体调用的模型。技能文件本身是 Markdown 格式每个文件描述一个技能的名称、触发条件和执行步骤。参数说明instructions支持数组可以写多个路径也支持 glob 通配。路径是相对于项目根目录的。如果你把技能文件放在全局配置目录里需要用绝对路径或者~开头的路径。provider和model这两个字段必须和你实际使用的服务匹配写错了会在启动时报错。TRAE CN 这边没有 JSON 配置文件这种形式它的规则注入走的是 IDE 设置里的自定义指令区域。你需要把 Superpowers 的技能描述整理成一段连续的文本粘贴进去。TRAE CN 对指令长度有限制所以技能包不能太大通常只保留最常用的三到五个技能。2.3 验证技能是否加载成功配置写完不代表生效。OpenCode 里可以用一个简单的方法验证启动后输入一个会触发技能的命令看它是否按照技能定义的流程走。比如某个技能定义了「先读文件再改代码」的流程如果模型直接开始改代码而没读文件说明技能没加载。TRAE CN 的验证更直接——在对话里问它「你当前有哪些技能可用」如果它能列出你配置的技能名称说明注入成功。如果它回答「我没有技能」或者答非所问检查指令区域是否保存成功以及是否重启了 IDE。提示TRAE CN 修改自定义指令后需要重启 IDE 才能生效这一点和 OpenCode 的热加载不同。3. OpenCode 侧配置实操从安装到技能跑通3.1 安装 OpenCode 与首次初始化OpenCode 的安装方式取决于你的操作系统。常见做法是通过包管理器安装比如在 macOS 上用 Homebrew在 Windows 上用 Scoop 或直接下载二进制文件。安装完成后在终端里执行初始化命令opencode init这个命令会在当前目录下生成一个基础配置文件。如果你是在已有项目里操作它会检测项目类型并给出推荐配置。初始化完成后你会得到一个配置文件里面包含了 provider 和 model 的占位符需要你填入实际值。参数说明opencode init默认在当前目录生成配置。如果你想在全局范围初始化加--global参数。初始化不会覆盖已有配置如果目录下已经有配置文件它会提示你是否合并。3.2 接入模型提供方与常见报错处理OpenCode 支持多种模型提供方。配置的时候需要注意不同提供方的字段名可能不一样。一个常见的配置片段{ provider: { openai: { apiKey: your-key-here, baseURL: https://your-endpoint/v1 } }, model: gpt-4o }这里apiKey和baseURL是最容易出问题的两个字段。baseURL如果写错启动时会报连接错误apiKey如果无效会在第一次调用模型时报鉴权失败。有一个高频报错值得单独说error from provider (console): opencodes free tier can only be used from within opencode。这个报错的意思是你使用的免费额度只能在 OpenCode 自身的界面内使用不能通过外部 API 调用。解决办法是确认你是在 OpenCode 的交互界面里操作而不是通过脚本或其他工具去调它的接口。如果你确实需要外部调用需要升级到付费方案或者换一个提供方。另一个常见问题是模型 ID 写错。不同提供方的模型命名规则不一样有的用gpt-4o有的用openai/gpt-4o。写错了不会报「模型不存在」而是会报一个模糊的连接错误让人以为是网络问题。排查的时候先确认模型 ID 是否和提供方文档一致。3.3 把 Superpowers 技能包挂载到项目技能包的挂载分两步放文件、写配置。先把技能文件放到项目下的一个目录里比如superpowers/skills/。每个技能文件是一个 Markdown 文件结构大致如下# 技能名称代码审查 ## 触发条件 当用户要求审查代码时触发。 ## 执行步骤 1. 读取目标文件 2. 逐行分析潜在问题 3. 输出审查报告然后在 OpenCode 的配置文件里引用这个目录{ instructions: [ ./superpowers/skills/*.md ] }逻辑说明OpenCode 启动时会读取instructions字段里的所有路径把匹配到的 Markdown 文件内容加载到系统提示中。技能文件里的「触发条件」和「执行步骤」会被模型用来判断何时调用该技能以及如何执行。参数说明glob 模式*.md只会匹配当前目录下的 Markdown 文件不会递归子目录。如果你的技能文件有分类目录结构需要写成./superpowers/skills/**/*.md。路径分隔符在 Windows 上要用正斜杠或者双反斜杠单反斜杠会被当成转义字符。3.4 用一条命令验证技能是否生效配置完成后用下面这个方式快速验证opencode run 请列出你当前可用的技能如果配置正确模型会列出你挂载的技能名称。如果它说「没有可用技能」或者列出的技能不对按以下顺序排查配置文件路径是否正确、glob 是否匹配到了文件、文件内容格式是否符合要求。注意OpenCode 对技能文件的格式有一定要求如果 Markdown 文件里没有明确的标题结构模型可能无法正确解析技能名称和触发条件。4. TRAE CN 侧配置实操规则注入与技能对齐4.1 TRAE CN 的规则入口在哪里TRAE CN 作为 IDE配置入口和 OpenCode 完全不同。打开 TRAE CN 后进入设置面板找到「AI 规则」或「自定义指令」区域。不同版本的 TRAE CN 这个入口的位置可能有差异常见做法是在设置里搜索「规则」或「指令」关键词。找到入口后你会看到一个文本输入区域。这里就是注入 Superpowers 技能的地方。和 OpenCode 不同TRAE CN 不支持引用外部文件路径你需要把技能内容直接粘贴进去或者通过规则文件导入功能上传。TRAE CN 对指令文本有长度限制通常在几千字符左右。这意味着你不能把所有技能都塞进去需要做取舍。我一般会保留最常用的三到四个技能比如代码审查、单元测试生成、重构建议。4.2 把 Superpowers 技能转成 TRAE CN 规则格式OpenCode 的技能文件是 Markdown 格式TRAE CN 的规则区域接受纯文本。转换的时候需要做精简去掉 Markdown 的格式标记保留核心的触发条件和执行步骤。一个转换后的规则文本示例技能代码审查 触发用户要求审查代码时 步骤 1. 读取目标文件内容 2. 检查命名规范、错误处理、边界条件 3. 按严重程度分级输出问题列表这段文本粘贴到 TRAE CN 的规则区域后保存并重启 IDE。重启后在对话里测试触发条件看它是否按照步骤执行。参数说明TRAE CN 的规则文本没有严格的格式要求但结构清晰的内容更容易被模型正确解析。建议每个技能之间用空行分隔技能名称用「技能」开头触发条件用「触发」开头步骤用数字列表。4.3 两个工具的技能如何保持一致如果你同时用 OpenCode 和 TRAE CN最好让两边的技能定义保持一致。做法是维护一份「母版」技能文件然后分别转换成两个工具需要的格式。OpenCode 直接用 Markdown 母版TRAE CN 用精简后的纯文本版本。这样做的价值在于你在 OpenCode 里调试好的技能流程可以快速同步到 TRAE CN不用重新设计。同步的时候注意 TRAE CN 的长度限制如果母版技能太长需要做裁剪。一个实用的技巧是给每个技能标注优先级。高优先级的技能完整保留低优先级的只保留触发条件和核心步骤省略详细说明。这样可以在有限的字符数里塞进更多技能。4.4 TRAE CN 里技能不触发的排查路径TRAE CN 里技能不触发是最常见的问题。排查按以下顺序走先确认规则文本是否保存成功。TRAE CN 有时候保存按钮不显眼改完没点保存就关掉设置内容就丢了。保存后重启 IDE这一步不能省。然后检查触发条件是否太模糊。如果你写的是「用户需要帮助时触发」这个条件太宽泛模型可能在任何对话里都触发也可能因为判断不了而完全不触发。触发条件要具体比如「用户明确要求审查代码时触发」。最后看技能数量是否过多。TRAE CN 的模型在解析规则时如果规则文本太长可能会截断或者忽略后面的内容。把不常用的技能删掉只留核心的几个。5. 避坑与常见问题那些让你白折腾半天的细节5.1 配置文件路径写错导致技能静默失效现象OpenCode 启动正常模型也能对话但技能完全不生效没有任何报错。原因instructions字段里的路径写错了或者 glob 没匹配到任何文件。OpenCode 对匹配不到文件的路径不会报错而是静默跳过。解决先用ls或dir确认路径下的文件确实存在然后检查 glob 写法。Windows 上特别注意路径分隔符建议统一用正斜杠。如果路径里有空格需要用引号包裹。5.2 TRAE CN 规则文本超长被截断现象粘贴了一大段技能规则保存后只有前几个技能生效后面的完全没反应。原因TRAE CN 对规则文本有长度上限超出部分被截断。不同版本的上限不一样但通常在几千字符级别。解决精简技能描述去掉冗余说明只保留触发条件和核心步骤。如果技能确实多考虑分批次使用或者把低频技能做成手动触发的形式。5.3 模型提供方切换后技能格式不兼容现象换了一个模型提供方之后之前能用的技能突然不生效了或者执行步骤乱套。原因不同模型对系统提示的解析能力不一样。有的模型对结构化提示的遵循度高有的模型会忽略部分指令。技能文件里的格式如果过于依赖某种解析方式换模型后就可能失效。解决技能文件尽量用自然语言描述减少对特定格式的依赖。触发条件和执行步骤用明确的短句避免嵌套结构。换模型后重新测试一遍核心技能。5.4 免费额度限制导致的调用失败现象配置都正确但调用模型时报错提示免费额度只能在特定环境使用。原因部分提供方的免费额度有使用范围限制比如只能在官方客户端内使用不支持 API 调用。解决确认你的使用方式是否在免费额度允许的范围内。如果确实需要 API 调用需要升级方案或更换提供方。这个限制和 OpenCode 或 TRAE CN 本身无关是提供方的策略。5.5 技能冲突导致执行流程混乱现象配置了多个技能后模型在执行时把不同技能的步骤混在一起输出结果不符合任何一个技能的预期。原因多个技能的触发条件有重叠模型无法判断该用哪个于是把几个技能的步骤拼凑在一起。解决检查各技能的触发条件是否有交集。如果有调整措辞让它们互斥。比如一个技能触发条件是「审查代码」另一个是「重构代码」这两个在语义上有重叠需要明确区分。可以在触发条件里加上更具体的限定词。6. 进阶让 Superpowers 技能包可维护、可迁移6.1 用版本管理管住技能文件技能文件多了之后手动同步两个工具很容易漏。我现在的做法是把技能母版放在 Git 仓库里OpenCode 直接引用仓库里的文件TRAE CN 那边写一个简单的转换脚本把 Markdown 转成纯文本后粘贴。转换脚本不需要复杂一个 Python 脚本几十行就够import re from pathlib import Path def md_to_trae(md_text): # 去掉 Markdown 标题标记保留文本 text re.sub(r^#\s*, , md_text, flagsre.MULTILINE) # 去掉加粗和斜体标记 text re.sub(r\*{1,2}(.?)\*{1,2}, r\1, text) # 压缩连续空行 text re.sub(r\n{3,}, \n\n, text) return text.strip() skills_dir Path(./superpowers/skills) output [] for f in sorted(skills_dir.glob(*.md)): output.append(md_to_trae(f.read_text(encodingutf-8))) Path(./trae_rules.txt).write_text(\n\n---\n\n.join(output), encodingutf-8) print(f转换完成共 {len(output)} 个技能)逻辑说明脚本遍历技能目录下的所有 Markdown 文件逐个去掉格式标记然后拼接成一个纯文本文件。---分隔符用来在 TRAE CN 里区分不同技能。参数说明skills_dir指向你的技能目录根据实际情况修改。输出文件trae_rules.txt的内容直接粘贴到 TRAE CN 的规则区域即可。如果 TRAE CN 有长度限制可以在脚本里加一个截断逻辑只保留前 N 个字符。6.2 技能效果的量化验证方法技能配好了怎么知道它真的有用我一般用一组固定的测试用例来验证。准备五个典型场景的输入比如「审查这段代码」「给这个函数写测试」「重构这个模块」然后看模型的输出是否符合技能定义的流程。验证的时候关注三个指标触发准确率该触发的时候触发了吗、流程遵循度执行步骤和技能定义一致吗、输出质量结果是否可用。这三个指标不需要精确量化但要有记录方便对比不同配置的效果。6.3 技能包的迁移与复用换项目或者换机器的时候技能包的迁移是个实际问题。OpenCode 这边简单把技能目录和配置文件一起复制过去就行。TRAE CN 那边需要重新粘贴规则文本如果之前用脚本生成的重新跑一遍脚本就好。我自己的习惯是技能母版永远放在 Git 仓库里配置文件和转换脚本也一起管。换环境的时候 clone 下来跑一遍脚本两个工具都能快速恢复。这个习惯帮我省了很多重复配置的时间也避免了「上次配好的技能这次忘了怎么配」的尴尬。希望帮到你。本文还有配套的精品资源点击获取