58 lines
2.3 KiB
Markdown
58 lines
2.3 KiB
Markdown
# Hermes Agent 工具映射
|
||
|
||
## 工具
|
||
|
||
| Skill 里要做的动作 | Hermes 工具 |
|
||
|------------------|------------|
|
||
| 读取文件 | `read_file` |
|
||
| 创建新文件 | `write_file` |
|
||
| 编辑文件（定点补丁） | `patch` |
|
||
| 运行 shell 命令 | `terminal` |
|
||
| 搜索文件内容 | `search_files` |
|
||
| 按文件名查找 | `terminal` 配合 `find` |
|
||
| 抓取 URL / 读网页 | `web_extract(urls=[...])` |
|
||
| 搜索网络 | `web_search(query=...)` |
|
||
| 派遣子智能体 | `delegate_task(goal=..., context=..., toolsets=[...], role="leaf")` |
|
||
| 任务跟踪 | `todo` 工具 |
|
||
| 调用 skill | `skill_view("skill-name")` |
|
||
|
||
## 指令文件
|
||
|
||
当某个 skill 提到「你的指令文件」时，在 Hermes Agent 上指的是项目目录里的 **`AGENTS.md`**，或全局的 **`~/.hermes/SOUL.md`**。
|
||
|
||
> 🇨🇳 **本节是 superpowers-zh 的增量内容，上游 obra/superpowers 没有。**
|
||
>
|
||
> 补充一条实践区分：`SOUL.md` 是**身份/人格**文件（Hermes 官方文档明确说项目工作流指令不属于它），所以 `npx superpowers-zh --tool hermes` 的**项目级**安装只写 `AGENTS.md`；**全局**安装只装 skills、不写 bootstrap —— 往 SOUL.md 里塞技能清单是误用那个文件。
|
||
|
||
## 调用 skill
|
||
|
||
Hermes Agent 有一个 `skills` 工具集，包含 `skill_view` 和 `skills_list` 两个工具。
|
||
要调用某个 superpowers skill，使用：
|
||
|
||
```
|
||
skill_view("brainstorming")
|
||
skill_view("test-driven-development")
|
||
```
|
||
|
||
如果 `skill_view` 找不到某个 superpowers skill（在插件完全注册之前，它可能还没出现在目录里），退回到直接读取 SKILL.md：
|
||
|
||
```
|
||
read_file(path="~/.hermes/plugins/superpowers/skills/<skill-name>/SKILL.md")
|
||
```
|
||
|
||
这个回退机制与其他没有原生 skill 加载能力的 harness 用的是同一套。
|
||
|
||
## 子智能体派遣
|
||
|
||
用 `delegate_task` 为并行或串行的工作流派生隔离的子智能体：
|
||
|
||
```
|
||
delegate_task(goal="...", context="...", toolsets=[...], role="leaf")
|
||
```
|
||
|
||
如果 `delegate_task` 不可用，就把工作内联做完，不要凭空编造工具调用。
|
||
|
||
## 任务跟踪
|
||
|
||
会话内的任务跟踪用 `todo` 工具。多智能体的任务看板，如果可用则使用 `hermes kanban` CLI。遇到旧文档里的 `TodoWrite` 引用，按「任务跟踪」这个动作理解即可。
|