mirror of
https://github.com/jnMetaCode/superpowers-zh.git
synced 2026-09-03 07:23:56 +08:00
174817f762
v1.2.1 加了主目录守护和 --uninstall 子命令，但 README/docs 里完全没提， 新功能等于"被发布但没人知道"。 - README 在「方式一」加主目录警告 link，安装方式之后加完整的 「卸载 / 误装清理」小节（含哨兵机制的数据安全说明 + 全参数表） - docs/README.trae.md（issue #17 是 trae 用户）末尾加同样的清理段
74 lines
2.1 KiB
Markdown
74 lines
2.1 KiB
Markdown
# Superpowers 中文版 — Trae 安装指南
|
||
|
||
在 [Trae](https://www.trae.ai)（字节跳动 AI IDE）中使用 superpowers-zh 的完整指南。
|
||
|
||
## 快速安装
|
||
|
||
```bash
|
||
cd /your/project
|
||
npx superpowers-zh
|
||
```
|
||
|
||
安装脚本会自动检测 `.trae/` 目录并将 skills 复制到 `.trae/rules/`。
|
||
|
||
## 手动安装
|
||
|
||
```bash
|
||
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 协议扩展
|
||
|
||
## 更新
|
||
|
||
```bash
|
||
cd /your/project
|
||
npx superpowers-zh
|
||
```
|
||
|
||
## 卸载 / 误装清理
|
||
|
||
如果不小心在主目录（`~`）误跑了 `npx superpowers-zh`，会把 skills 和 `.trae/rules/superpowers-zh.md` 写到你的 home。v1.2.1 起会主动拒绝，但老版本可能已经污染过。清理：
|
||
|
||
```bash
|
||
cd ~ # 或具体的项目目录
|
||
npx superpowers-zh@latest --uninstall
|
||
```
|
||
|
||
会删除 `.trae/skills/` 下装过的 skill、`.trae/rules/superpowers-zh.md`，并清理 `CLAUDE.md` 等文件里的 superpowers-zh 段（保留你自己写的内容）。
|
||
|
||
## 获取帮助
|
||
|
||
- 提交 Issue：https://github.com/jnMetaCode/superpowers-zh/issues
|
||
- Trae 文档：https://docs.trae.ai/ide/rules
|