mirror of
https://github.com/jnMetaCode/superpowers-zh.git
synced 2026-09-02 22:54:06 +08:00
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:
96
docs/README.hermes.md
Normal file
96
docs/README.hermes.md
Normal 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`
|
||||
|
||||
## 获取帮助
|
||||
|
||||
- 提交 Issue:https://github.com/jnMetaCode/superpowers-zh/issues
|
||||
- 项目主页:https://github.com/jnMetaCode/superpowers-zh
|
||||
- Hermes Agent 文档:https://hermes-agent.nousresearch.com/docs/
|
||||
Reference in New Issue
Block a user