mirror of
https://github.com/jnMetaCode/superpowers-zh.git
synced 2026-09-03 07:23:56 +08:00
7bc9acde14
OpenClaw 安装指南的"使用"段写"输入 /brainstorming 开始头脑风暴"和 "输入 /commit 使用中文提交规范"——这两条都是过时引用： - `/brainstorming` 不是有效 slash command（commands/ 目录在 v5.1.0 已删， 且我们的 commands/ 里也从来没有 brainstorming 这个名字） - `/commit` 完全不存在（我们没有 commit 这个 skill；可能想表达 chinese-commit-conventions，但 slash command 形式也不存在） - 即便 commands/ 还在的年代，OpenClaw 也不一定把 skill 自动暴露为 slash command 改写为 OpenClaw 实际生效的触发方式：AI 通过 skill frontmatter 的 description 字段自主选择 skill。文档同时给出 4 个高频触发场景示例， 并说明强制触发的方式（在指令里点名 skill）。
106 lines
2.7 KiB
Markdown
106 lines
2.7 KiB
Markdown
# Superpowers 中文版 — OpenClaw 安装指南
|
||
|
||
在 [OpenClaw](https://github.com/anthropics/openclaw) 中使用 superpowers-zh 的完整指南。
|
||
|
||
## 快速安装
|
||
|
||
```bash
|
||
cd /your/project
|
||
npx superpowers-zh
|
||
```
|
||
|
||
安装脚本会自动检测 `.openclaw/` 目录并将 skills 复制到 `skills/` 目录。
|
||
|
||
## 手动安装
|
||
|
||
```bash
|
||
git clone https://github.com/jnMetaCode/superpowers-zh.git
|
||
cp -r superpowers-zh/skills/* /your/project/skills/
|
||
```
|
||
|
||
或安装到全局（所有项目共享）：
|
||
|
||
```bash
|
||
cp -r superpowers-zh/skills/* ~/.openclaw/skills/
|
||
```
|
||
|
||
## 工作原理
|
||
|
||
OpenClaw 按以下优先级加载 skills：
|
||
|
||
| 位置 | 优先级 | 说明 |
|
||
|------|--------|------|
|
||
| `<workspace>/skills/` | 最高 | 工作区级，当前项目专用 |
|
||
| `~/.openclaw/skills/` | 中 | 用户级，所有项目共享 |
|
||
| 内置 skills | 最低 | OpenClaw 自带 |
|
||
|
||
每个 skill 是一个 `skills/{name}/SKILL.md` 文件，包含 YAML frontmatter 和指令内容。OpenClaw 会自动发现并加载。
|
||
|
||
### 推荐配置方式
|
||
|
||
在项目根目录的 `CLAUDE.md` 或 `AGENTS.md` 中引用：
|
||
|
||
```markdown
|
||
# CLAUDE.md
|
||
|
||
本项目使用 superpowers-zh skills 框架。
|
||
优先使用 brainstorming（头脑风暴）开始新任务。
|
||
Skills 位于 skills/ 目录下。
|
||
```
|
||
|
||
### 工具映射
|
||
|
||
OpenClaw 与 Claude Code 使用相同的工具名称，skills 无需额外适配：
|
||
|
||
| 工具 | OpenClaw | Claude Code |
|
||
|------|----------|-------------|
|
||
| 读文件 | `Read` | `Read` |
|
||
| 写文件 | `Write` | `Write` |
|
||
| 编辑 | `Edit` | `Edit` |
|
||
| 终端 | `Bash` | `Bash` |
|
||
| Skills | `Skill` | `Skill` |
|
||
|
||
## 使用
|
||
|
||
安装完成后重启 OpenClaw，所有 skills 会自动生效。AI 会按任务上下文自动调用对应 skill：
|
||
|
||
- 新任务 / 新功能 → `brainstorming`（头脑风暴）
|
||
- 写 commit message → `chinese-commit-conventions`（中文 commit 规范）
|
||
- 调试问题 → `systematic-debugging`
|
||
- 完成任务后 → `requesting-code-review`（请求代码审查）
|
||
|
||
无需手动 slash command 触发 —— AI 通过 skill frontmatter 的 `description` 字段自主选择匹配的 skill。如果想强制触发某个 skill，直接在指令里点名："用 brainstorming 帮我想一下 X 怎么做"。
|
||
|
||
## 全局 Skills
|
||
|
||
如果你想让所有项目都能使用 superpowers-zh：
|
||
|
||
```bash
|
||
mkdir -p ~/.openclaw/skills
|
||
cp -r superpowers-zh/skills/* ~/.openclaw/skills/
|
||
```
|
||
|
||
也可以通过 `~/.openclaw/openclaw.json` 配置额外 skills 目录：
|
||
|
||
```json
|
||
{
|
||
"skills": {
|
||
"load": {
|
||
"extraDirs": ["/path/to/superpowers-zh/skills"]
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
## 更新
|
||
|
||
```bash
|
||
cd /your/project
|
||
npx superpowers-zh
|
||
```
|
||
|
||
## 获取帮助
|
||
|
||
- 提交 Issue：https://github.com/jnMetaCode/superpowers-zh/issues
|
||
- QQ 群：833585047
|