Files
frontend_v2/.codebuddy/skills/using-superpowers/references/hermes-tools.md
toom1996 4b409b5a29 update
2026-09-20 00:44:14 +08:00

2.3 KiB
Raw Blame History

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 引用,按「任务跟踪」这个动作理解即可。