mirror of
https://github.com/jnMetaCode/superpowers-zh.git
synced 2026-09-02 22:54:06 +08:00
v1.2.1 加了主目录守护和 --uninstall 子命令,但 README/docs 里完全没提, 新功能等于"被发布但没人知道"。 - README 在「方式一」加主目录警告 link,安装方式之后加完整的 「卸载 / 误装清理」小节(含哨兵机制的数据安全说明 + 全参数表) - docs/README.trae.md(issue #17 是 trae 用户)末尾加同样的清理段
2.1 KiB
2.1 KiB
Superpowers 中文版 — Trae 安装指南
在 Trae(字节跳动 AI IDE)中使用 superpowers-zh 的完整指南。
快速安装
cd /your/project
npx superpowers-zh
安装脚本会自动检测 .trae/ 目录并将 skills 复制到 .trae/rules/。
手动安装
git clone https://github.com/jnMetaCode/superpowers-zh.git
mkdir -p /your/project/.trae/rules
cp -r superpowers-zh/skills/* /your/project/.trae/rules/
工作原理
Trae 使用 .rules 机制管理 AI 行为:
- 目录:
.trae/rules/ - 格式:Markdown + metadata(description、globs、alwaysApply、priority)
- 规则类型:
- 项目规则(Project Rules)— 仅作用于当前项目
- 个人规则(Personal Rules)— 用户级别,可被项目规则覆盖
- 优先级:1-4,数值越高优先级越高
Skills 适配
superpowers-zh 的 SKILL.md 文件可以直接作为 Trae 的 rules 使用。Trae 会在初始化时加载 .trae/rules/ 下的所有规则文件。
推荐配置
安装完成后,在 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 段(保留你自己写的内容)。