Skip to content

Commit c86b269

Browse files
committed
docs: README 新增 Copilot CLI / Hermes Agent 支持说明,工具数更新为 16
- 标题、工具表格、手动安装、配置文件、页脚等 9 处 14→16 - 工具表格新增 Copilot CLI 和 Hermes Agent 两行 - 新增 docs/README.hermes.md 详细安装指南 - 详细安装指南链接列表补充 Hermes Agent
1 parent d89daf9 commit c86b269

2 files changed

Lines changed: 110 additions & 8 deletions

File tree

README.md

Lines changed: 14 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,9 @@
22

33
🌐 **简体中文** | [English (upstream)](https://github.com/obra/superpowers)
44

5-
> 🦸 **superpowers(116k+ ⭐)完整汉化 + 6 个中国原创 skills** — 让 OpenClaw / Claude Code / Cursor / Windsurf / Kiro / Gemini CLI 等 **14 款 AI 编程工具**真正会干活。从头脑风暴到代码审查,从 TDD 到调试,每个 skill 都是经过实战验证的工作方法论。
5+
> 🦸 **superpowers(116k+ ⭐)完整汉化 + 6 个中国原创 skills** — 让 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI 等 **16 款 AI 编程工具**真正会干活。从头脑风暴到代码审查,从 TDD 到调试,每个 skill 都是经过实战验证的工作方法论。
66
7-
Chinese community edition of [superpowers](https://github.com/obra/superpowers) — 20 skills across 14 AI coding tools, including full translations and China-specific development skills.
7+
Chinese community edition of [superpowers](https://github.com/obra/superpowers) — 20 skills across 16 AI coding tools, including full translations and China-specific development skills.
88

99
<!-- 效果对比 -->
1010
<table>
@@ -43,7 +43,7 @@ AI:在开始实现之前,我需要了解几个关键问题:
4343

4444
| 📦 翻译 Skills | 🇨🇳 中国特色 Skills | 🤖 支持工具 |
4545
|:---:|:---:|:---:|
46-
| **14** | **6** | **OpenClaw / Claude Code / Cursor / Windsurf / Kiro / Gemini CLI / Codex / Aider / Trae / VS Code (Copilot) / DeerFlow / OpenCode / Qwen Code / Antigravity** |
46+
| **14** | **6** | **Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Codex / Aider / Trae / VS Code (Copilot) / DeerFlow / OpenCode / OpenClaw / Qwen Code / Antigravity** |
4747

4848
---
4949

@@ -53,12 +53,13 @@ AI:在开始实现之前,我需要了解几个关键问题:
5353

5454
**superpowers-zh** 在完整翻译的基础上,新增了面向中国开发者的特色 skills。
5555

56-
### 🤖 支持 14 款主流 AI 编程工具
56+
### 🤖 支持 16 款主流 AI 编程工具
5757

5858
| 工具 | 类型 | 一键安装 | 手动安装 |
5959
|------|------|:---:|:---:|
60-
| [OpenClaw](https://github.com/anthropics/openclaw) | CLI | `npx superpowers-zh` | `skills/` |
6160
| [Claude Code](https://claude.ai/code) | CLI | `npx superpowers-zh` | `.claude/skills/` |
61+
| [Copilot CLI](https://githubnext.com/projects/copilot-cli) | CLI | `npx superpowers-zh --tool copilot` | `.claude/skills/` |
62+
| [Hermes Agent](https://github.com/NousResearch/hermes-agent) | CLI | `npx superpowers-zh --tool hermes` | `.hermes/skills/` |
6263
| [Cursor](https://cursor.sh) | IDE | `npx superpowers-zh` | `.cursor/skills/` |
6364
| [Windsurf](https://codeium.com/windsurf) | IDE | `npx superpowers-zh` | `.windsurf/skills/` |
6465
| [Kiro](https://kiro.dev) | IDE | `npx superpowers-zh` | `.kiro/steering/` |
@@ -69,6 +70,7 @@ AI:在开始实现之前,我需要了解几个关键问题:
6970
| [VS Code](https://code.visualstudio.com) (Copilot) | IDE 插件 | `npx superpowers-zh` | `.github/superpowers/` |
7071
| [DeerFlow 2.0](https://github.com/bytedance/deer-flow) | Agent 框架 | `npx superpowers-zh` | `skills/custom/` |
7172
| [OpenCode](https://opencode.ai) | CLI | `npx superpowers-zh` | `.opencode/skills/` |
73+
| [OpenClaw](https://github.com/anthropics/openclaw) | CLI | `npx superpowers-zh` | `skills/` |
7274
| [Qwen Code](https://tongyi.aliyun.com/lingma) (通义灵码) | IDE 插件 | `npx superpowers-zh` | `.qwen/skills/` |
7375
| [Antigravity](https://github.com/anthropics/antigravity) | CLI | `npx superpowers-zh` | `.antigravity/skills/` |
7476

@@ -122,7 +124,8 @@ npx superpowers-zh
122124
git clone https://github.com/jnMetaCode/superpowers-zh.git
123125

124126
# 复制 skills 到你的项目(选择你使用的工具)
125-
cp -r superpowers-zh/skills /your/project/.claude/skills # Claude Code
127+
cp -r superpowers-zh/skills /your/project/.claude/skills # Claude Code / Copilot CLI
128+
cp -r superpowers-zh/skills /your/project/.hermes/skills # Hermes Agent
126129
cp -r superpowers-zh/skills /your/project/.cursor/skills # Cursor
127130
cp -r superpowers-zh/skills /your/project/.codex/skills # Codex CLI
128131
cp -r superpowers-zh/skills /your/project/.kiro/steering # Kiro
@@ -145,6 +148,8 @@ cp -r superpowers-zh/skills /your/project/.qwen/skills # Qwen Code
145148
| 工具 | 配置文件 | 说明 |
146149
|------|---------|------|
147150
| Claude Code | `CLAUDE.md` | 项目根目录 |
151+
| Copilot CLI | `CLAUDE.md` | 与 Claude Code 共用插件格式 |
152+
| Hermes Agent | `HERMES.md``.hermes.md` | 项目根目录,安装时自动生成 |
148153
| Kiro | `.kiro/steering/*.md` | 支持 always/globs/手动三种模式 |
149154
| DeerFlow 2.0 | `skills/custom/*/SKILL.md` | 字节跳动开源 SuperAgent,自动发现自定义 skills |
150155
| Trae | `.trae/rules/project_rules.md` | 项目级规则 |
@@ -156,9 +161,10 @@ cp -r superpowers-zh/skills /your/project/.qwen/skills # Qwen Code
156161
| Gemini CLI | `.gemini/skills/*/SKILL.md` | 项目级 skills 目录 |
157162
| Aider | `.aider/skills/*/SKILL.md` | 项目级 skills 目录 |
158163
| OpenCode | `.opencode/skills/*/SKILL.md` | 项目级 skills 目录 |
164+
| Hermes Agent | `.hermes/skills/*/SKILL.md` | 项目级 skills 目录 |
159165
| Qwen Code | `.qwen/skills/*/SKILL.md` | 项目级 skills 目录 |
160166

161-
> **详细安装指南**[Kiro](docs/README.kiro.md) · [DeerFlow](docs/README.deerflow.md) · [Trae](docs/README.trae.md) · [Antigravity](docs/README.antigravity.md) · [VS Code](docs/README.vscode.md) · [Codex](docs/README.codex.md) · [OpenCode](docs/README.opencode.md) · [OpenClaw](docs/README.openclaw.md) · [Windsurf](docs/README.windsurf.md) · [Gemini CLI](docs/README.gemini-cli.md) · [Aider](docs/README.aider.md) · [Qwen Code](docs/README.qwen.md)
167+
> **详细安装指南**[Kiro](docs/README.kiro.md) · [DeerFlow](docs/README.deerflow.md) · [Trae](docs/README.trae.md) · [Antigravity](docs/README.antigravity.md) · [VS Code](docs/README.vscode.md) · [Codex](docs/README.codex.md) · [OpenCode](docs/README.opencode.md) · [OpenClaw](docs/README.openclaw.md) · [Windsurf](docs/README.windsurf.md) · [Gemini CLI](docs/README.gemini-cli.md) · [Aider](docs/README.aider.md) · [Qwen Code](docs/README.qwen.md) · [Hermes Agent](docs/README.hermes.md)
162168
163169
---
164170

@@ -224,7 +230,7 @@ MIT License — 自由使用,商业或个人均可。
224230

225231
<div align="center">
226232

227-
**🦸 AI 编程超能力:让 OpenClaw / Claude Code / Cursor 等 14 款工具真正会干活**
233+
**🦸 AI 编程超能力:让 Claude Code / Hermes Agent / Cursor 等 16 款工具真正会干活**
228234

229235
[Star 本项目](https://github.com/jnMetaCode/superpowers-zh) · [提交 Issue](https://github.com/jnMetaCode/superpowers-zh/issues) · [贡献代码](https://github.com/jnMetaCode/superpowers-zh/pulls)
230236

docs/README.hermes.md

Lines changed: 96 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,96 @@
1+
# Superpowers 中文版 — Hermes Agent 安装指南
2+
3+
[Hermes Agent](https://github.com/NousResearch/hermes-agent) 中使用 superpowers-zh 的完整指南。
4+
5+
## 自动安装
6+
7+
```bash
8+
cd /your/project
9+
npx superpowers-zh --tool hermes
10+
```
11+
12+
安装脚本会将 20 个 skills 复制到 `.hermes/skills/` 目录,并自动生成 `HERMES.md` 引导文件(含工具映射表和 skills 列表)。
13+
14+
如果项目中已存在 `.hermes` 目录或 `HERMES.md` 文件,也会被自动检测到:
15+
16+
```bash
17+
npx superpowers-zh # 自动检测
18+
```
19+
20+
## 手动安装
21+
22+
```bash
23+
git clone https://github.com/jnMetaCode/superpowers-zh.git
24+
cp -r superpowers-zh/skills /your/project/.hermes/skills
25+
```
26+
27+
## 通过 HERMES.md 引导
28+
29+
Hermes Agent 在会话开始时自动加载项目根目录下的 `HERMES.md`(或 `.hermes.md`)作为上下文。安装器会自动生成此文件,内容包括:
30+
31+
- 工具映射表(Claude Code → Hermes Agent 工具名称)
32+
- 所有可用 skills 的列表和描述
33+
- 核心规则和使用说明
34+
35+
## 通过 config.yaml 配置外部 skills 目录
36+
37+
如果希望全局使用 superpowers-zh skills,可以在 `~/.hermes/config.yaml` 中配置:
38+
39+
```yaml
40+
skills:
41+
external_dirs:
42+
- /path/to/superpowers-zh/skills
43+
```
44+
45+
## 工具映射
46+
47+
Skills 中引用的 Claude Code 工具名称对应 Hermes Agent 的等价工具:
48+
49+
| Claude Code | Hermes Agent |
50+
|-------------|-------------|
51+
| `Read` | `read_file` |
52+
| `Write` | `write_file` |
53+
| `Edit` | `patch` |
54+
| `Bash` | `terminal` |
55+
| `Grep` / `Glob` | `search_files` |
56+
| `Skill` | `skill_view` |
57+
| `Task`(子智能体) | `delegate_task` |
58+
| `WebSearch` | `web_search` |
59+
| `WebFetch` | `web_extract` |
60+
| `TodoWrite` | `todo` |
61+
62+
完整映射参见 `skills/using-superpowers/references/hermes-tools.md`。
63+
64+
## 使用技能
65+
66+
Hermes Agent 支持三级渐进式加载:
67+
68+
```
69+
# 浏览所有可用技能
70+
skills_list
71+
72+
# 加载某个技能的完整内容
73+
skill_view("brainstorming")
74+
75+
# 查看技能的引用文件
76+
skill_view("using-superpowers", "references/hermes-tools.md")
77+
```
78+
79+
## 故障排查
80+
81+
### Skills 未发现
82+
83+
1. 确认 `.hermes/skills/` 目录存在且包含 skill 文件夹
84+
2. 每个 skill 目录下需要有 `SKILL.md` 文件
85+
3. 使用 `skills_list` 查看已发现的技能
86+
87+
### HERMES.md 未加载
88+
89+
1. 确认文件在项目根目录(与 `.hermes/` 同级)
90+
2. 文件名可以是 `HERMES.md` 或 `.hermes.md`
91+
92+
## 获取帮助
93+
94+
- 提交 Issue:https://github.com/jnMetaCode/superpowers-zh/issues
95+
- 项目主页:https://github.com/jnMetaCode/superpowers-zh
96+
- Hermes Agent 文档:https://hermes-agent.nousresearch.com/docs/

0 commit comments

Comments
 (0)