mirror of
https://github.com/jnMetaCode/superpowers-zh.git
synced 2026-09-03 07:23:56 +08:00
b01a91c267
核查第五款。路径本身是对的 —— 这是查过的几款里第一个没装错地方的。但另有 两个问题。 ## ① 我们把产品搞混了 docs 标题写「Qwen Code (通义灵码)」，链接指向 tongyi.aliyun.com；README 里 把它标成「IDE 插件」。 实际：Qwen Code 是 QwenLM/qwen-code 这个**命令行工具**（Gemini CLI 的 fork）， 跑在终端里。通义灵码是阿里的 IDE 插件，**是另一个产品**，配置路径完全不同。 照着我们的文档去配通义灵码是配不通的。 这跟 #119 的 Qoder 表「没标产品面」是同一类错误：把两个不同产品面的东西 混成一份说明。docs 与简繁 README 一并更正（类型也从「IDE 插件」改回 CLI）。 ## ② 只装 skills、不写 bootstrap —— skill 是死重 实测装完项目里只有 .qwen/skills/，一个引导文件都没写。而 Claude 写 CLAUDE.md、 Gemini 写 GEMINI.md，Qwen Code 的对应物 QWEN.md 我们完全没用。 按上游的原则：没有 bootstrap，skill 就是死重 —— 文件在磁盘上但很少被调用。 两套机制都查了官方文档： - skills：qwenlm.github.io/.../features/skills/ 确认 .qwen/skills/ 与 ~/.qwen/skills/ 自动发现，无需配置 - QWEN.md：分层记忆的默认上下文文件就是 QWEN.md，从 cwd 逐层向上到项目根、 以及全局 ~/.qwen/ 都会被扫描并拼接（可用 contextFileName 改名） 已补 generateQwenBootstrap，复用 Gemini 那套结构：项目级写 ./QWEN.md，全局写 ~/.qwen/QWEN.md；已有文件则用哨兵注释追加而不覆盖。 顺带补上全局卸载的缺口：qwen 在 GLOBAL_OK 里，--global 会写 ~/.qwen/QWEN.md， 原来 GLOBAL_BOOTSTRAP_CLEAN_SECTION 只有 .claude/CLAUDE.md，装卸一轮会在用户 主目录留残留。 ## 验证 - 项目级：已有 QWEN.md 时追加，卸载后逐字节恢复用户内容 - 全局：写 ~/.qwen/QWEN.md，卸载后 HOME 下残留 0 个文件 - verify-release 新增 Qwen 段（bootstrap 写入 / 不覆盖用户内容 / 指向 .qwen/skills/ / 卸载切除干净 / 不误删用户内容 / 全局零残留），101 -> 108 pass - audit.sh 166 pass / 0 warn / 0 fail ## 范围 installer、docs、简繁 README、verify-release 均为 fork 自有，零上游偏离。
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