feat: 添加 Hermes Agent 支持（第 16 款工具）

- 安装器新增 Hermes Agent 目标（.hermes/skills/）和别名（hermes/hermes-agent） - 安装时自动生成 HERMES.md bootstrap（含工具映射和 skills 列表） - 新增 references/hermes-tools.md 工具映射表（中文化） - using-superpowers 技能新增 Hermes Agent 平台说明（skill_view 三级渐进式加载） - 各处 description 加入 Hermes Agent 名称，工具数量更新为 16 款 - package.json 添加 hermes/hermes-agent 关键词
2026-09-03 07:23:56 +08:00 · 2026-04-13 20:00:37 +08:00
parent fc9a2a40ca
commit d89daf9fc2
8 changed files with 118 additions and 6 deletions
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -1,6 +1,6 @@
 {
  "name": "superpowers-zh",
-  "description": "AI 编程超能力中文增强版：20 个 skills，支持 OpenClaw / Claude Code / Cursor 等 15 款工具",
+  "description": "AI 编程超能力中文增强版：20 个 skills，支持 Claude Code / Hermes Agent / Cursor 等 16 款工具",
  "owner": {
    "name": "jnMetaCode",
    "url": "https://github.com/jnMetaCode"
@@ -8,7 +8,7 @@
  "plugins": [
    {
      "name": "superpowers-zh",
-      "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 6 中国原创），支持 OpenClaw / Claude Code / Cursor 等 15 款工具",
+      "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 6 中国原创），支持 Claude Code / Hermes Agent / Cursor 等 16 款工具",
      "version": "1.1.6",
      "source": "./",
      "author": {
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
  "name": "superpowers-zh",
-  "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 6 中国原创），支持 OpenClaw / Claude Code / Cursor 等 15 款工具",
+  "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 6 中国原创），支持 Claude Code / Hermes Agent / Cursor 等 16 款工具",
  "version": "1.1.6",
  "author": {
    "name": "jnMetaCode",
--- a/.cursor-plugin/plugin.json
+++ b/.cursor-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
  "name": "superpowers-zh",
  "displayName": "Superpowers 中文版",
-  "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 6 中国原创），支持 OpenClaw / Cursor / Claude Code 等 15 款工具",
+  "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 6 中国原创），支持 Cursor / Claude Code / Hermes Agent 等 16 款工具",
  "version": "1.1.6",
  "author": {
    "name": "jnMetaCode",
--- a/.gitignore
+++ b/.gitignore
@@ -9,4 +9,5 @@ triage/
 # 安装器生成的 skills 副本（源在 skills/ 目录）
 .codex/skills/
 .gemini/skills/
+.hermes/skills/
 .opencode/skills/
--- a/bin/superpowers-zh.js
+++ b/bin/superpowers-zh.js
@@ -44,6 +44,7 @@ const TARGETS = [
  { name: 'Aider',         dir: '.aider/skills',             detect: '.aider' },
  { name: 'OpenCode',      dir: '.opencode/skills',          detect: '.opencode' },
  { name: 'Qwen Code',     dir: '.qwen/skills',             detect: '.qwen' },
+  { name: 'Hermes Agent',  dir: '.hermes/skills',            detect: ['.hermes', 'HERMES.md', '.hermes.md'] },
 ];

 function countDirs(dir) {
@@ -230,6 +231,62 @@ ${skillList}
  }
 }

+function generateHermesBootstrap(projectDir) {
+  const skillEntries = scanSkillEntries(SKILLS_SRC);
+  const skillList = skillEntries.map(s => `- **${s.name}**: ${s.desc}`).join('\n');
+
+  const content = `# Superpowers-ZH 中文增强版
+
+本项目已安装 superpowers-zh 技能框架（${skillEntries.length} 个 skills）。
+
+## 核心规则
+
+1. **收到任务时，先检查是否有匹配的 skill** — 哪怕只有 1% 的可能性也要检查
+2. **设计先于编码** — 收到功能需求时，先用 brainstorming skill 做需求分析
+3. **测试先于实现** — 写代码前先写测试（TDD）
+4. **验证先于完成** — 声称完成前必须运行验证命令
+
+## 工具映射
+
+技能中引用的 Claude Code 工具名称对应 Hermes Agent 的等价工具：
+- \`Read\` → \`read_file\`
+- \`Write\` → \`write_file\`
+- \`Edit\` → \`patch\`
+- \`Bash\` → \`terminal\`
+- \`Grep\` / \`Glob\` → \`search_files\`
+- \`Skill\` → \`skill_view\`
+- \`Task\`（子智能体） → \`delegate_task\`
+- \`WebSearch\` → \`web_search\`
+- \`WebFetch\` → \`web_extract\`
+- \`TodoWrite\` → \`todo\`
+
+## 可用 Skills
+
+Skills 位于 \`.hermes/skills/\` 目录，每个 skill 有独立的 \`SKILL.md\` 文件。
+
+${skillList}
+
+## 如何使用
+
+当任务匹配某个 skill 时，使用 \`skill_view\` 加载对应 skill 并严格遵循其流程。
+`;
+
+  // 写入 HERMES.md（如果已存在则追加）
+  const hermesPath = resolve(projectDir, 'HERMES.md');
+  if (existsSync(hermesPath)) {
+    const existing = readFileSync(hermesPath, 'utf8');
+    if (!existing.includes('superpowers-zh')) {
+      writeFileSync(hermesPath, existing + '\n\n' + content, 'utf8');
+      console.log(`  ✅ Hermes Agent: 追加 skills 引用 -> ${hermesPath}`);
+    } else {
+      console.log(`  ✅ Hermes Agent: HERMES.md 已包含 superpowers-zh 引用`);
+    }
+  } else {
+    writeFileSync(hermesPath, content, 'utf8');
+    console.log(`  ✅ Hermes Agent: bootstrap -> ${hermesPath}`);
+  }
+}
+
 // 工具名称别名映射（用户输入 -> TARGETS.name）
 const TOOL_ALIASES = {
  'claude':       'Claude Code',
@@ -253,6 +310,8 @@ const TOOL_ALIASES = {
  'opencode':     'OpenCode',
  'qwen':         'Qwen Code',
  'qwen-code':    'Qwen Code',
+  'hermes':       'Hermes Agent',
+  'hermes-agent': 'Hermes Agent',
 };

 function showHelp() {
@@ -302,6 +361,10 @@ function installForTarget(target) {
    generateGeminiBootstrap(PROJECT_DIR);
  }

+  if (target.name === 'Hermes Agent') {
+    generateHermesBootstrap(PROJECT_DIR);
+  }
+
  if (target.name === 'Claude Code' && existsSync(AGENTS_SRC)) {
    const agentsDest = resolve(PROJECT_DIR, '.claude', 'agents');
    mkdirSync(agentsDest, { recursive: true });
--- a/package.json
+++ b/package.json
@@ -4,7 +4,7 @@
  "engines": {
    "node": ">=14.0.0"
  },
-  "description": "AI 编程超能力中文增强版 — superpowers（99k+ ⭐）完整汉化 + 6 个中国原创 skills，支持 Claude Code / Copilot CLI / Cursor / Windsurf / Kiro / Gemini CLI 等 15 款工具",
+  "description": "AI 编程超能力中文增强版 — superpowers（99k+ ⭐）完整汉化 + 6 个中国原创 skills，支持 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI 等 16 款工具",
  "type": "module",
  "main": ".opencode/plugins/superpowers.js",
  "bin": {
@@ -44,6 +44,8 @@
    "qwen",
    "vscode",
    "copilot",
+    "hermes",
+    "hermes-agent",
    "ai-coding",
    "skills",
    "chinese",
--- a/skills/using-superpowers/SKILL.md
+++ b/skills/using-superpowers/SKILL.md
@@ -31,13 +31,15 @@ Superpowers 技能覆盖默认系统提示行为，但**用户指令始终具有

 **在 Copilot CLI 中：** 使用 `skill` 工具。技能从已安装的插件中自动发现。`skill` 工具的工作方式与 Claude Code 的 `Skill` 工具相同。

+**在 Hermes Agent 中：** 使用 `skill_view` 工具加载技能。Hermes 支持三级渐进式加载：`skills_list` 浏览 → `skill_view(name)` 加载完整内容 → `skill_view(name, path)` 查看引用文件。
+
 **在 Gemini CLI 中：** 技能通过 `activate_skill` 工具激活。Gemini 在会话开始时加载技能元数据，并按需激活完整内容。

 **在其他环境中：** 查看你的平台文档了解技能的加载方式。

 ## 平台适配

-技能使用 Claude Code 的工具名称。非 CC 平台：查看 `references/copilot-tools.md`（Copilot CLI）、`references/codex-tools.md`（Codex）了解工具对应关系。Gemini CLI 用户通过 GEMINI.md 自动获得工具映射。
+技能使用 Claude Code 的工具名称。非 CC 平台：查看 `references/copilot-tools.md`（Copilot CLI）、`references/hermes-tools.md`（Hermes Agent）、`references/codex-tools.md`（Codex）了解工具对应关系。Gemini CLI 用户通过 GEMINI.md 自动获得工具映射。

 # 使用技能

--- a/skills/using-superpowers/references/hermes-tools.md
+++ b/skills/using-superpowers/references/hermes-tools.md
@@ -0,0 +1,44 @@
+# Hermes Agent 工具映射
+
+技能使用 Claude Code 的工具名称。当你在技能中遇到这些工具时，使用你平台的等价工具：
+
+| 技能中引用的工具 | Hermes Agent 等价工具 |
+|-----------------|----------------------|
+| `Read`（读取文件） | `read_file` |
+| `Write`（创建文件） | `write_file` |
+| `Edit`（编辑文件） | `patch` |
+| `Bash`（运行命令） | `terminal` |
+| `Grep`（搜索文件内容） | `search_files` |
+| `Glob`（按名称搜索文件） | `search_files` |
+| `Skill` 工具（调用技能） | `skill_view` |
+| `WebFetch` | `web_extract` |
+| `WebSearch` | `web_search` |
+| `Task` 工具（分派子智能体） | `delegate_task` |
+| 多个 `Task` 调用（并行） | 多个 `delegate_task` 调用 |
+| `TodoWrite`（任务跟踪） | `todo` |
+| `EnterPlanMode` / `ExitPlanMode` | 无等价工具 — 留在主会话中 |
+
+## 技能管理
+
+Hermes Agent 使用三级渐进式技能加载：
+
+| 操作 | 工具 |
+|------|------|
+| 列出所有可用技能 | `skills_list` |
+| 查看技能完整内容 | `skill_view(name)` |
+| 查看技能的引用文件 | `skill_view(name, path)` |
+| 管理技能（安装/更新） | `skill_manage` |
+
+## 额外的 Hermes Agent 工具
+
+| 工具 | 用途 |
+|------|---------|
+| `memory` | 持久化知识供未来会话使用 |
+| `session_search` | 搜索历史会话记录 |
+| `execute_code` | 在沙箱中执行代码 |
+| `process` | 后台进程管理 |
+| `vision_analyze` | 图像分析 |
+| `image_generate` | 图像生成 |
+| `clarify` | 向用户提出澄清性问题 |
+| `browser_*` | 浏览器自动化工具集 |
+| `mixture_of_agents` | 多智能体高级推理 |