README.openclaw.md

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 会自动发现并加载。

推荐配置方式

在项目根目录的 CLAUDE.md 或 AGENTS.md 中引用：

# 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：

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