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
2.6 KiB
Superpowers 中文版 — Crush 安装指南
在 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。