在 Crush(Charm 出品的终端 AI 编程 agent)中使用 superpowers-zh 的完整指南。
Crush 遵循 Agent Skills 开放标准,项目级会自动发现下面四个目录,无需任何配置:
.crush/skills .agents/skills .claude/skills .cursor/skills
也就是说 —— 如果你已经为 Claude Code、Cursor、Codex 或 Antigravity 装过 superpowers-zh,Crush 现在就已经能读到那些 skills 了。
这种情况下不要再装 --tool crush,否则同一批 skills 会出现两份,Crush 会重复加载。先确认一下:
ls .claude/skills .cursor/skills .agents/skills .crush/skills 2>/dev/null只要上面任一目录里已有 20 个 skill,你就不用做任何事。
只有在上述目录都为空时才需要装:
cd /your/project
npx superpowers-zh --tool crush自动检测:项目里存在 .crush/、crush.json 或 .crush.json 任一时会自动装 Crush。
Crush 支持通用全局安装:
npx superpowers-zh --global --tool crush装到 ~/.config/crush/skills/(Windows:%LOCALAPPDATA%\crush\skills\),所有项目共享。
Crush 的用户级发现路径还包括
~/.config/agents/skills/(与 Codex、Copilot CLI 等共用的跨运行时别名)。如果你已经用--global --tool codex装过,那批 skills 也会被 Crush 看到 —— 同样别重复装。
Crush 是 skills-only 适配:不需要 bootstrap 或规则文件。每个 skill 是一个含 SKILL.md 的目录,SKILL.md 的 frontmatter 带 name 与 description,Crush 据此按需发现并激活。
如果你想把 skills 放在非标准位置,Crush 也支持在配置里显式声明:
{
"options": { "skill-path": ["./other-skills"] }
}或用环境变量 CRUSH_SKILLS_DIR 覆盖默认目录。我们不动你的 crush.json —— 四个自动发现目录已经够用。
npx superpowers-zh --tool crush # 更新(覆盖式,幂等)
npx superpowers-zh --uninstall # 卸载项目级
npx superpowers-zh --global --uninstall # 卸载全局卸载只删我们装进去的 skills,不会碰你的 crush.json。