Trae 使用 Superpowers Skills

Felix Lv3

前言

写代码的时候,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 + 元数据(例如 descriptionglobsalwaysApplypriority 等)
  • 规则类型:项目规则(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
2
cd /your/project
npx superpowers-zh

安装脚本会自动检测 .trae/ 目录,并把 skills 复制到 .trae/rules/

方式二:手动安装(更可控)

1
2
3
git clone https://github.com/jnMetaCode/superpowers-zh.git
mkdir -p /your/project/.trae/rules
cp -r superpowers-zh/skills/* /your/project/.trae/rules/

安装完成后你应该看到什么

项目里会出现类似结构(示意):

1
2
3
4
5
6
7
8
your-project/
├── .trae/
│ └── rules/
│ ├── brainstorming.md
│ ├── writing-plans.md
│ ├── executing-plans.md
│ └── ...
└── ...

如果你已经打开了 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:先提出最小复现路径与假设清单,再逐条验证,最终定位根因与修复点。

一套最推荐的日常组合拳

你可以把它当成一个固定流程来用:

  1. brainstorming:把需求聊清楚(必要时写出小规格说明)
  2. writing-plans:生成实施计划(拆成短任务 + 明确验证)
  3. executing-plans:按计划推进(分批提交 + 阶段性自检)
  4. test-driven-development / systematic-debugging:在实现/排障时按对应 SOP 走

坚持一段时间后,你会发现 AI 的“稳定性”提升非常明显:更少跑偏、更少遗漏验证、更少“说修好了但其实没修好”。

更新与排障

更新

在项目根目录再次执行即可:

1
2
cd /your/project
npx superpowers-zh

常见问题

  • “装了但不生效”:确认规则文件实际落在 .trae/rules/ 下;然后重载 Trae 或重新打开项目。
  • “触发不到 skill”:在对话中明确点名 skill(比如 brainstormingwriting-plans),并补一句“严格按该 skill 工作流执行”。
  • “输出太长/太快”:要求它分段输出并在每段后等待确认,例如“每个小节输出完等我说继续”。

参考链接

  • 标题: 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 进行许可。
评论