superpowers-zh 1.1.6 → 1.1.8

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 / Claw Code 等 17 款工具",
   "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 / Claw Code 等 17 款工具",
+      "version": "1.1.8",
       "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 / Claw Code 等 17 款工具",
+  "version": "1.1.8",
   "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 / Claw Code 等 17 款工具",
+  "version": "1.1.8",
   "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/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 等 **17 款 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 / Claw Code** |
 
 ---
 
@@ -53,12 +53,13 @@ AI：在开始实现之前，我需要了解几个关键问题：
 
 **superpowers-zh** 在完整翻译的基础上，新增了面向中国开发者的特色 skills。
 
-### 🤖 支持 14 款主流 AI 编程工具
+### 🤖 支持 17 款主流 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,8 +70,10 @@ 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/` |
+| [Claw Code](https://github.com/ultraworkers/claw-code) | CLI (Rust) | `npx superpowers-zh` | `.claw/skills/` |
 
 > 运行 `npx superpowers-zh` 会自动检测你项目中使用的工具，将 20 个 skills 安装到正确位置。
 
@@ -122,7 +125,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
@@ -136,6 +140,7 @@ cp -r superpowers-zh/skills /your/project/.gemini/skills     # Gemini CLI
 cp -r superpowers-zh/skills /your/project/.aider/skills      # Aider
 cp -r superpowers-zh/skills /your/project/.opencode/skills   # OpenCode
 cp -r superpowers-zh/skills /your/project/.qwen/skills       # Qwen Code
+cp -r superpowers-zh/skills /your/project/.claw/skills       # Claw Code（Rust 版）
 ```
 
 ### 方式三：在配置文件中引用
@@ -145,6 +150,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 +163,11 @@ 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 目录 |
+| Claw Code | `.claw/skills/*/SKILL.md` | Rust 版 CLI agent，兼容 Claude Code 的 SKILL.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)
+> **详细安装指南**：[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)
 
 ---
 
@@ -224,7 +233,7 @@ MIT License — 自由使用，商业或个人均可。
 
 <div align="center">
 
-**🦸 AI 编程超能力：让 OpenClaw / Claude Code / Cursor 等 14 款工具真正会干活**
+**🦸 AI 编程超能力：让 Claude Code / Hermes Agent / Cursor / Claw Code 等 17 款工具真正会干活**
 
 [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);
     }
   }
@@ -44,6 +55,8 @@ 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'] },
+  { name: 'Claw Code',     dir: '.claw/skills',              detect: ['.claw', 'CLAW.md'] },
 ];
 
 function countDirs(dir) {
@@ -230,11 +243,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 +322,11 @@ const TOOL_ALIASES = {
   'opencode':     'OpenCode',
   'qwen':         'Qwen Code',
   'qwen-code':    'Qwen Code',
+  'hermes':       'Hermes Agent',
+  'hermes-agent': 'Hermes Agent',
+  'claw':         'Claw Code',
+  'claw-code':    'Claw Code',
+  'clawcode':     'Claw Code',
 };
 
 function showHelp() {
@@ -279,9 +355,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 +386,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 });

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.6",
+  "version": "1.1.8",
   "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 / Claw Code / Windsurf / Kiro / Gemini CLI 等 17 款工具",
   "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,9 @@
     "qwen",
     "vscode",
     "copilot",
+    "hermes",
+    "hermes-agent",
+    "claw-code",
     "ai-coding",
     "skills",
     "chinese",

package/skills/chinese-git-workflow/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: chinese-git-workflow
-description: 适配国内 Git 平台和团队习惯的工作流规范——Gitee、Coding、极狐 GitLab 全覆盖
+description: 适配国内 Git 平台和团队习惯的工作流规范——Gitee、Coding、极狐 GitLab、CNB 全覆盖
 ---
 
 # 国内 Git 工作流规范
@@ -15,14 +15,14 @@ description: 适配国内 Git 平台和团队习惯的工作流规范——Gitee
 
 ### 平台对比
 
-| 特性 | Gitee | Coding.net | 极狐 GitLab | GitHub |
-|------|-------|------------|-------------|--------|
-| 国内访问 | 快 | 快 | 快 | 不稳定 |
-| 免费私有仓库 | 有 | 有 | 有 | 有 |
-| CI/CD | Gitee Go | Coding CI | 内置 GitLab CI | GitHub Actions |
-| 代码审查 | PR | MR | MR | PR |
-| 制品库 | 有限 | 完整 | 完整 | Packages |
-| 适合场景 | 开源/小团队 | 中大型团队 | 企业私有化 | 国际项目 |
+| 特性 | Gitee | Coding.net | 极狐 GitLab | CNB | GitHub |
+|------|-------|------------|-------------|-----|--------|
+| 国内访问 | 快 | 快 | 快 | 快 | 不稳定 |
+| 免费私有仓库 | 有 | 有 | 有 | 有 | 有 |
+| CI/CD | Gitee Go | Coding CI | 内置 GitLab CI | 内置（.cnb.yml） | GitHub Actions |
+| 代码审查 | PR | MR | MR | MR | PR |
+| 制品库 | 有限 | 完整 | 完整 | 完整 | Packages |
+| 适合场景 | 开源/小团队 | 中大型团队 | 企业私有化 | 云原生 / Docker 流水线 | 国际项目 |
 
 ### Gitee 特有配置
 
@@ -63,6 +63,17 @@ git remote add origin https://jihulab.com/<group>/<repo>.git
 git remote add origin https://gitlab.yourcompany.com/<group>/<repo>.git
 ```
 
+### CNB（Cloud Native Build）特有配置
+
+```bash
+# CNB 仓库地址（仅支持 HTTPS，不提供 SSH 协议）
+git remote add origin https://cnb.cool/<org>/<repo>.git
+
+# HTTPS 认证：用户名固定为 cnb，密码为个人访问令牌（Access Token）
+# 在 CNB 平台 → 个人设置 → 访问令牌 中生成
+git config credential.helper store
+```
+
 ## 工作流选择
 
 ### 方案一：主干开发（Trunk-Based Development）
@@ -372,16 +383,42 @@ variables:
   when: manual  # 生产环境手动触发
 ```
 
+### CNB（Cloud Native Build）
+
+```yaml
+# .cnb.yml — branch-first 结构，直接指定 Docker 镜像跑流水线
+main:
+  push:
+    - docker:
+        image: node:20
+      stages:
+        - npm ci
+        - npm test
+        - npm run build
+  pull_request:
+    - docker:
+        image: node:20
+      stages:
+        - npm run lint
+        - npm test
+```
+
+**特点：**
+- 每个流水线独立指定 Docker 镜像，天然云原生
+- 支持 `push` / `pull_request` 触发
+- 同一事件可并行多条流水线
+- `stages` 也支持 `- name: xxx` + `script:` 的展开形式，复杂场景见官方文档
+
 ### GitHub Actions 国内替代方案对照
 
-| GitHub Actions 功能 | Gitee Go | Coding CI | 极狐 GitLab CI |
-|---------------------|----------|-----------|----------------|
-| 触发条件 | triggers | Jenkinsfile triggers | only/rules |
-| 缓存依赖 | cache step | stash/unstash | cache |
-| 制品存储 | artifacts | 制品库 | artifacts |
-| 环境变量 | env | environment | variables |
-| 密钥管理 | 环境变量配置 | 凭据管理 | CI/CD Variables |
-| 手动触发 | 手动运行 | 手动触发 | when: manual |
+| GitHub Actions 功能 | Gitee Go | Coding CI | 极狐 GitLab CI | CNB |
+|---------------------|----------|-----------|----------------|-----|
+| 触发条件 | triggers | Jenkinsfile triggers | only/rules | push / pull_request |
+| 缓存依赖 | cache step | stash/unstash | cache | 见官方文档 |
+| 制品存储 | artifacts | 制品库 | artifacts | 见官方文档 |
+| 环境变量 | env | environment | variables | env |
+| 密钥管理 | 环境变量配置 | 凭据管理 | CI/CD Variables | Access Token |
+| 手动触发 | 手动运行 | 手动触发 | when: manual | 页面手动运行 |
 
 ## PR/MR 描述模板