mirror of
https://github.com/jnMetaCode/superpowers-zh.git
synced 2026-09-03 07:23:56 +08:00
441d024cd6
## 我们装错了目录，一直没生效 #45 报告人说「项目级 .hermes/skills/ 里的 20 个 skill 全部返回 404，必须手动 复制到 ~/.hermes/skills/ 才被识别」。查官方文档核实，他是对的： hermes-agent.nousresearch.com/docs/user-guide/features/skills 明确 Hermes 只自动加载 ~/.hermes/skills/（原文 "the primary directory and source of truth"），项目级目录不被自动发现；外部目录必须写进 ~/.hermes/config.yaml 的 skills.external_dirs。 而我们从支持 Hermes 起就只装项目级 .hermes/skills/ —— 那个目录 Hermes 根本 不读。这不是「不好用」，是「装了完全不生效」，比不支持更糟。 ## 改法 - TARGETS 给 Hermes 加 global（~/.hermes/skills），全局成为推荐装法 - 项目级仍保留（skills 可随仓库分发），但装完打印**可直接粘贴**的配置片段： skills: external_dirs: - <项目绝对路径>/.hermes/skills 不替用户改 config.yaml —— 那是他们的文件。文档里也写明「配置里不存在的 路径会被静默跳过」，所以写错不会报错、只会没生效。 - 全局模式**不写 bootstrap**：Hermes 的用户级指令文件约定没有公开文档， 往 $HOME 根目录写 HERMES.md 是猜路径 + 污染主目录。实测确认全局装完 $HOME 根目录 0 个文件、卸载 0 残留。 ## 文档与清单 - docs/README.hermes.md 开头重写，把「必须全局」放在最前面，并注明 v1.7.8 及更早只支持项目级 = 装了不生效，是我们的实现错误 - 简繁 README：全局支持清单加 Hermes Agent，工具表的安装命令改为 --global - verify-release.sh 的 GLOBAL_OK 加 hermes、GLOBAL_NO 移除 ## 验证 - 全局：装 20 skills 到 ~/.hermes/skills、$HOME 根目录 0 文件、卸载 0 残留 - 项目级：正确打印 A/B 两种方案与绝对路径的 config.yaml 片段 - audit.sh 166 pass / 0 warn / 0 fail、verify-release.sh 90 pass / 0 fail 注：#45 的后半部分（7 个 skill 文件里 24 处硬编码 Claude 工具名）本次未动。 那属于行为塑造内容，且 references/hermes-tools.md 已有完整映射表， 应走「强化映射表引用」而非把正文改成某个 harness 专属工具名。
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