# superpowers-zh 安装参考

## 快速安装（Hermes Agent）

```bash
cd /your/project
npx superpowers-zh --tool hermes
```

**自动检测：** 若项目目录存在 `.hermes`、`HERMES.md` 或 `.hermes.md`，自动识别为 Hermes Agent 项目。

## 输出结构

| 项目 | 路径 |
|------|------|
| 20 个 Skills | `.hermes/skills/` |
| Bootstrap 引导文件 | `HERMES.md`（项目根目录）|

## Skills 清单（20 个）

| Skill | 用途 |
|-------|------|
| brainstorming | 需求分析 → 设计规格 |
| writing-plans | 规格拆解为可执行步骤 |
| executing-plans | 按计划逐步实施 + 验证 |
| test-driven-development | 严格 TDD |
| systematic-debugging | 四阶段调试法 |
| requesting-code-review | 派遣审查 agent |
| receiving-code-review | 处理审查反馈 |
| verification-before-completion | 完成前必须验证 |
| dispatching-parallel-agents | 多任务并发 |
| subagent-driven-development | 多 agent 协作开发 |
| using-git-worktrees | 隔离式特性开发 |
| finishing-a-development-branch | 分支收尾四选一 |
| writing-skills | 创建新 skill |
| using-superpowers | 元技能 |
| chinese-code-review | 中文代码审查规范 |
| chinese-git-workflow | 适配 Gitee/Coding/极狐 GitLab/CNB |
| chinese-documentation | 中文技术文档规范 |
| chinese-commit-conventions | 中文提交规范 |
| mcp-builder | MCP 服务器构建 |
| workflow-runner | 多角色 YAML 工作流 |

## 手动指定工具

```bash
npx superpowers-zh --tool hermes      # Hermes Agent
npx superpowers-zh --tool claude     # Claude Code
npx superpowers-zh --tool cursor      # Cursor
npx superpowers-zh --tool openclaw    # OpenClaw
# ... 支持 18 款工具，见主 skill 文档
```

## 卸载

```bash
npx superpowers-zh --uninstall --tool hermes
```

## 注意事项

- **不要在 `~` 主目录运行** — v1.2.1+ 会拒绝，应在项目目录内运行
- Hermes Agent 安装时会生成 `HERMES.md` 作为 bootstrap 引导文件
- skills 目录安装到 `.hermes/skills/`（非 `~/.hermes/skills/`）
- 安装后重启 Hermes Agent 即可生效