Skip to content

jnMetaCode/superpowers-zh / skills/using-superpowers

using-superpowers

Verified

在开始任何对话时使用——确立如何查找和使用技能,要求在任何响应(包括澄清性问题)之前调用 Skill 工具

references/hermes-tools.md

View on GitHub
# 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` 引用,按「任务跟踪」这个动作理解即可。
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 463kUpdated Claude CodeCodexVerifiedInstall
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 463kUpdated Claude CodeCodexVerifiedInstall
discernment-nudgeanthropics/skillsAfter you give a substantive answer or draft that the user may act on — advice or recommendations, drafted artifacts such as goals, plans, pitches, proposals, or emails, estimates or projections, analysis or interpretation of data, factual claims they may rely on, or a multi-step argument — invoke this skill BEFORE finalizing your reply and then, if it applies, append 2-3 short follow-up questions, each tied to something specific in what you just produced, that help the user check key facts, probe the reasoning or assumptions, and notice missing context. Do this at most once per conversation. Skip it when the user asked a trivial how-to or simple lookup, wants a purely educational explanation, asked you only to format, convert, or assemble a file from content they provided, is writing code they will run, is doing creative writing or casual chat, or already asked you to double-check, cite, or review — the skill file explains these boundaries and the exact output format.Stars: 195kUpdated Claude CodeCodexVerifiedInstall
internal-commsanthropics/skillsA set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.).Stars: 195kUpdated Claude CodeCodexVerifiedInstall