update

.codebuddy/skills/using-superpowers/references/hermes-tools.md

@@ -0,0 +1,57 @@
+# 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` 引用，按「任务跟踪」这个动作理解即可。