docs: README 新增 Copilot CLI / Hermes Agent 支持说明,工具数更新为 16

- 标题、工具表格、手动安装、配置文件、页脚等 9 处 14→16
- 工具表格新增 Copilot CLI 和 Hermes Agent 两行
- 新增 docs/README.hermes.md 详细安装指南
- 详细安装指南链接列表补充 Hermes Agent
This commit is contained in:
jiangnan
2026-04-13 22:21:58 +08:00
parent d89daf9fc2
commit c86b269718
2 changed files with 110 additions and 8 deletions

96
docs/README.hermes.md Normal file
View File

@@ -0,0 +1,96 @@
# Superpowers 中文版 — Hermes Agent 安装指南
在 [Hermes Agent](https://github.com/NousResearch/hermes-agent) 中使用 superpowers-zh 的完整指南。
## 自动安装
```bash
cd /your/project
npx superpowers-zh --tool hermes
```
安装脚本会将 20 个 skills 复制到 `.hermes/skills/` 目录,并自动生成 `HERMES.md` 引导文件(含工具映射表和 skills 列表)。
如果项目中已存在 `.hermes` 目录或 `HERMES.md` 文件,也会被自动检测到:
```bash
npx superpowers-zh # 自动检测
```
## 手动安装
```bash
git clone https://github.com/jnMetaCode/superpowers-zh.git
cp -r superpowers-zh/skills /your/project/.hermes/skills
```
## 通过 HERMES.md 引导
Hermes Agent 在会话开始时自动加载项目根目录下的 `HERMES.md`(或 `.hermes.md`)作为上下文。安装器会自动生成此文件,内容包括:
- 工具映射表Claude Code → Hermes Agent 工具名称)
- 所有可用 skills 的列表和描述
- 核心规则和使用说明
## 通过 config.yaml 配置外部 skills 目录
如果希望全局使用 superpowers-zh skills可以在 `~/.hermes/config.yaml` 中配置:
```yaml
skills:
external_dirs:
- /path/to/superpowers-zh/skills
```
## 工具映射
Skills 中引用的 Claude Code 工具名称对应 Hermes Agent 的等价工具:
| Claude Code | Hermes Agent |
|-------------|-------------|
| `Read` | `read_file` |
| `Write` | `write_file` |
| `Edit` | `patch` |
| `Bash` | `terminal` |
| `Grep` / `Glob` | `search_files` |
| `Skill` | `skill_view` |
| `Task`(子智能体) | `delegate_task` |
| `WebSearch` | `web_search` |
| `WebFetch` | `web_extract` |
| `TodoWrite` | `todo` |
完整映射参见 `skills/using-superpowers/references/hermes-tools.md`
## 使用技能
Hermes Agent 支持三级渐进式加载:
```
# 浏览所有可用技能
skills_list
# 加载某个技能的完整内容
skill_view("brainstorming")
# 查看技能的引用文件
skill_view("using-superpowers", "references/hermes-tools.md")
```
## 故障排查
### Skills 未发现
1. 确认 `.hermes/skills/` 目录存在且包含 skill 文件夹
2. 每个 skill 目录下需要有 `SKILL.md` 文件
3. 使用 `skills_list` 查看已发现的技能
### HERMES.md 未加载
1. 确认文件在项目根目录(与 `.hermes/` 同级)
2. 文件名可以是 `HERMES.md``.hermes.md`
## 获取帮助
- 提交 Issuehttps://github.com/jnMetaCode/superpowers-zh/issues
- 项目主页https://github.com/jnMetaCode/superpowers-zh
- Hermes Agent 文档https://hermes-agent.nousresearch.com/docs/