Trae 使用 Superpowers Skills

前言
写代码的时候,AI 最容易出现两个问题:
- 上来就写:需求还没聊清楚就开始改代码,越改越偏。
- 过程不稳定:同样的任务,今天输出很靠谱,明天又开始“猜”和“编”。
Superpowers 的思路很直接:把成熟的软件工程流程(需求澄清、方案设计、实施计划、TDD、系统化 Debug、代码评审等)封装成一组可组合的 Skills,让 AI “按流程办事”,把输出稳定性拉上来。
这篇文章以 Trae 为例,介绍 Superpowers Skills 是什么、如何安装到 Trae、以及日常怎么用它提升产出质量。
什么是 Superpowers Skills
Superpowers 是一个“工作流 + 技能库”的组合,它把常见工程活动拆成一组可复用的技能(skill),并鼓励 AI 在合适的时机自动或半自动地调用它们。
你可以把它理解为:
- Skill = 一份可执行的 SOP:告诉 AI 这类任务要怎么问问题、怎么拆解、怎么验证、怎么交付。
- Superpowers = 一套系统化开发方式:把“凭感觉写代码”变成“按流程推进 + 可验证交付”。
以常见的几个核心 skill 为例(名称在不同适配版本里可能略有差异,但思路一致):
brainstorming:先把需求问清楚、列出约束和方案,再动手。writing-plans:把方案落成可执行的实施计划(任务拆分、文件路径、验证步骤)。executing-plans:按计划分批推进,中间设置检查点,避免跑偏。test-driven-development:用 RED/GREEN/REFACTOR 推进,实现“先测试后实现”。systematic-debugging:系统化定位根因,而不是到处试。
Trae 里 Skills 是怎么工作的
在 Trae 里,Skills 通常以规则文件的方式接入:Trae 会加载项目下的规则目录,并在对话过程中根据你提到的“skill 名称/意图”来触发对应规则。
以 superpowers-zh 的 Trae 安装说明为例,Trae 的规则机制要点是:
- 目录:
.trae/rules/ - 格式:Markdown + 元数据(例如
description、globs、alwaysApply、priority等) - 规则类型:项目规则(Project Rules)与个人规则(Personal Rules),并支持优先级(数值越高优先级越高)
安装完成后,Trae 在初始化时会加载 .trae/rules/ 下的规则文件;在 Builder Mode 或 Chat 中提到 skill 名称即可激活。
(以上机制与示例来自 superpowers-zh 的 Trae 指南)
给 Trae 安装 Superpowers Skills
这里推荐使用 superpowers-zh(中文适配版)来接入 Trae:它的 SKILL.md 可以直接作为 Trae rules 使用,并且提供了更省事的安装方式。
方式一:一键安装(推荐)
在你的项目根目录执行:
1 | cd /your/project |
安装脚本会自动检测 .trae/ 目录,并把 skills 复制到 .trae/rules/。
方式二:手动安装(更可控)
1 | git clone https://github.com/jnMetaCode/superpowers-zh.git |
安装完成后你应该看到什么
项目里会出现类似结构(示意):
1 | your-project/ |
如果你已经打开了 Trae,建议重载窗口或重新打开项目,让规则重新加载一次。
在 Trae 里怎么用(实战方式)
superpowers-zh 的推荐用法是:在 Builder Mode 或 Chat 里 直接点名 skill,让 AI 切到对应的工作流。
1. 用 brainstorming:先把需求“问清楚”
当你只有一个模糊想法时,用它:
使用头脑风暴(brainstorming)skill 来分析这个需求,不要直接写代码,先问清楚目标、边界和成功标准。
你会明显感觉到对话节奏变化:AI 会先问关键问题、给出多个方案和取舍,而不是直接开写。
2. 用 writing-plans:把方案落成“可执行计划”
当你已经确认了目标或选定方案时,用它把工作拆成可落地的步骤:
使用 writing-plans skill,基于已确认的方案输出实施计划:任务拆分、涉及文件、每步验证方式。
计划写得越清晰,后续执行越稳定(尤其是多人协作或跨模块改动时)。
3. 用 executing-plans:按计划分批推进
当你已经有一份计划(来自上一步或你自己写的):
使用 executing-plans skill,严格按这份计划执行;每完成一批给出变更摘要与验证结果。
这个方式很适合“改动面较大、但希望每次只合入小块可验证变更”的场景。
4. 用 test-driven-development:把质量变成“流程的一部分”
当你在做新增功能、修 bug 或重构时:
使用 test-driven-development skill:先写失败测试,再写最小实现让测试通过,最后重构。
如果你的项目暂时没有测试框架,也可以让它先做“测试策略与可验证性设计”,再落到具体实现。
5. 用 systematic-debugging:不要“盲修”
遇到线上问题、偶发 bug、难复现问题:
使用 systematic-debugging skill:先提出最小复现路径与假设清单,再逐条验证,最终定位根因与修复点。
一套最推荐的日常组合拳
你可以把它当成一个固定流程来用:
- brainstorming:把需求聊清楚(必要时写出小规格说明)
- writing-plans:生成实施计划(拆成短任务 + 明确验证)
- executing-plans:按计划推进(分批提交 + 阶段性自检)
- test-driven-development / systematic-debugging:在实现/排障时按对应 SOP 走
坚持一段时间后,你会发现 AI 的“稳定性”提升非常明显:更少跑偏、更少遗漏验证、更少“说修好了但其实没修好”。
更新与排障
更新
在项目根目录再次执行即可:
1 | cd /your/project |
常见问题
- “装了但不生效”:确认规则文件实际落在
.trae/rules/下;然后重载 Trae 或重新打开项目。 - “触发不到 skill”:在对话中明确点名 skill(比如
brainstorming、writing-plans),并补一句“严格按该 skill 工作流执行”。 - “输出太长/太快”:要求它分段输出并在每段后等待确认,例如“每个小节输出完等我说继续”。
参考链接
- superpowers-zh Trae 安装指南:https://github.com/jnMetaCode/superpowers-zh/blob/main/docs/README.trae.md
- superpowers(上游项目):https://github.com/obra/superpowers
- Trae Rules 文档:https://docs.trae.ai/ide/rules
- 标题: Trae 使用 Superpowers Skills
- 作者: Felix
- 创建于 : 2026-04-15 14:13:44
- 更新于 : 2026-04-18 08:45:29
- 链接: https://felixx.top/2026/04/15/202604151413/
- 版权声明: 本文章采用 CC BY-NC-SA 4.0 进行许可。