Superpowers 中文版

June 2, 2026 · View on GitHub

Trae(字节跳动 AI IDE)中使用 superpowers-zh 的完整指南。

快速安装

cd /your/project
npx superpowers-zh

安装脚本会自动检测 .trae/ 目录,将各 skill 完整复制到 .trae/skills/(含 SKILL.md 及其 scripts/ 等附属文件),并在 .trae/rules/superpowers-zh.md 生成一份 bootstrap 规则用于自动触发。

手动安装

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

手动复制只会放好 skill 文件,不会生成 .trae/rules/ 下的 bootstrap 自动触发规则。建议优先用上面的 npx superpowers-zh,否则需要在对话里手动点名 skill 才会激活。

工作原理

Trae 使用 .rules 机制管理 AI 行为:

  • 目录.trae/rules/
  • 格式:Markdown + metadata(description、globs、alwaysApply、priority)
  • 规则类型
    • 项目规则(Project Rules)— 仅作用于当前项目
    • 个人规则(Personal Rules)— 用户级别,可被项目规则覆盖
  • 优先级:1-4,数值越高优先级越高

Skills 适配

安装器把各 skill 放在 .trae/skills/<skill-name>/,并在 .trae/rules/superpowers-zh.md 写入一份 bootstrap 规则。Trae 初始化时加载 .trae/rules/ 下的规则,bootstrap 规则会引导 AI 在任务匹配时读取对应的 .trae/skills/<skill-name>/SKILL.md 并遵循其流程。

推荐配置

安装完成后,在 Trae 的 Builder Mode 或 Chat 中提到 skill 名称即可激活:

使用头脑风暴 skill 来分析这个需求

中文支持

Trae 原生支持中文,与 superpowers-zh 完美配合:

  • 所有 skills 均为中文
  • 中文代码审查、中文 Git 工作流等国内特色 skills 开箱即用
  • 支持 MCP 协议扩展

更新

cd /your/project
npx superpowers-zh

卸载 / 误装清理

如果不小心在主目录(~)误跑了 npx superpowers-zh,会把 skills 和 .trae/rules/superpowers-zh.md 写到你的 home。v1.2.1 起会主动拒绝,但老版本可能已经污染过。清理:

cd ~                                    # 或具体的项目目录
npx superpowers-zh@latest --uninstall

会删除 .trae/skills/ 下装过的 skill、.trae/rules/superpowers-zh.md,并清理 CLAUDE.md 等文件里的 superpowers-zh 段(保留你自己写的内容)。

获取帮助