SKILL.md 格式 · Skill Bundles · 条件激活 · GEPA 自进化 · Tap 发布 · agentskills.io 开放标准
已跑通 Hermes Agent 安装却仍在每次对话里重复粘贴 Prompt？2026 年初 Nous Research 发布的 Hermes 两个月内 GitHub Star 突破 16 万，核心卖点不是更大模型，而是 「the agent that grows with you」——底层正是可标准、可进化、跨会话持久的 Skills 技能系统。本文跳过入门，覆盖 SKILL.md 格式、Progressive Disclosure Token 控制、Skill Bundles、条件激活、Tap 发布、GEPA + DSPy 自进化 与社区生态，附概念对比表、六步 Runbook 与 FAQ。
与传统「一次性 Prompt」不同，Hermes 的 Skills 是一套遵循 agentskills.io 开放标准的程序性记忆：跨会话持久、按需加载、可发布为社区 Tap，且能在 Hermes、Claude Code、Cursor 之间移植。若你已安装 Hermes，可对照安装教程与三层记忆架构；本文专讲 Skills 层。
把 Prompt 当 Skill 用：每次会话全量注入，Token 随对话线性膨胀，无法跨 Session 复用程序性步骤。
混淆 Memory 与 Skill：Memory 存用户偏好与事实；Skill 存「如何做某事」的 SOP，加载时机与维护方式完全不同。
忽略 description 字段：Level 0 仅靠 name + description 路由，写「是什么」而非「什么时候用」导致误激活或永不加载。
单 Skill 堆全文：超过 500 行仍塞在 SKILL.md，GEPA 进化有 15KB 上限，且 Level 1 加载成本过高。
宿主不稳定：Skill 复利依赖 7×24 在线；笔记本合盖或 VPS 无 macOS 路径会中断 Skill 累积与 GEPA 轨迹收集。
Prompt = 便利贴；Memory = 便签本；Skill = SOP 手册——需要时翻阅，激活前零 Token 消耗。
| 维度 | 普通 Prompt | Memory（记忆） | Skills（技能） |
|---|---|---|---|
| 持久性 | 当前对话 | 跨会话，永久 | 跨会话，永久 |
| 加载时机 | 每次都在上下文中 | 每次会话自动注入 | 按需加载 |
| Token 成本 | 每次消耗 | 小而稳定 | 激活前零消耗 |
| 内容类型 | 任意意图描述 | 用户偏好/事实 | 程序性步骤 |
| 维护者 | 用户手动 | Agent 自动 | 用户 + Agent 均可 |
| 可共享性 | 不方便 | 私有 | 可发布为社区 Tap |
所有 Hermes Skills 遵循 agentskills.io 标准。frontmatter 必填 name（小写+连字符，≤64 字符）与 description（≤1024 字符，建议以「Use when...」开头）；推荐填写 version、license、compatibility、实验性 allowed-tools。正文须含 Overview、When to Use、Procedure、Common Pitfalls、Verification Checklist。
---
name: my-skill
description: |
Use when the user needs to [...].
Handles [...] and [...].
version: 1.0.0
license: MIT
compatibility: Requires git, docker
metadata:
hermes:
tags: [devops, automation]
requires_toolsets: [terminal]
fallback_for_toolsets: [web]
---
推荐目录结构：~/.hermes/skills/my-category/my-skill/ 下含 SKILL.md（核心步骤，建议 ≤500 行）、references/（API 文档按需加载）、templates/、scripts/（Agent 可直接执行）。
| 加载层级 | 内容 | 触发时机 | Token 成本 |
|---|---|---|---|
| Level 0 | name + description | 每次会话开始，所有技能 | 全部技能合计约 ~3K |
| Level 1 | 完整 SKILL.md 正文 | 用户 /skill-name 或 LLM 判断需要 | 取决于文件长度 |
| Level 2 | references/ scripts/ 文件 | LLM 执行时判断需要 | 按需，单文件 |
Bundle 是轻量 YAML（~/.hermes/skill-bundles/<slug>.yaml），执行 /bundle-name 时列出的技能同时加载。Bundle 与同名 Skill 冲突时 Bundle 优先；未安装的 Skill 跳过不报错；Bundle 不修改系统提示，Token 友好。
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.
CLI 快速创建：hermes bundles create backend-dev --skills github-code-review,test-driven-development,github-pr-workflow --instruction "Always write failing tests first"。进阶场景包括 AI 研究员 Bundle（arxiv + deep-research + plan + excalidraw）与 MLOps 部署 Bundle（vllm + llama-cpp + github-pr-workflow + systematic-debugging）。
在 metadata.hermes 下配置四种规则，让技能根据工具可用性自动显示或隐藏：
经典场景：DuckDuckGo 搜索 Skill 设置 fallback_for_tools: [web_search]——当用户配置了 FIRECRAWL_KEY / BRAVE_SEARCH_KEY 时付费 web_search 激活，DuckDuckGo 自动从提示词消失；API 不可用时备选浮现。平台感知示例：requires_toolsets: [messaging] + platforms: [telegram, discord]，TUI 可为 CLI/Telegram/Discord 独立开关。
创建目录：在 ~/.hermes/skills/<category>/<skill-name>/ 新建 SKILL.md，frontmatter 写清「Use when...」触发条件。
拆分 references：超过 500 行将 API 文档移入 references/；超过 15KB 必须拆分以满足 GEPA 护栏。
验证格式：运行 skills-ref validate ./my-skill 确保 agentskills.io 合规。
测试激活：新会话中 /my-skill 或描述匹配场景，确认 Level 1 加载与 Procedure 执行。
打包 Bundle（可选）：hermes bundles create <name> --skills a,b,c 将相关工作流一键触发。
发布 Tap：GitHub 仓库 + hermes skills tap add github:your-org/your-skills-tap，团队 tap update 同步。
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
| 仓库 | 描述 | 亮点 |
|---|---|---|
| ChuckSRQ/awesome-hermes-skills | 精选生产级技能合集 | Deep Research、MLOps、Apple 集成；23 技能集成 GitHub Copilot |
| amanning3390/hermeshub | 社区技能注册中心 | 安全扫描认证、API 与市场、提示注入检测 |
| kevinnft/ai-agent-skills | 191 个技能，28 分类 | 支持 Hermes/Claude Code/Cursor 一键安装 |
| NousResearch/hermes-agent | 官方主仓库 | 权威来源，含所有内置 Skills 与编写规范 |
Tap 仓库含分类目录（如 mlops/、research/），可选 skills.sh.json 控制 Hub 展示分组。私有仓库：hermes skills tap add github:your-org/private-skills --token $GH_TOKEN。建议将 ~/.hermes/skills/ 纳入 Git：cd ~/.hermes/skills && git init && git push，跨设备 git pull && hermes skills reset 同步后重建内置技能。
插件将技能打包为 plugin:skill 格式：不出现在默认 skills_list（减少噪声）、仅用户明确调用时激活（Opt-in）、插件内技能可相互引用。加载示例：skill_view("superpowers:writing-plans")，Agent 会自动展示同插件兄弟技能。插件开发者在 plugin.yaml 中声明 skills 路径即可。
跨平台复用：agentskills.io 标准意味着同一 SKILL.md 可在 Hermes、Claude Code、Cursor、OpenCode 使用；Claude Code 用户可复制到 ~/.claude/skills/ 或使用 kevinnft/ai-agent-skills 多端安装脚本。
GEPA（Genetic-Pareto Prompt Evolution） 是 2026 ICLR Oral 成果，集成于 hermes-agent-self-evolution。核心思路：分析执行轨迹 → 反思式失败分析 → 靶向生成 10–20 个 SKILL.md 变体 → 多目标帕累托评估（成功率 × Token 效率 × 速度）→ 最优变体生成 PR 人工审查。每次优化约 $2–10（纯 API，无需 GPU）。
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
四大安全护栏：① pytest 全量测试 100% 通过；② Skills ≤15KB、工具描述 ≤500 字符；③ 不破坏 Prompt Cache；④ 语义保留检查不偏离原始目的。官方五阶段路线图：Phase 1 Skill 文件（✅ 已实现）→ Phase 2 工具描述 → Phase 3 系统提示 → Phase 4 工具实现代码 → Phase 5 全自动持续改进。
agent_writes_require_approval: true 开启人工审批门构建博客写作辅助体系：blog-workflow Bundle 打包 seo-keyword-research、outline-generator、code-example-validator、bilingual-checker、publish-to-platform；instruction 要求先调研 SEO、测试代码示例、生成中英双语标题。seo-keyword-research Skill 的 description 明确「规划技术博客时使用」，Procedure 含中英长尾词矩阵输出与平台趋势交叉验证。
笔记本与 x86 VPS 能跑 Hermes CLI，却在 Skill 复利、GEPA 轨迹持续收集与 macOS 浏览器类 Skill 上受限；树莓派 I/O 瓶颈难扛长任务进化。对要把 Skills 当「越用越强」生产资产的团队，Mac Mini M4 月租 把 7×24 uptime、UMA 与 launchd 守护打包成可预期 OpEx——GEPA 需要稳定 sessiondb，Tap 同步需要可靠 Git 环境。
若你已完成 Skills 体系搭建并需要生产级常驻节点，VpsMesh 提供 Mac Mini M4 云端租赁：SSH 交付、可备份整个 ~/.hermes/ 目录。套餐见 Mac Mini M4 租赁价格，部署见 帮助中心，在线下单见 订购页。
Skills 是程序性知识文档（教 Agent 怎么做某事），MCP 是工具接口（给 Agent 额外的工具调用能力）。两者互补：MCP 提供数据库访问，Skill 教 Agent 如何正确执行数据库迁移。MCP 开发可参考本站MCP Server 从零开发教程。
Skill 修改在当前会话不生效，需要 /reset 开启新会话，或安装时加 --now 参数强制刷新（会导致 Prompt Cache 失效，消耗更多 Token）。
通过四大护栏：全量测试 100% 通过、Skills ≤15KB、Prompt Cache 兼容、语义保留检查；最优变体生成 PR 需人工审查 diff 后才上线。仍建议逐 PR review，防止语义漂移。
复制 SKILL.md 到 ~/.claude/skills/ 或 Cursor 的 skills 目录；或使用 kevinnft/ai-agent-skills 一键安装脚本。agentskills.io 标准确保跨 Agent 格式一致。Cursor Skills 入门见本站Cursor Agent Skills 指南。
纯 API + CLI 模式 x86 VPS 可用；需要 GEPA sessiondb 持续积累、macOS 浏览器 Skill 或 Tap Git 同步时，Mac Mini M4 月租 uptime 更稳。不确定可先租 1 个月，套餐见 价格页。