Superpowers 中文版 — Hermes Agent 安装指南

在 Hermes Agent 中使用 superpowers-zh 的完整指南。

⚠️ 先看这一条：必须装到全局，否则不生效

Hermes 官方文档明确：Hermes 只自动加载 ~/.hermes/skills/（原文称其为 "the primary directory and source of truth"），项目级目录不会被自动发现。

所以推荐的装法是全局：

npx superpowers-zh --global --tool hermes

装到 ~/.hermes/skills/，装完即生效，用 skills_list 就能看到 20 个 skill。

📌 v1.7.8 及更早版本只支持项目级安装（装到 <项目>/.hermes/skills/）—— 那个目录 Hermes 根本不读，等于装了不生效。这是我们的实现错误，v1.7.9 起修正。见 #45。

项目级的好处是 skills 可以随仓库一起分发。但必须显式登记，否则 Hermes 看不见。

cd /your/project
npx superpowers-zh --tool hermes

安装器会打印出你需要粘贴的配置片段，形如：

skills:
  external_dirs:
    - /your/project/.hermes/skills

把它加进 ~/.hermes/config.yaml。路径支持 ~ 展开和 ${VAR} 环境变量替换；配置里不存在的路径会被静默跳过，所以写错了不会报错，只会"没生效"。

我们不替你改 config.yaml —— 那是你的配置文件。

项目级安装还会生成 HERMES.md 引导文件（含核心规则和 skills 列表），让 Hermes 在合适时机主动检查 skill。全局安装不写这个文件 —— Hermes 的用户级指令文件约定没有公开文档，我们不猜路径、也不往你的主目录里写东西。

如果同一个 skill 名在 ~/.hermes/skills/ 和某个 external_dirs 目录里都存在，本地（~/.hermes/skills/）的版本优先。

如果希望全局使用 superpowers-zh skills，可以在 ~/.hermes/config.yaml 中配置：

skills:
  external_dirs:
    - /path/to/superpowers-zh/skills

Skills 中引用的 Claude Code 工具名称对应 Hermes Agent 的等价工具：

完整映射参见 skills/using-superpowers/references/hermes-tools.md。

Hermes Agent 支持三级渐进式加载：

# 浏览所有可用技能
skills_list

# 加载某个技能的完整内容
skill_view("brainstorming")

# 查看技能的引用文件
skill_view("using-superpowers", "references/hermes-tools.md")