mirror of https://github.com/jnMetaCode/superpowers-zh.git synced 2026-09-02 22:54:06 +08:00

Files

AI不止语 033adc3768 fix(docs): 4 条死链，其中 2 条是编造的仓库地址；新增外链验活门禁

核查 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。

2026-08-12 19:34:16 +08:00

2.7 KiB

Raw Permalink Blame History

Superpowers 中文版 — OpenClaw 安装指南

在 OpenClaw 中使用 superpowers-zh 的完整指南。

快速安装

cd /your/project
npx superpowers-zh

安装脚本会自动检测 .openclaw/ 目录并将 skills 复制到 skills/ 目录。

手动安装

git clone https://github.com/jnMetaCode/superpowers-zh.git
cp -r superpowers-zh/skills/* /your/project/skills/

或安装到全局（所有项目共享）：

cp -r superpowers-zh/skills/* ~/.openclaw/skills/

工作原理

OpenClaw 按以下优先级加载 skills：

位置	优先级	说明
`<workspace>/skills/`	最高	工作区级，当前项目专用
`~/.openclaw/skills/`	中	用户级，所有项目共享
内置 skills	最低	OpenClaw 自带

每个 skill 是一个 skills/{name}/SKILL.md 文件，包含 YAML frontmatter 和指令内容。OpenClaw 会自动发现并加载。

工具映射

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：

mkdir -p ~/.openclaw/skills
cp -r superpowers-zh/skills/* ~/.openclaw/skills/

也可以通过 ~/.openclaw/openclaw.json 配置额外 skills 目录：

{
  "skills": {
    "load": {
      "extraDirs": ["/path/to/superpowers-zh/skills"]
    }
  }
}

更新

cd /your/project
npx superpowers-zh

获取帮助

提交 Issue：https://github.com/jnMetaCode/superpowers-zh/issues
QQ 群：833585047

2.7 KiB Raw Permalink Blame History Unescape Escape