mirror of
https://github.com/jnMetaCode/superpowers-zh.git
synced 2026-09-02 22:54:06 +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
75 lines
2.6 KiB
Markdown
75 lines
2.6 KiB
Markdown
# Superpowers 中文版 — Crush 安装指南
|
||
|
||
在 [Crush](https://github.com/charmbracelet/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 会重复加载。先确认一下：
|
||
|
||
```bash
|
||
ls .claude/skills .cursor/skills .agents/skills .crush/skills 2>/dev/null
|
||
```
|
||
|
||
只要上面任一目录里已有 20 个 skill，你就不用做任何事。
|
||
|
||
## 快速安装
|
||
|
||
只有在上述目录都为空时才需要装：
|
||
|
||
```bash
|
||
cd /your/project
|
||
npx superpowers-zh --tool crush
|
||
```
|
||
|
||
自动检测：项目里存在 `.crush/`、`crush.json` 或 `.crush.json` 任一时会自动装 Crush。
|
||
|
||
## 全局安装
|
||
|
||
Crush 支持通用全局安装：
|
||
|
||
```bash
|
||
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 也支持在配置里显式声明：
|
||
|
||
```json
|
||
{
|
||
"options": { "skill-path": ["./other-skills"] }
|
||
}
|
||
```
|
||
|
||
或用环境变量 `CRUSH_SKILLS_DIR` 覆盖默认目录。**我们不动你的 `crush.json`** —— 四个自动发现目录已经够用。
|
||
|
||
## 更新 / 卸载
|
||
|
||
```bash
|
||
npx superpowers-zh --tool crush # 更新（覆盖式，幂等）
|
||
npx superpowers-zh --uninstall # 卸载项目级
|
||
npx superpowers-zh --global --uninstall # 卸载全局
|
||
```
|
||
|
||
卸载只删我们装进去的 skills，**不会碰你的 `crush.json`**。
|
||
|
||
## 获取帮助
|
||
|
||
- 提交 Issue：https://github.com/jnMetaCode/superpowers-zh/issues
|
||
- Crush 仓库：https://github.com/charmbracelet/crush
|
||
- Crush skills 文档：https://charmbracelet-crush.mintlify.app/configuration/skills
|