HermesGuide — Development skill for Claude Code

Hermes Agent 实战蓝皮书

[](./LICENSE) [](./docs/bluebook/index.md)

一本以**真实任务为主线**的 Hermes Agent 中文实战读本。

Hermes 最大的不同，是它**会自己长本事**：做完一件复杂的事，它能把过程沉淀成 Skill，下次直接调用，还会自我改善。 这本书不打算做功能说明书，只回答一个问题：**怎么把这件事真正交出去，而且做完是能验收的。**

本书由社区维护，**不是 Nous Research 官方出品**。命令与能力边界以你机器上 `hermes --help` 为准。

---

这本书适合谁

• 刚装好 Hermes、不确定第一件事该让它干什么的人；
• 想把它从 OpenClaw 迁过来的人（第 10 章专门讲迁移）；
• 已经会用，但一碰到「要连着做好几步」就翻车的人；
• 想让它在多台机器、多个沙箱里跑，或让多个 Subagent 并行干活的人；
• 想利用它的学习闭环，把重复操作真正沉淀下来的人。

不太适合：想查完整参数列表的人（请直接看 CLI 帮助）。

---

内容地图（39 章）

篇	内容	章数
第一篇 · 使用手册	安装五种方式、核心概念、接聊天工具、选模型（no lock-in）、Skill 与 Skills Hub、MCP、cron、安全边界、从 OpenClaw 迁移	10
第二篇 · 入门篇	整理目录、材料变文档、每日简报、手机接活、找文件、固化重复操作	6
第三篇 · 场景篇	开发者 / 运维与自托管 / 数据与自动化 / 研究写作 / 内容与日常，共 5 组场景	16
第四篇 · 进阶篇	写 Skill（含自我改善）、多 Subagent 编排（RPC）、7 种后端与沙箱、自动化可靠性（必读）、学习闭环与记忆治理	5
第五篇 · 岗位与行业落地	岗位路线图、团队落地的信任边界与验收标准	2

另有：

• 附录 A 常用指令模板——12 个可复制的指令模板，标注快照基准与来源章节
• 附录 B 场景速查表——按场景速查「能交给它 / 必须自己来 / 难度 / 对应章节」
• 课外阅读：一章看懂 Hermes 的执行系统——Gateway / Agent / Subagent / Skill / Backend / Memory 全景图
• 2 个社区案例（开发者 / 运维）

不知道从哪读起？看 [`docs/reading-guide.md`](./docs/reading-guide.md)，里面给了三条路线。

---

每章长什么样

固定六件套，翻到任何一章结构都一样：

1. 这个场景的痛点
2. 适合交给 Hermes Agent 的任务（以及不该交给它的）
3. 推荐流程（每步配图）
4. 提示词示例——六要素齐全，可直接复制
5. 进阶实战
6. 常见错误与修正方式（表格）

**提示词六要素**：目标 / 输入 / 动作 / 约束 / 输出 / 验收，末尾统一带一句红线：

在我确认前，不执行不可逆操作。

---

本地跑起来

需要 Node.js 20~24。

npm install
npm run dev        # 本地预览 http://127.0.0.1:5173
npm run build      # 构建，产出 docs/.vitepress/dist

技术栈是 **VitePress**：SEO 友好、中文全文搜索、Markdown 写作、侧边栏自动扫描（加一章不用改代码）。

提示：站内图示请放到 `./assets/*.svg` 再引用。不要在 Markdown 里内联多行 ``， VitePress/Vue 编译会报「Element is missing end tag」。

---

目录结构

HermesGuide/
├─ docs/
│  ├─ .vitepress/
│  │  ├─ book.config.mts      # 改书名/产品名/域名/仓库，只动这里
│  │  ├─ config.