From c86b269718b0e3e7675dab0710433732b9a54a35 Mon Sep 17 00:00:00 2001 From: jiangnan <1394485448@qq.com> Date: Mon, 13 Apr 2026 22:21:58 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20README=20=E6=96=B0=E5=A2=9E=20Copilot?= =?UTF-8?q?=20CLI=20/=20Hermes=20Agent=20=E6=94=AF=E6=8C=81=E8=AF=B4?= =?UTF-8?q?=E6=98=8E=EF=BC=8C=E5=B7=A5=E5=85=B7=E6=95=B0=E6=9B=B4=E6=96=B0?= =?UTF-8?q?=E4=B8=BA=2016?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 标题、工具表格、手动安装、配置文件、页脚等 9 处 14→16 - 工具表格新增 Copilot CLI 和 Hermes Agent 两行 - 新增 docs/README.hermes.md 详细安装指南 - 详细安装指南链接列表补充 Hermes Agent --- README.md | 22 ++++++---- docs/README.hermes.md | 96 +++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 110 insertions(+), 8 deletions(-) create mode 100644 docs/README.hermes.md diff --git a/README.md b/README.md index 5da717b..394cad1 100644 --- a/README.md +++ b/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. @@ -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) --- @@ -224,7 +230,7 @@ MIT License — 自由使用，商业或个人均可。
-**🦸 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) diff --git a/docs/README.hermes.md b/docs/README.hermes.md new file mode 100644 index 0000000..870cfa7 --- /dev/null +++ b/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/