mirror of
https://github.com/jnMetaCode/superpowers-zh.git
synced 2026-09-03 07:23:56 +08:00
1a388c6851
安装器实际把各 skill 复制到 .trae/skills/，并在 .trae/rules/superpowers-zh.md 生成 bootstrap 规则。旧文档让用户把 skills 往 .trae/rules/ 拷，会误导。对齐安装器真实行为，并注明手动复制 不会生成自动触发规则。
76 lines
2.6 KiB
Markdown
76 lines
2.6 KiB
Markdown
# Superpowers 中文版 — Trae 安装指南
|
||
|
||
在 [Trae](https://www.trae.ai)（字节跳动 AI IDE）中使用 superpowers-zh 的完整指南。
|
||
|
||
## 快速安装
|
||
|
||
```bash
|
||
cd /your/project
|
||
npx superpowers-zh
|
||
```
|
||
|
||
安装脚本会自动检测 `.trae/` 目录，将各 skill 完整复制到 `.trae/skills/`（含 `SKILL.md` 及其 `scripts/` 等附属文件），并在 `.trae/rules/superpowers-zh.md` 生成一份 bootstrap 规则用于自动触发。
|
||
|
||
## 手动安装
|
||
|
||
```bash
|
||
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 协议扩展
|
||
|
||
## 更新
|
||
|
||
```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
|