2026 Hermes Agent Skills 进阶全攻略：
SKILL.md、Bundles 与 GEPA 自我进化

与传统「每次对话粘贴长 Prompt」相比，Hermes Skills 解决的是程序性知识如何持久、按需、可共享的问题。进阶使用者常遇到这些痛点：

• Token 被占满：把整本运维手册塞进系统提示，挤占真正写代码的上下文。
• 跨会话无法复用：关闭对话后，部署 checklist、PR 流程不会自动继承。
• 团队对齐难：每人本地一份提示词变体，评审与版本管理成本高。
• 工具环境不一致：有付费 web_search 时仍显示免费备选 Skill，浪费 Token 或误导 Agent。
• 技能质量停滞：写了 SKILL.md 却从不根据失败轨迹迭代，Agent 重复犯同样错误。

核心记忆口诀：Prompt = 便利贴（当次有效）；Memory = 便签本（永久笔记，随时在手边）；Skill = SOP 手册（步骤化流程，需要时翻阅）。

与 MCP 的关系：Skills 是程序性知识文档（教 Agent 怎么做某事），MCP 是工具接口（给 Agent 额外工具调用能力）。二者互补：可有 MCP 提供数据库访问，再用 Skill 教 Agent 如何正确执行迁移。

所有 Hermes Skills 遵循 agentskills.io 开放标准，可在 Hermes、Claude Code、Cursor、OpenCode 间跨平台移植。标准目录结构如下：

├── SKILL.md              # 主文件，建议 ≤500 行
├── references/
│   ├── api-docs.md       # 按需加载
│   └── examples.md
├── templates/
│   └── config.yaml
└── scripts/
    └── setup.sh          # Agent 可直接执行

Progressive Disclosure（渐进披露）是 Token 控制的核心——三级加载机制：

写作建议：description 是 Level 0 的全部信息，LLM 靠它决定是否加载完整技能。写清「什么时候用」比「是什么」更重要，建议以 Use when... 开头。

---
name: my-skill
description: |
  Use when the user needs to [...].
  Handles [...] and [...].
version: 1.0.0
license: MIT
compatibility: Requires git, docker
allowed-tools: Bash(git:*) Read
metadata:
  hermes:
    tags: [devops, automation]
    category: software-development
    related_skills: [github-pr-workflow]
    requires_toolsets: [terminal]
    fallback_for_toolsets: [web]
---

# My Skill Title

## Overview
1-2 段：做什么、为何存在

## When to Use
Use for / Don't use for

## Procedure
1. 步骤一（含精确命令）

## Common Pitfalls
失败模式 + 根因 + 修复

## Verification Checklist
- [ ] 验证点

技能大小控制建议：<500 行全部放 SKILL.md；500–1000 行将详细资料移至 references/；>1000 行强烈建议拆分；>15KB 超过 GEPA 进化限制，必须拆分。

Skill Bundles 是 Hermes 2026 新增特性：轻量 YAML 把多个相关技能打包成一个斜杠命令，执行 /bundle-name 时所有列出的技能同时加载。文件位置：~/.hermes/skill-bundles/<slug>.yaml。

name: backend-dev
description: |
  Full backend feature workflow — code review, TDD, and PR management.
skills:
  - github-code-review
  - test-driven-development
  - github-pr-workflow
instruction: |
  Always write failing tests first before implementation.
  Never push directly to main.

Bundle 优先级规则：Bundle 与单个 Skill 同名时 Bundle 优先；列出的 Skill 未安装时跳过而不报错并提示缺失；Bundle 不修改系统提示，不会导致 Prompt Cache 失效。

CLI 快速创建：

hermes bundles create backend-dev \
  --skills github-code-review,test-driven-development,github-pr-workflow \
  --instruction "Always write failing tests first"

条件激活（Conditional Activation）让技能根据当前工具可用性自动显示或隐藏。在 metadata.hermes 下配置四种规则：

经典场景：配置 FIRECRAWL_KEY / BRAVE_SEARCH_KEY 后付费 web_search 激活，DuckDuckGo 技能通过 fallback_for_tools: [web_search] 自动隐藏，节省 Token；API 不可用时备选自动浮现。平台感知技能可用 requires_toolsets: [messaging] 与 platforms: [telegram, discord] 限定消息平台。

官方安装渠道（发版后请核对官方文档）：

hermes skills install official/research/arxiv
hermes skills install https://example.com/SKILL.md --name my-skill
hermes skills install github:openai/skills/k8s
hermes skills tap add github:my-org/my-skills
hermes skills tap update
hermes skills tap list

发布 Skill Tap：创建 GitHub 仓库作为 Tap，团队一键订阅。典型结构含 skills.sh.json 控制 Hub 分类展示：

{
  "groupings": [
    {
      "title": "MLOps & Model Deployment",
      "skills": ["vllm-deploy", "model-benchmark"]
  }]
}

团队部署：

hermes skills tap add github:your-org/your-skills-tap
hermes skills tap add github:your-org/private-skills --token $GH_TOKEN
cd ~/.hermes/skills && git init && git push -u origin main
git pull && hermes skills reset

行为与命令以 Nous Research 官方文档为准；发版后请再次打开下列链接核对。

Skills System | Hermes Agent

agentskills.io Specification

NousResearch/hermes-agent on GitHub

GEPA（Genetic-Pareto Prompt Evolution）是 2026 年 ICLR Oral 成果，集成于 hermes-agent-self-evolution。核心思路：不微调模型权重，通过分析执行轨迹、生成变体、多目标帕累托优化来改进 SKILL.md 文本本身。每次优化运行约 $2–10（纯 API 调用，无需 GPU）。

五阶段进化流程：

1. 执行轨迹收集：从 SQLite 读取全量推理轨迹（工具调用、分支、错误）。
2. 反思式失败分析：LLM 生成可操作侧信息——不是「失败了」，而是「为什么失败」。
3. 靶向变异：针对失败原因，生成 10–20 个 SKILL.md 变体。
4. 多目标帕累托评估：同时优化成功率 × Token 效率 × 速度。
5. 人工审查 PR：最优变体生成 PR，人工批准后上线。

git clone https://github.com/NousResearch/hermes-agent-self-evolution
cd hermes-agent-self-evolution && pip install -r requirements.txt
export HERMES_AGENT_PATH=~/.hermes

python -m evolution.skills.evolve_skill \
    --skill github-code-review \
    --iterations 10 \
    --eval-source synthetic

python -m evolution.skills.evolve_skill \
    --skill github-code-review \
    --iterations 10 \
    --eval-source sessiondb

python -m evolution.skills.evolve_skill \
    --skill github-code-review \
    --iterations 10 \
    --eval-source mixed \
    --trace-dirs ~/.claude/traces,~/.hermes/sessions

四大安全护栏（变体须全部通过才生成 PR）：

• 全量测试套件：pytest tests/ -q 必须 100% 通过。
• 大小限制：Skills ≤ 15KB，工具描述 ≤ 500 字符。
• Prompt 缓存兼容性：不能在会话中途修改导致缓存失效。
• 语义保留检查：不能偏离技能原始核心目的。

官方五阶段进化路线图：Phase 1 Skill 文件（DSPy+GEPA）✅ 已实现；Phase 2 工具描述、Phase 3 系统提示、Phase 4 工具实现代码、Phase 5 全自动持续改进循环均为计划中。

Plugin 技能以命名空间 plugin:skill 加载，不出现在默认 skills_list，仅用户明确调用时激活，插件内技能可相互引用。在 plugin.yaml 中声明：

name: my-hermes-plugin
skills:
  - name: writing-plans
    path: skills/writing-plans/SKILL.md
  - name: editing
    path: skills/editing/SKILL.md

进阶编写要点：

• description 决定激活精度：避免「Helps with code」这类模糊描述；明确触发条件与排除场景。
• Pitfalls 是质量分水岭：写具体失败模式、根因分析与可操作修复，而非泛泛而谈。
• 脚本化：在 Procedure 中写明 Agent 将执行的 scripts/ 命令，失败时加载 references/ 手动回退。
• skill_manage 自我维护：Agent 可通过 skill_manage(action='patch'| 'create') 动态维护技能；在 config.yaml 设 agent_writes_require_approval: true 开启人工审批门。

博客工作流实战案例——blog-workflow Bundle 示例：

name: blog-workflow
description: Full tech blog writing workflow.
skills:
  - seo-keyword-research
  - outline-generator
  - code-example-validator
  - bilingual-checker
  - publish-to-platform
instruction: |
  Always research SEO keywords before writing.
  Ensure all code examples are tested and runnable.

Q：Skill 改了但 Agent 还在用旧版？
修改在当前会话不生效，需 /reset 开新会话，或安装时加 --now 强制刷新（会导致 Prompt Cache 失效，消耗更多 Token）。

Q：GEPA 进化出的技能安全吗？
四大护栏 + 人工 PR 审查 + 语义漂移检测；仍建议人工 review 每个 diff。

Q：如何在 Claude Code 中复用 Hermes Skills？
复制 SKILL.md 到 ~/.claude/skills/，或使用 kevinnft/ai-agent-skills 一键多端安装。

Q：Skill 中文内容影响 Token 效率吗？
中文字符约 1–1.5 token/字，与英文相近；但 description 建议保留英文或中英双语，底层 LLM 对英文 description 匹配更精确。

延伸阅读（发版后请核对链接）：

Hermes Agent 中文文档

Creating Skills 开发者指南

hermes-agent-self-evolution

gepa-ai/gepa

1. 验收 Hermes 基线：确认 hermes doctor 通过，~/.hermes/skills/ 目录可写且已纳入备份策略。
2. 安装官方技能 Tap：执行 hermes skills tap add 订阅团队或社区仓库，hermes skills tap update 保持同步。
3. 编写首个 SKILL.md：按 agentskills.io 标准写 frontmatter + Procedure + Pitfalls + Verification，description 以 Use when 开头。
4. 创建 Bundle 工作流：在 ~/.hermes/skill-bundles/ 写 YAML，用 /bundle-name 验证多技能同时加载。
5. 配置条件激活：为免费/付费工具对编写 fallback_for_tools，减少 Token 噪声。
6. 可选 GEPA 进化：克隆 self-evolution 仓库，用 synthetic 或 sessiondb 跑 evolve_skill，人工审查 PR 后合并。

• Progressive Disclosure Level 0 合计：全部技能 name+description 约 3K Token（Nous 文档口径）。
• GEPA 单次优化成本：约 $2–10 API 调用，无需 GPU（hermes-agent-self-evolution README）。
• Skill 大小上限（GEPA 护栏）：≤15KB，工具描述 ≤500 字符。
• agentskills.io：跨 Hermes / Claude Code / Cursor / OpenCode 通用，可用 skills-ref validate 校验格式。

在 MacBook 上试玩 Skills 可以，但 Gateway、定时任务与 GEPA 轨迹积累需要合盖不断、系统更新可控的宿主。树莓派 IO 与浏览器自动化易超时；x86 Linux VPS 缺 macOS 专属工具链；本地合盖睡眠会导致跨会话 Skill 复利中断。

对于需要 7×24 常驻 Hermes Agent、稳定积累 Skill 轨迹、跑 iOS CI/CD 与 AI Agent 自动化 的生产环境，CALMVPS 的 Mac Mini 裸金属租赁通常是更优解：独占 Apple Silicon、launchd 常驻、~/.hermes/ 可 SSH 备份同步，按月弹性下单，约 120 秒交付。详见 定价页。