superpowers-zh 1.1.5 → 1.1.7

package/.claude-plugin/marketplace.json

@@ -1,6 +1,6 @@
 {
   "name": "superpowers-zh",
-  "description": "AI 编程超能力中文增强版：20 个 skills，支持 OpenClaw / Claude Code / Cursor 等 14 款工具",
+  "description": "AI 编程超能力中文增强版：20 个 skills，支持 Claude Code / Hermes Agent / Cursor 等 16 款工具",
   "owner": {
     "name": "jnMetaCode",
     "url": "https://github.com/jnMetaCode"
@@ -8,8 +8,8 @@
   "plugins": [
     {
       "name": "superpowers-zh",
-      "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 6 中国原创），支持 OpenClaw / Claude Code / Cursor 等 14 款工具",
-      "version": "1.1.1",
+      "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 6 中国原创），支持 Claude Code / Hermes Agent / Cursor 等 16 款工具",
+      "version": "1.1.7",
       "source": "./",
       "author": {
         "name": "jnMetaCode",

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "superpowers-zh",
-  "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 6 中国原创），支持 OpenClaw / Claude Code / Cursor 等 14 款工具",
-  "version": "1.1.1",
+  "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 6 中国原创），支持 Claude Code / Hermes Agent / Cursor 等 16 款工具",
+  "version": "1.1.7",
   "author": {
     "name": "jnMetaCode",
     "url": "https://github.com/jnMetaCode"

package/.cursor-plugin/plugin.json

@@ -1,8 +1,8 @@
 {
   "name": "superpowers-zh",
   "displayName": "Superpowers 中文版",
-  "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 6 中国原创），支持 OpenClaw / Cursor / Claude Code 等 14 款工具",
-  "version": "1.1.1",
+  "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 6 中国原创），支持 Cursor / Claude Code / Hermes Agent 等 16 款工具",
+  "version": "1.1.7",
   "author": {
     "name": "jnMetaCode",
     "url": "https://github.com/jnMetaCode"

package/.opencode/plugins/superpowers.js

@@ -1,13 +1,12 @@
 /**
  * Superpowers plugin for OpenCode.ai
  *
- * Injects superpowers bootstrap context via system prompt transform.
+ * Injects superpowers bootstrap context via user message transform.
  * Auto-registers skills directory via config hook (no symlinks needed).
  */
 
 import path from 'path';
 import fs from 'fs';
-import os from 'os';
 import { fileURLToPath } from 'url';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
@@ -33,24 +32,8 @@ const extractAndStripFrontmatter = (content) => {
   return { frontmatter, content: body };
 };
 
-// Normalize a path: trim whitespace, expand ~, resolve to absolute
-const normalizePath = (p, homeDir) => {
-  if (!p || typeof p !== 'string') return null;
-  let normalized = p.trim();
-  if (!normalized) return null;
-  if (normalized.startsWith('~/')) {
-    normalized = path.join(homeDir, normalized.slice(2));
-  } else if (normalized === '~') {
-    normalized = homeDir;
-  }
-  return path.resolve(normalized);
-};
-
 export const SuperpowersPlugin = async ({ client, directory }) => {
-  const homeDir = os.homedir();
   const superpowersSkillsDir = path.resolve(__dirname, '../../skills');
-  const envConfigDir = normalizePath(process.env.OPENCODE_CONFIG_DIR, homeDir);
-  const configDir = envConfigDir || path.join(homeDir, '.config/opencode');
 
   // Helper to generate bootstrap content
   const getBootstrapContent = () => {
@@ -68,8 +51,6 @@ When skills reference tools you don't have, substitute OpenCode equivalents:
 - \`Skill\` tool → OpenCode's native \`skill\` tool
 - \`Read\`, \`Write\`, \`Edit\`, \`Bash\` → Your native tools
 
-**Skills location:**
-Superpowers skills are in \`${configDir}/skills/superpowers/\`
 Use OpenCode's native \`skill\` tool to list and load skills.`;
 
     return `<EXTREMELY_IMPORTANT>
@@ -96,12 +77,19 @@ ${toolMapping}
       }
     },
 
-    // Use system prompt transform to inject bootstrap (fixes #226 agent reset bug)
-    'experimental.chat.system.transform': async (_input, output) => {
+    // Inject bootstrap into the first user message of each session.
+    // Using a user message instead of a system message avoids:
+    //   1. Token bloat from system messages repeated every turn (#750)
+    //   2. Multiple system messages breaking Qwen and other models (#894)
+    'experimental.chat.messages.transform': async (_input, output) => {
       const bootstrap = getBootstrapContent();
-      if (bootstrap) {
-        (output.system ||= []).push(bootstrap);
-      }
+      if (!bootstrap || !output.messages.length) return;
+      const firstUser = output.messages.find(m => m.info.role === 'user');
+      if (!firstUser || !firstUser.parts.length) return;
+      // Only inject once
+      if (firstUser.parts.some(p => p.type === 'text' && p.text.includes('EXTREMELY_IMPORTANT'))) return;
+      const ref = firstUser.parts[0];
+      firstUser.parts.unshift({ ...ref, type: 'text', text: bootstrap });
     }
   };
 };

package/GEMINI.md

@@ -1,2 +1,43 @@
 @./skills/using-superpowers/SKILL.md
 @./skills/using-superpowers/references/gemini-tools.md
+
+
+# Superpowers-ZH 中文增强版
+
+本项目已安装 superpowers-zh 技能框架（20 个 skills）。
+
+## 核心规则
+
+1. **收到任务时，先检查是否有匹配的 skill** — 哪怕只有 1% 的可能性也要检查
+2. **设计先于编码** — 收到功能需求时，先用 brainstorming skill 做需求分析
+3. **测试先于实现** — 写代码前先写测试（TDD）
+4. **验证先于完成** — 声称完成前必须运行验证命令
+
+## 可用 Skills
+
+Skills 位于 `.gemini/skills/` 目录，每个 skill 有独立的 `SKILL.md` 文件。
+
+- **brainstorming**: 在任何创造性工作之前必须使用此技能——创建功能、构建组件、添加功能或修改行为。在实现之前先探索用户意图、需求和设计。
+- **chinese-code-review**: 中文代码审查规范——在保持专业严谨的同时，用符合国内团队文化的方式给出有效反馈
+- **chinese-commit-conventions**: 中文 Git 提交规范 — 适配国内团队的 commit message 规范和 changelog 自动化
+- **chinese-documentation**: 中文技术文档写作规范——排版、术语、结构一步到位，告别机翻味
+- **chinese-git-workflow**: 适配国内 Git 平台和团队习惯的工作流规范——Gitee、Coding、极狐 GitLab 全覆盖
+- **dispatching-parallel-agents**: 当面对 2 个以上可以独立进行、无共享状态或顺序依赖的任务时使用
+- **executing-plans**: 当你有一份书面实现计划需要在单独的会话中执行，并设有审查检查点时使用
+- **finishing-a-development-branch**: 当实现完成、所有测试通过、需要决定如何集成工作时使用——通过提供合并、PR 或清理等结构化选项来引导开发工作的收尾
+- **mcp-builder**: MCP 服务器构建方法论 — 系统化构建生产级 MCP 工具，让 AI 助手连接外部能力
+- **receiving-code-review**: 收到代码审查反馈后、实施建议之前使用，尤其当反馈不明确或技术上有疑问时——需要技术严谨性和验证，而非敷衍附和或盲目执行
+- **requesting-code-review**: 完成任务、实现重要功能或合并前使用，用于验证工作成果是否符合要求
+- **subagent-driven-development**: 当在当前会话中执行包含独立任务的实现计划时使用
+- **systematic-debugging**: 遇到任何 bug、测试失败或异常行为时使用，在提出修复方案之前执行
+- **test-driven-development**: 在实现任何功能或修复 bug 时使用，在编写实现代码之前
+- **using-git-worktrees**: 当需要开始与当前工作区隔离的功能开发或执行实现计划之前使用——创建具有智能目录选择和安全验证的隔离 git 工作树
+- **using-superpowers**: 在开始任何对话时使用——确立如何查找和使用技能，要求在任何响应（包括澄清性问题）之前调用 Skill 工具
+- **verification-before-completion**: 在宣称工作完成、已修复或测试通过之前使用，在提交或创建 PR 之前——必须运行验证命令并确认输出后才能声称成功；始终用证据支撑断言
+- **workflow-runner**: 在 Claude Code / OpenClaw / Cursor 中直接运行 agency-orchestrator YAML 工作流——无需 API key，使用当前会话的 LLM 作为执行引擎。当用户提供 .yaml 工作流文件或要求多角色协作完成任务时触发。
+- **writing-plans**: 当你有规格说明或需求用于多步骤任务时使用，在动手写代码之前
+- **writing-skills**: 当创建新技能、编辑现有技能或在部署前验证技能是否有效时使用
+
+## 如何使用
+
+当任务匹配某个 skill 时，读取对应的 `.gemini/skills/<skill-name>/SKILL.md` 并严格遵循其流程。

package/README.md

@@ -2,9 +2,9 @@
 
 🌐 **简体中文** | [English (upstream)](https://github.com/obra/superpowers)
 
-> 🦸 **superpowers（116k+ ⭐）完整汉化 + 6 个中国原创 skills** — 让 OpenClaw / Claude Code / Cursor / Windsurf / Kiro / Gemini CLI 等 **14 款 AI 编程工具**真正会干活。从头脑风暴到代码审查，从 TDD 到调试，每个 skill 都是经过实战验证的工作方法论。
+> 🦸 **superpowers（116k+ ⭐）完整汉化 + 6 个中国原创 skills** — 让 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI 等 **16 款 AI 编程工具**真正会干活。从头脑风暴到代码审查，从 TDD 到调试，每个 skill 都是经过实战验证的工作方法论。
 
-Chinese community edition of [superpowers](https://github.com/obra/superpowers) — 20 skills across 14 AI coding tools, including full translations and China-specific development skills.
+Chinese community edition of [superpowers](https://github.com/obra/superpowers) — 20 skills across 16 AI coding tools, including full translations and China-specific development skills.
 
 <!-- 效果对比 -->
 <table>
@@ -43,7 +43,7 @@ AI：在开始实现之前，我需要了解几个关键问题：
 
 | 📦 翻译 Skills | 🇨🇳 中国特色 Skills | 🤖 支持工具 |
 |:---:|:---:|:---:|
-| **14** | **6** | **OpenClaw / Claude Code / Cursor / Windsurf / Kiro / Gemini CLI / Codex / Aider / Trae / VS Code (Copilot) / DeerFlow / OpenCode / Qwen Code / Antigravity** |
+| **14** | **6** | **Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Codex / Aider / Trae / VS Code (Copilot) / DeerFlow / OpenCode / OpenClaw / Qwen Code / Antigravity** |
 
 ---
 
@@ -53,12 +53,13 @@ AI：在开始实现之前，我需要了解几个关键问题：
 
 **superpowers-zh** 在完整翻译的基础上，新增了面向中国开发者的特色 skills。
 
-### 🤖 支持 14 款主流 AI 编程工具
+### 🤖 支持 16 款主流 AI 编程工具
 
 | 工具 | 类型 | 一键安装 | 手动安装 |
 |------|------|:---:|:---:|
-| [OpenClaw](https://github.com/anthropics/openclaw) | CLI | `npx superpowers-zh` | `skills/` |
 | [Claude Code](https://claude.ai/code) | CLI | `npx superpowers-zh` | `.claude/skills/` |
+| [Copilot CLI](https://githubnext.com/projects/copilot-cli) | CLI | `npx superpowers-zh --tool copilot` | `.claude/skills/` |
+| [Hermes Agent](https://github.com/NousResearch/hermes-agent) | CLI | `npx superpowers-zh --tool hermes` | `.hermes/skills/` |
 | [Cursor](https://cursor.sh) | IDE | `npx superpowers-zh` | `.cursor/skills/` |
 | [Windsurf](https://codeium.com/windsurf) | IDE | `npx superpowers-zh` | `.windsurf/skills/` |
 | [Kiro](https://kiro.dev) | IDE | `npx superpowers-zh` | `.kiro/steering/` |
@@ -69,6 +70,7 @@ AI：在开始实现之前，我需要了解几个关键问题：
 | [VS Code](https://code.visualstudio.com) (Copilot) | IDE 插件 | `npx superpowers-zh` | `.github/superpowers/` |
 | [DeerFlow 2.0](https://github.com/bytedance/deer-flow) | Agent 框架 | `npx superpowers-zh` | `skills/custom/` |
 | [OpenCode](https://opencode.ai) | CLI | `npx superpowers-zh` | `.opencode/skills/` |
+| [OpenClaw](https://github.com/anthropics/openclaw) | CLI | `npx superpowers-zh` | `skills/` |
 | [Qwen Code](https://tongyi.aliyun.com/lingma) (通义灵码) | IDE 插件 | `npx superpowers-zh` | `.qwen/skills/` |
 | [Antigravity](https://github.com/anthropics/antigravity) | CLI | `npx superpowers-zh` | `.antigravity/skills/` |
 
@@ -122,7 +124,8 @@ npx superpowers-zh
 git clone https://github.com/jnMetaCode/superpowers-zh.git
 
 # 复制 skills 到你的项目（选择你使用的工具）
-cp -r superpowers-zh/skills /your/project/.claude/skills      # Claude Code
+cp -r superpowers-zh/skills /your/project/.claude/skills      # Claude Code / Copilot CLI
+cp -r superpowers-zh/skills /your/project/.hermes/skills      # Hermes Agent
 cp -r superpowers-zh/skills /your/project/.cursor/skills      # Cursor
 cp -r superpowers-zh/skills /your/project/.codex/skills       # Codex CLI
 cp -r superpowers-zh/skills /your/project/.kiro/steering      # Kiro
@@ -145,6 +148,8 @@ cp -r superpowers-zh/skills /your/project/.qwen/skills       # Qwen Code
 | 工具 | 配置文件 | 说明 |
 |------|---------|------|
 | Claude Code | `CLAUDE.md` | 项目根目录 |
+| Copilot CLI | `CLAUDE.md` | 与 Claude Code 共用插件格式 |
+| Hermes Agent | `HERMES.md` 或 `.hermes.md` | 项目根目录，安装时自动生成 |
 | Kiro | `.kiro/steering/*.md` | 支持 always/globs/手动三种模式 |
 | DeerFlow 2.0 | `skills/custom/*/SKILL.md` | 字节跳动开源 SuperAgent，自动发现自定义 skills |
 | Trae | `.trae/rules/project_rules.md` | 项目级规则 |
@@ -156,9 +161,10 @@ cp -r superpowers-zh/skills /your/project/.qwen/skills       # Qwen Code
 | Gemini CLI | `.gemini/skills/*/SKILL.md` | 项目级 skills 目录 |
 | Aider | `.aider/skills/*/SKILL.md` | 项目级 skills 目录 |
 | OpenCode | `.opencode/skills/*/SKILL.md` | 项目级 skills 目录 |
+| Hermes Agent | `.hermes/skills/*/SKILL.md` | 项目级 skills 目录 |
 | Qwen Code | `.qwen/skills/*/SKILL.md` | 项目级 skills 目录 |
 
-> **详细安装指南**：[Kiro](docs/README.kiro.md) · [DeerFlow](docs/README.deerflow.md) · [Trae](docs/README.trae.md) · [Antigravity](docs/README.antigravity.md) · [VS Code](docs/README.vscode.md) · [Codex](docs/README.codex.md) · [OpenCode](docs/README.opencode.md) · [OpenClaw](docs/README.openclaw.md) · [Windsurf](docs/README.windsurf.md) · [Gemini CLI](docs/README.gemini-cli.md) · [Aider](docs/README.aider.md) · [Qwen Code](docs/README.qwen.md)
+> **详细安装指南**：[Kiro](docs/README.kiro.md) · [DeerFlow](docs/README.deerflow.md) · [Trae](docs/README.trae.md) · [Antigravity](docs/README.antigravity.md) · [VS Code](docs/README.vscode.md) · [Codex](docs/README.codex.md) · [OpenCode](docs/README.opencode.md) · [OpenClaw](docs/README.openclaw.md) · [Windsurf](docs/README.windsurf.md) · [Gemini CLI](docs/README.gemini-cli.md) · [Aider](docs/README.aider.md) · [Qwen Code](docs/README.qwen.md) · [Hermes Agent](docs/README.hermes.md)
 
 ---
 
@@ -195,10 +201,12 @@ cp -r superpowers-zh/skills /your/project/.qwen/skills       # Qwen Code
 
 ## 交流 · Community
 
-微信公众号 **「AI不止语」**（微信搜索 `AI_BuZhiYu`）
-技术问答 · 项目更新 · 实战文章
+微信公众号 **「AI不止语」**（微信搜索 `AI_BuZhiYu`）— 技术问答 · 项目更新 · 实战文章
 
-微信群：关注公众号后回复「群」获取入群方式
+| 渠道 | 加入方式 |
+|------|---------|
+| QQ 群 | [点击加入](https://qm.qq.com/q/EeNQA9xCxy)（群号 1071280067） |
+| 微信群 | 关注公众号后回复「群」获取入群方式 |
 
 ---
 
@@ -222,7 +230,7 @@ MIT License — 自由使用，商业或个人均可。
 
 <div align="center">
 
-**🦸 AI 编程超能力：让 OpenClaw / Claude Code / Cursor 等 14 款工具真正会干活**
+**🦸 AI 编程超能力：让 Claude Code / Hermes Agent / Cursor 等 16 款工具真正会干活**
 
 [Star 本项目](https://github.com/jnMetaCode/superpowers-zh) · [提交 Issue](https://github.com/jnMetaCode/superpowers-zh/issues) · [贡献代码](https://github.com/jnMetaCode/superpowers-zh/pulls)
 

package/bin/superpowers-zh.js

@@ -1,23 +1,34 @@
 #!/usr/bin/env node
 
-import { existsSync, mkdirSync, cpSync, readdirSync, readFileSync, writeFileSync, copyFileSync, statSync } from 'fs';
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, copyFileSync, lstatSync, realpathSync } from 'fs';
 import { resolve, dirname, join } from 'path';
 import { fileURLToPath } from 'url';
 
-// Node 14/16 兼容：cpSync 在 Node 16.7+ 才可用
+// 手动递归复制：跨 Node 版本和操作系统行为一致
+// 不使用 cpSync —— 在 Windows + npx 缓存（含 junction）+ Node 16.7-18 下不稳定
 function copyDirSync(src, dest) {
-  if (typeof cpSync === 'function') {
-    cpSync(src, dest, { recursive: true });
-    return;
-  }
-  // 手动递归复制（兼容 Node 14+）
+  // 解析 junction/symlink，避免 Windows npx 缓存路径下 readdir 返回空
+  let realSrc = src;
+  try { realSrc = realpathSync(src); } catch {}
+
   mkdirSync(dest, { recursive: true });
-  for (const entry of readdirSync(src, { withFileTypes: true })) {
-    const srcPath = join(src, entry.name);
+  const entries = readdirSync(realSrc, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = join(realSrc, entry.name);
     const destPath = join(dest, entry.name);
-    if (entry.isDirectory()) {
+    let stat;
+    try { stat = lstatSync(srcPath); } catch { continue; }
+    if (stat.isSymbolicLink()) {
+      // 取消引用后按实际类型处理
+      try {
+        const real = realpathSync(srcPath);
+        const realStat = lstatSync(real);
+        if (realStat.isDirectory()) copyDirSync(real, destPath);
+        else copyFileSync(real, destPath);
+      } catch {}
+    } else if (stat.isDirectory()) {
       copyDirSync(srcPath, destPath);
-    } else {
+    } else if (stat.isFile()) {
       copyFileSync(srcPath, destPath);
     }
   }
@@ -31,7 +42,7 @@ const PROJECT_DIR = process.cwd();
 
 const TARGETS = [
   { name: 'Claude Code',   dir: '.claude/skills',           detect: '.claude' },
-  { name: 'Cursor',        dir: '.cursor/skills',           detect: '.cursor' },
+  { name: 'Cursor',        dir: '.cursor/skills',           detect: ['.cursor', '.cursorrules'] },
   { name: 'Codex CLI',     dir: '.codex/skills',            detect: '.codex' },
   { name: 'Kiro',          dir: '.kiro/steering',            detect: '.kiro' },
   { name: 'DeerFlow',      dir: 'skills/custom',             detect: 'deer_flow' },
@@ -44,6 +55,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) {
@@ -77,7 +89,7 @@ function generateTraeBootstrapRule(projectDir) {
   const rulesDir = resolve(projectDir, '.trae', 'rules');
   mkdirSync(rulesDir, { recursive: true });
 
-  const skillEntries = scanSkillEntries(resolve(projectDir, '.trae', 'skills'));
+  const skillEntries = scanSkillEntries(SKILLS_SRC);
   const skillTable = skillEntries.map(s => `| ${s.name} | ${s.desc} |`).join('\n');
 
   const rule = `---
@@ -114,7 +126,7 @@ ${skillTable}
 }
 
 function generateAntigravityBootstrap(projectDir) {
-  const skillEntries = scanSkillEntries(resolve(projectDir, '.antigravity', 'skills'));
+  const skillEntries = scanSkillEntries(SKILLS_SRC);
   const skillList = skillEntries.map(s => `- **${s.name}**: ${s.desc}`).join('\n');
 
   const content = `# Superpowers-ZH 中文增强版
@@ -146,7 +158,7 @@ ${skillList}
 }
 
 function generateAiderBootstrap(projectDir) {
-  const skillEntries = scanSkillEntries(resolve(projectDir, '.aider', 'skills'));
+  const skillEntries = scanSkillEntries(SKILLS_SRC);
   const skillList = skillEntries.map(s => `- **${s.name}**: ${s.desc}`).join('\n');
 
   const content = `# Superpowers-ZH 工作方法论
@@ -189,7 +201,7 @@ ${skillList}
 }
 
 function generateGeminiBootstrap(projectDir) {
-  const skillEntries = scanSkillEntries(resolve(projectDir, '.gemini', 'skills'));
+  const skillEntries = scanSkillEntries(SKILLS_SRC);
   const skillList = skillEntries.map(s => `- **${s.name}**: ${s.desc}`).join('\n');
 
   const content = `# Superpowers-ZH 中文增强版
@@ -230,11 +242,69 @@ ${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',
   'claude-code':  'Claude Code',
   'claudecode':   'Claude Code',
+  'copilot':      'Claude Code',
+  'copilot-cli':  'Claude Code',
   'cursor':       'Cursor',
   'codex':        'Codex CLI',
   'kiro':         'Kiro',
@@ -251,6 +321,8 @@ const TOOL_ALIASES = {
   'opencode':     'OpenCode',
   'qwen':         'Qwen Code',
   'qwen-code':    'Qwen Code',
+  'hermes':       'Hermes Agent',
+  'hermes-agent': 'Hermes Agent',
 };
 
 function showHelp() {
@@ -279,9 +351,19 @@ function showHelp() {
 
 function installForTarget(target) {
   const dest = resolve(PROJECT_DIR, target.dir);
+  const srcCount = countDirs(SKILLS_SRC);
   mkdirSync(dest, { recursive: true });
   copyDirSync(SKILLS_SRC, dest);
   const count = countDirs(dest);
+  if (srcCount > 0 && count === 0) {
+    throw new Error(
+      `复制 skills 失败：源目录 ${SKILLS_SRC} 有 ${srcCount} 个 skill，但目标 ${dest} 为空。` +
+      `\n  这通常是 npx 缓存目录权限或路径问题。请尝试：\n` +
+      `    1. 清理缓存后重试: npm cache clean --force && npx superpowers-zh\n` +
+      `    2. 或全局安装: npm i -g superpowers-zh && superpowers-zh\n` +
+      `    3. 或手动克隆复制: 见 https://github.com/jnMetaCode/superpowers-zh#方式二手动安装`
+    );
+  }
   console.log(`  ✅ ${target.name}: ${count} 个 skills -> ${dest}`);
 
   if (target.name === 'Trae') {
@@ -300,6 +382,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 });
@@ -335,8 +421,9 @@ function install(forceToolName) {
   let installed = 0;
 
   for (const target of TARGETS) {
-    const detectPath = resolve(PROJECT_DIR, target.detect);
-    if (existsSync(detectPath)) {
+    const detects = Array.isArray(target.detect) ? target.detect : [target.detect];
+    const found = detects.some(d => existsSync(resolve(PROJECT_DIR, d)));
+    if (found) {
       installForTarget(target);
       installed++;
     }

package/docs/README.hermes.md

@@ -0,0 +1,96 @@
+# Superpowers 中文版 — Hermes Agent 安装指南
+
+在 [Hermes Agent](https://github.com/NousResearch/hermes-agent) 中使用 superpowers-zh 的完整指南。
+
+## 自动安装
+
+```bash
+cd /your/project
+npx superpowers-zh --tool hermes
+```
+
+安装脚本会将 20 个 skills 复制到 `.hermes/skills/` 目录，并自动生成 `HERMES.md` 引导文件（含工具映射表和 skills 列表）。
+
+如果项目中已存在 `.hermes` 目录或 `HERMES.md` 文件，也会被自动检测到：
+
+```bash
+npx superpowers-zh   # 自动检测
+```
+
+## 手动安装
+
+```bash
+git clone https://github.com/jnMetaCode/superpowers-zh.git
+cp -r superpowers-zh/skills /your/project/.hermes/skills
+```
+
+## 通过 HERMES.md 引导
+
+Hermes Agent 在会话开始时自动加载项目根目录下的 `HERMES.md`（或 `.hermes.md`）作为上下文。安装器会自动生成此文件，内容包括：
+
+- 工具映射表（Claude Code → Hermes Agent 工具名称）
+- 所有可用 skills 的列表和描述
+- 核心规则和使用说明
+
+## 通过 config.yaml 配置外部 skills 目录
+
+如果希望全局使用 superpowers-zh skills，可以在 `~/.hermes/config.yaml` 中配置：
+
+```yaml
+skills:
+  external_dirs:
+    - /path/to/superpowers-zh/skills
+```
+
+## 工具映射
+
+Skills 中引用的 Claude Code 工具名称对应 Hermes Agent 的等价工具：
+
+| 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/using-superpowers/references/hermes-tools.md`。
+
+## 使用技能
+
+Hermes Agent 支持三级渐进式加载：
+
+```
+# 浏览所有可用技能
+skills_list
+
+# 加载某个技能的完整内容
+skill_view("brainstorming")
+
+# 查看技能的引用文件
+skill_view("using-superpowers", "references/hermes-tools.md")
+```
+
+## 故障排查
+
+### Skills 未发现
+
+1. 确认 `.hermes/skills/` 目录存在且包含 skill 文件夹
+2. 每个 skill 目录下需要有 `SKILL.md` 文件
+3. 使用 `skills_list` 查看已发现的技能
+
+### HERMES.md 未加载
+
+1. 确认文件在项目根目录（与 `.hermes/` 同级）
+2. 文件名可以是 `HERMES.md` 或 `.hermes.md`
+
+## 获取帮助
+
+- 提交 Issue：https://github.com/jnMetaCode/superpowers-zh/issues
+- 项目主页：https://github.com/jnMetaCode/superpowers-zh
+- Hermes Agent 文档：https://hermes-agent.nousresearch.com/docs/

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "superpowers-zh",
   "description": "AI 编程超能力中文版 — TDD、调试、代码审查等经过实战验证的工作方法论",
-  "version": "1.1.1",
+  "version": "1.1.6",
   "contextFileName": "GEMINI.md"
 }

package/hooks/session-start

@@ -35,23 +35,23 @@ warning_escaped=$(escape_for_json "$warning_message")
 session_context="<EXTREMELY_IMPORTANT>\nYou have superpowers.\n\n**Below is the full content of your 'superpowers:using-superpowers' skill - your introduction to using skills. For all other skills, use the 'Skill' tool:**\n\n${using_superpowers_escaped}\n\n${warning_escaped}\n</EXTREMELY_IMPORTANT>"
 
 # Output context injection as JSON.
-# Cursor hooks expect additional_context.
-# Claude Code hooks expect hookSpecificOutput.additionalContext.
-# Claude Code reads BOTH fields without deduplication, so we must only
-# emit the field consumed by the current platform to avoid double injection.
+# Cursor hooks expect additional_context (snake_case).
+# Claude Code hooks expect hookSpecificOutput.additionalContext (nested).
+# Copilot CLI (v1.0.11+) and others expect additionalContext (top-level, SDK standard).
+# Claude Code reads BOTH additional_context and hookSpecificOutput without
+# deduplication, so we must emit only the field the current platform consumes.
 #
-# Uses printf instead of heredoc (cat <<EOF) to work around a bash 5.3+
-# bug where heredoc variable expansion hangs when content exceeds ~512 bytes.
+# Uses printf instead of heredoc to work around bash 5.3+ heredoc hang.
 # See: https://github.com/obra/superpowers/issues/571
 if [ -n "${CURSOR_PLUGIN_ROOT:-}" ]; then
-  # Cursor sets CURSOR_PLUGIN_ROOT (may also set CLAUDE_PLUGIN_ROOT) — emit additional_context
+  # Cursor sets CURSOR_PLUGIN_ROOT (may also set CLAUDE_PLUGIN_ROOT)
   printf '{\n  "additional_context": "%s"\n}\n' "$session_context"
-elif [ -n "${CLAUDE_PLUGIN_ROOT:-}" ]; then
-  # Claude Code sets CLAUDE_PLUGIN_ROOT — emit only hookSpecificOutput
+elif [ -n "${CLAUDE_PLUGIN_ROOT:-}" ] && [ -z "${COPILOT_CLI:-}" ]; then
+  # Claude Code sets CLAUDE_PLUGIN_ROOT without COPILOT_CLI
   printf '{\n  "hookSpecificOutput": {\n    "hookEventName": "SessionStart",\n    "additionalContext": "%s"\n  }\n}\n' "$session_context"
 else
-  # Other platforms — emit additional_context as fallback
-  printf '{\n  "additional_context": "%s"\n}\n' "$session_context"
+  # Copilot CLI (sets COPILOT_CLI=1) or unknown platform — SDK standard format
+  printf '{\n  "additionalContext": "%s"\n}\n' "$session_context"
 fi
 
 exit 0

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "superpowers-zh",
-  "version": "1.1.5",
+  "version": "1.1.7",
   "engines": {
     "node": ">=14.0.0"
   },
-  "description": "AI 编程超能力中文增强版 — superpowers（99k+ ⭐）完整汉化 + 6 个中国原创 skills，支持 OpenClaw / Claude Code / Cursor / Windsurf / Kiro / Gemini CLI 等 14 款工具",
+  "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": {
@@ -18,8 +18,9 @@
     "hooks/",
     ".claude-plugin/",
     ".cursor-plugin/",
-    ".codex/",
-    ".opencode/",
+    ".codex/INSTALL.md",
+    ".opencode/INSTALL.md",
+    ".opencode/plugins/",
     "GEMINI.md",
     "gemini-extension.json",
     "docs/",
@@ -43,6 +44,8 @@
     "qwen",
     "vscode",
     "copilot",
+    "hermes",
+    "hermes-agent",
     "ai-coding",
     "skills",
     "chinese",

package/skills/using-superpowers/SKILL.md

@@ -29,13 +29,17 @@ Superpowers 技能覆盖默认系统提示行为，但**用户指令始终具有
 
 **在 Claude Code 中：** 使用 `Skill` 工具。当你调用一个技能时，其内容会被加载并呈现给你——直接遵循即可。绝不要用 Read 工具读取技能文件。
 
+**在 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/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 自动获得工具映射。
 
 # 使用技能
 

package/skills/using-superpowers/references/copilot-tools.md

@@ -0,0 +1,52 @@
+# Copilot CLI 工具映射
+
+技能使用 Claude Code 的工具名称。当你在技能中遇到这些工具时，使用你平台的等价工具：
+
+| 技能中引用的工具 | Copilot CLI 等价工具 |
+|-----------------|----------------------|
+| `Read`（读取文件） | `view` |
+| `Write`（创建文件） | `create` |
+| `Edit`（编辑文件） | `edit` |
+| `Bash`（运行命令） | `bash` |
+| `Grep`（搜索文件内容） | `grep` |
+| `Glob`（按名称搜索文件） | `glob` |
+| `Skill` 工具（调用技能） | `skill` |
+| `WebFetch` | `web_fetch` |
+| `Task` 工具（分派子智能体） | `task`（参见[智能体类型](#智能体类型)） |
+| 多个 `Task` 调用（并行） | 多个 `task` 调用 |
+| Task 状态/输出 | `read_agent`、`list_agents` |
+| `TodoWrite`（任务跟踪） | `sql` 配合内置 `todos` 表 |
+| `WebSearch` | 无等价工具 — 使用 `web_fetch` 配合搜索引擎 URL |
+| `EnterPlanMode` / `ExitPlanMode` | 无等价工具 — 留在主会话中 |
+
+## 智能体类型
+
+Copilot CLI 的 `task` 工具接受 `agent_type` 参数：
+
+| Claude Code 智能体 | Copilot CLI 等价 |
+|-------------------|----------------------|
+| `general-purpose` | `"general-purpose"` |
+| `Explore` | `"explore"` |
+| 命名的插件智能体（如 `superpowers:code-reviewer`） | 从已安装的插件中自动发现 |
+
+## 异步 Shell 会话
+
+Copilot CLI 支持持久化的异步 shell 会话，这在 Claude Code 中没有直接等价物：
+
+| 工具 | 用途 |
+|------|---------|
+| `bash` 配合 `async: true` | 在后台启动长时间运行的命令 |
+| `write_bash` | 向运行中的异步会话发送输入 |
+| `read_bash` | 读取异步会话的输出 |
+| `stop_bash` | 终止异步会话 |
+| `list_bash` | 列出所有活跃的 shell 会话 |
+
+## 额外的 Copilot CLI 工具
+
+| 工具 | 用途 |
+|------|---------|
+| `store_memory` | 持久化代码库相关事实供未来会话使用 |
+| `report_intent` | 更新 UI 状态行显示当前意图 |
+| `sql` | 查询会话的 SQLite 数据库（待办、元数据） |
+| `fetch_copilot_cli_documentation` | 查阅 Copilot CLI 文档 |
+| GitHub MCP 工具（`github-mcp-server-*`） | 原生 GitHub API 访问（issue、PR、代码搜索） |

package/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` | 多智能体高级推理 |