mirror of
https://github.com/jnMetaCode/superpowers-zh.git
synced 2026-09-03 07:23:56 +08:00
49c2e3a205
## 安装路径是对的
官方文档（bytedance-deer-flow.mintlify.app/concepts/skills）确认 DeerFlow 自动
扫描两个**写死**的目录找 SKILL.md：
for base_dir in ["skills/public", "skills/custom"]:
public 是自带的、进 git；custom 是用户装的、默认被 gitignore。无任何配置项。
我们装到 skills/custom/ 是对的。
## 但检测标记从来没匹配过
detect 写的是 deer_flow —— 用 GitHub API 列了 deer-flow main 分支的顶层目录：
.agent .github backend contracts deploy docker docs frontend plans
pr-build scripts skills tests
**没有 deer_flow。** 跟 Aider 的 .aider 是同一个毛病：真实检出从来没被自动检测
到过，用户必须手动 --tool deerflow。
改认 skills/public —— 它是 skills 机制本身、随仓库版本控制，任何 DeerFlow 检出
都有；deer_flow 保留作 1.x 兼容。实测模拟真实检出（skills/public + backend +
frontend）能正确识别为 DeerFlow 并装进 skills/custom/。
## 文档里一个查无实据的环境变量
旧文档给了 `export DEERFLOW_SKILLS_DIR=...` 的写法，容易被读成「DeerFlow 认这个
环境变量」。官方文档里没有它，目录是写死的。已删除，改为直接用绝对路径。
顺带补上原文档没说的两件事：容器挂载（skill 在沙箱里跑，两个目录挂到
/mnt/skills/，附属脚本要写容器内路径），以及由此带来的限制 —— brainstorming
的可视化伴侣是宿主机 harness 用的，在 DeerFlow 容器沙箱里不可用。
## 验证
- 模拟真实 DeerFlow 检出：自动识别 -> skills/custom/
- 卸载精确：只删我们装的 20 个，skills/public/ 与用户自建的 custom skill 不动
- verify-release B 段补 skills/public 标记，109 -> 110 pass
- audit 166 pass / 0 warn / 0 fail
Superpowers 中文版 — Windsurf 安装指南
在 Windsurf 中使用 superpowers-zh 的完整指南。
自动安装
cd /your/project
npx superpowers-zh
安装脚本会自动检测 .windsurf/ 目录并将 skills 复制到 .windsurf/skills/ 目录。
手动安装
git clone https://github.com/jnMetaCode/superpowers-zh.git
cp -r superpowers-zh/skills /your/project/.windsurf/skills
或全局安装：
cp -r superpowers-zh/skills ~/.windsurf/skills
Skill 加载优先级
| 位置 | 优先级 | 说明 |
|---|---|---|
.windsurf/skills/ |
最高 | 项目级，仅当前项目 |
~/.windsurf/skills/ |
中 | 用户级，所有项目共享 |
使用
安装完成后重启 Windsurf，skills 会自动生效。
也可以在 .windsurfrules 文件中引用 skills 目录：
请参考 .windsurf/skills/ 目录中的 SKILL.md 文件作为工作方法论。
故障排查
Skills 未生效
- 确认
.windsurf/skills/目录存在且包含 skill 文件夹 - 每个 skill 需要包含有效 YAML frontmatter 的
SKILL.md文件 - 重启 Windsurf