Hermes Agent Skills 进阶全攻略： 从 SKILL.md 到 GEPA 自我进化

入门教程解决「怎么装」，进阶要解决「怎么让 Agent 越用越强」。Hermes Skills 的独特价值在于四点：

• 按需加载：激活前零 Token 消耗，靠 Progressive Disclosure 控制成本。
• 开放标准：遵循 agentskills.io，Hermes、Claude Code、Cursor 可跨平台复用。
• 可组合：Skill Bundles 一条斜杠命令加载整套工作流。
• 可进化：GEPA 算法分析执行轨迹，自动改进 SKILL.md 文本，无需动模型权重。

进阶用户常见的四个痛点：

• Token 膨胀：把所有 SOP 塞进系统提示，每次会话白白烧掉数千 Token。
• 技能误激活：description 写得太模糊，LLM 在无关场景加载错误技能。
• 工作流碎片化：PR 审查、TDD、部署要逐个 /skill-name，效率低。
• 团队无法共享：技能散落在个人目录，换机器或新同事 onboarding 成本高。

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

Skills 与 MCP 互补：MCP 提供工具接口（如数据库访问），Skill 教 Agent如何正确使用该工具完成迁移等任务。

所有 Hermes Skills 遵循 agentskills.io 开放标准。基础 frontmatter 结构如下：

---
name: my-skill
description: |
  Use when the user needs to [...].
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 / When to Use / Procedure / Common Pitfalls / Verification Checklist

推荐目录结构：

my-category/my-skill/
├── SKILL.md              # 核心步骤，建议 ≤500 行
├── references/           # API 参考，按需加载
├── templates/            # 可复用模板
└── scripts/              # Agent 可直接执行的脚本

写作要点：description 是 Level 0 的全部信息，写清「什么时候用」比「是什么」更重要；SKILL.md 建议含 Overview、When to Use、Procedure、Common Pitfalls、Verification Checklist 五段。可用 skills-ref validate ./my-skill 验证格式合规。

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.

进阶场景：研究员工工作流可打包 arxiv、deep-research、plan、excalidraw；MLOps 部署可打包 vllm、llama-cpp、github-pr-workflow、systematic-debugging。

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

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

在 metadata.hermes 下配置四种激活规则，技能可根据工具可用性自动显示或隐藏：

经典场景：DuckDuckGo 搜索技能设置 fallback_for_tools: [web_search]——当用户配置了 FIRECRAWL_KEY / BRAVE_SEARCH_KEY 时付费 web_search 激活，DuckDuckGo 自动隐藏省 Token；API 不可用时备选自动浮现。

平台感知：telegram-notify 可设 requires_toolsets: [messaging] 与 platforms: [telegram, discord]；通过 hermes skills TUI 可为 CLI、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

agentskills.io 意味着技能可在 Hermes、Claude Code、Cursor、OpenCode 间跨平台使用，资产不绑定单一平台。

通过 GitHub 仓库作为 Tap，团队或社区可订阅你的技能集。推荐仓库结构：

my-skills-tap/
├── skills.sh.json          # 分类配置（可选）
├── mlops/vllm-deploy/SKILL.md
├── research/paper-summarizer/SKILL.md
└── README.md

1. 规划分类：按 MLOps、Research 等域组织目录，编写 skills.sh.json 控制 Hub 展示分组。
2. 编写 SKILL.md：每个技能独立目录，通过 skills-ref validate 校验。
3. 推送 GitHub 仓库：公开或私有（私有需 Token）。
4. 团队成员订阅：hermes skills tap add github:your-org/your-skills-tap。
5. 定期更新：hermes skills tap update 拉取最新技能。
6. 版本管理：将 ~/.hermes/skills/ 纳入 Git，跨设备 git pull && hermes skills reset 同步。

hermes skills tap add github:your-org/private-skills --token $GH_TOKEN
hermes skills tap list
hermes skills tap update

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

五阶段进化流程：① 执行轨迹收集（SQLite）；② 反思式失败分析（可操作侧信息）；③ 靶向变异（10–20 个 SKILL.md 变体）；④ 多目标帕累托评估（成功率 × Token 效率 × 速度）；⑤ 人工审查 PR 后上线。

export HERMES_AGENT_PATH=~/.hermes
python -m evolution.skills.evolve_skill \
    --skill github-code-review \
    --iterations 10 \
    --eval-source sessiondb

四大安全护栏：全量测试套件 100% 通过；Skills ≤ 15KB、工具描述 ≤ 500 字符；Prompt 缓存兼容；语义保留检查不偏离原始目的。

Skills 遵循 agentskills.io，可将 Claude Code 或 Gemini CLI 轨迹喂给优化器：--eval-source mixed --trace-dirs ~/.claude/traces,~/.hermes/sessions。

插件将技能打包为命名空间 plugin:skill：不出现在默认 skills_list、仅用户明确调用时激活、插件内技能可相互引用。加载 skill_view("superpowers:writing-plans") 时会展示同插件兄弟技能。

description 决定激活精度：避免「Helps with code」这类模糊写法；应写清触发条件与排除场景。

Pitfalls 是质量分水岭：须含具体失败模式、根因与修复步骤（如 CSS selector 脆弱性、GitHub API 限流、大 diff Token 溢出）。

脚本化：在 Procedure 中引用 scripts/ 下可执行脚本，失败时 fallback 到 references/manual-extract.md。

Agent 可通过 skill_manage 动态 patch 或 create 技能；在 config.yaml 设 skills.agent_writes_require_approval: true 开启人工审批门。

构建 blog-workflow Bundle，一键加载 SEO 调研、大纲生成、代码校验、双语检查、发布技能：

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.
  Generate both Chinese and English title options.

自定义 seo-keyword-research 技能应设 requires_toolsets: [web]，流程含：识别主题 → 中文长尾（「X 怎么用」「X 教程」）→ 英文长尾（「X tutorial」「X vs Y」）→ 交叉参考掘金/Dev.to/HN 热榜 → 输出 3–5 主词 + 10–15 长尾矩阵。注意中英文受众搜索习惯不同，技术术语译法需按目标平台校验。

• Skills 和 MCP 有什么区别？ Skills 是程序性知识文档，MCP 是工具接口；两者互补。
• 改了 Skill 为何还用旧版？ 当前会话不生效，需 /reset 新会话，或安装加 --now（会导致 Prompt Cache 失效）。
• GEPA 进化安全吗？ 四大护栏 + 人工 PR 审查；仍建议 review 每个 diff。
• Claude Code 如何复用？ 复制 SKILL.md 到 ~/.claude/skills/，或用 ai-agent-skills 一键多端安装。
• 中文内容影响 Token？ 中文每字约 1–1.5 token；description 建议保留英文或中英双语，LLM 匹配更精确。

延伸阅读：官方文档、中文文档、GEPA 算法、DSPy 框架。

• GitHub Star：Hermes Agent 2026 年初发布，两个月内突破 16 万 Star。
• Level 0 Token：全部技能 name+description 合计约 3K Token/会话。
• GEPA 单次成本：约 $2–10，纯 API 调用，无需 GPU。
• GEPA 大小限制：Skills ≤ 15KB，工具描述 ≤ 500 字符。
• 社区规模：kevinnft/ai-agent-skills 含 191 个技能、28 分类；hermeshub 166 Star 含安全扫描。

跑 Hermes Agent 与 GEPA 进化流水线，需要 7×24 在线、低延迟的 macOS 宿主。树莓派内存不足、共享 VPS 超卖导致长连接中断、家用宽带抖动——这些都会让 Skills 进化轨迹收集与 Gateway 常驻打折扣。

对于需要稳定运行 Hermes Gateway、持续收集 sessiondb 轨迹并执行 GEPA 迭代的生产环境，JEXCLOUD 多区域裸金属 Mac 是更优解：独占 Apple Silicon、7×24 在线、按月弹性扩缩，120 秒交付节点。具体配置与价格见 JEXCLOUD 定价页。