mirror of
https://github.com/jnMetaCode/superpowers-zh.git
synced 2026-09-03 07:23:56 +08:00
8a2f37071a
## Crush（#40） 查权威源（charmbracelet/crush repo 文档）确认：Crush 遵循 Agent Skills 开放标准， 项目级**自动发现** .crush/skills、.agents/skills、.claude/skills、.cursor/skills 四个目录，无需任何配置；用户级为 ~/.config/crush/skills。 重要副作用写进了 docs：已经为 CC / Cursor / Codex / Antigravity 装过的用户， Crush 现在就已经能读到那些 skills，此时不要再装 --tool crush，否则同一批 skills 会有两份、被重复加载。docs 里给了确认命令。 - TARGETS 加 Crush（detect: .crush / crush.json / .crush.json），支持 --global - CLI_PROBES 加 crush（它是 CLI，PATH 探得到） - skills-only 适配，不需要 bootstrap；不动用户的 crush.json - 新增 docs/README.crush.md - 计数 22 -> 23（installer TARGETS 22 条 + Copilot CLI 单独计） 实测：装 20 skills / 二次装幂等 / 卸载零残留且正确保留用户的 crush.json； --global 装到 ~/.config/crush/skills 并可干净卸载。 ## audit Category 5 当场抓到我漏改的 5 处 加计数时忘了 site/build.mjs 的 5 个位置（三语言标语 + FAQ 枚举）。上个版本 新加的计数一致性检查直接 FAIL 拦下 —— 这是它第一次在真实改动中生效。已补 site 18 处并重建，三语言首页 23 计数、0 残留、Crush 均已出现。 ## verify-release.sh 有同样的漂移问题，已修 它有自己独立的覆盖清单，加新工具时不进去就静默不测（本次 Crush 就是： 分数仍是 82，因为压根没测它）。 - SPEC / DETECT / GLOBAL_OK 三处补 Crush - 顺带发现 B 段还漏了 3 个工具的检测标记：DeerFlow（deer_flow）、 VS Code（.github/copilot-instructions.md）、Gemini CLI（GEMINI.md）—— 后两个是文件而非目录，DETECT 循环原先一律 mkdir，现按扩展名区分创建方式 - 新增 G 段自检：SPEC 覆盖数必须等于 installer 宣称的工具数； DETECT 覆盖的工具名集合必须包含全部 TARGETS 名字（用集合比对而非数条数 —— 一个工具可以有多个检测标记，数数会误判） 覆盖从 82 项升到 90 项。 回归：audit.sh 152 pass / 0 warn / 0 fail、verify-release.sh 90 pass / 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