mirror of
https://github.com/jnMetaCode/superpowers-zh.git
synced 2026-09-02 22:54:06 +08:00
033adc3768
核查 OpenClaw 时发现 docs/README.openclaw.md 链的是
github.com/anthropics/openclaw —— **那个仓库不存在（404）**，真正的是
openclaw/openclaw。顺手全仓扫了一遍外链，45 条里 4 条是死的。
## 修掉的 4 条
| 原链接 | 状态 | 改为 |
|---|---|---|
| github.com/anthropics/openclaw | 404，仓库不存在 | github.com/openclaw/openclaw |
| github.com/anthropics/antigravity | 404，且 Antigravity 是**谷歌**的产品不是 Anthropic 的 | antigravity.google |
| huaweicloud.com/product/codeartsdoer.html | 404，产品页改版 | codearts.huaweicloud.com |
| docs.codeium.com/windsurf | Windsurf 已从 codeium.com 迁走 | docs.windsurf.com/... |
前两条是**编造出来的出处**。这比没有出处更坏：它让人以为核实过了。
## OpenClaw 本身：路径是对的
顺带核实完了。docs.openclaw.ai/tools/skills 确认 `<workspace>/skills` 为最高
优先级、`~/.openclaw/skills` 为全局，自动发现无需配置，与我们装的一致。
## 固化成检查（verify-release H 段）
编造链接不该靠人肉发现。新增外链验活，两遍制：
- 第一遍 xargs -P 10 并行快扫，只产出「嫌疑名单」，**不下结论**
- 第二遍对嫌疑名单串行复核，放宽到 25s 并让 curl 自己重试；两遍都判死才算死
两遍制不是过度设计 —— 第一版单遍串行把整个脚本拖到超时跑挂了；改并行后又实测
到 docs.codeium.com 在 8s 上限下偶发超时、误报成死链。**一个会误报的门禁比没有
门禁更糟：人会学会忽略它。** 连跑 3 次确认稳定，全绿。
无网络时整段跳过，不阻塞离线发版。
顺带修了个 bash 坑：`bad "死链（$code）: $u"` 里全角括号会被当成变量名的一部分，
报 `code�: unbound variable`。改用 ${code} 花括号界定。
双向验证：塞一条 github.com/anthropics/this-repo-does-not-exist 会被抓出并 FAIL，
移除后恢复全绿。
verify-release 108 -> 109 pass；audit 166 pass / 0 warn / 0 fail。
106 lines
2.7 KiB
Markdown
106 lines
2.7 KiB
Markdown
# Superpowers 中文版 — OpenClaw 安装指南
|
||
|
||
在 [OpenClaw](https://github.com/openclaw/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
|