skill_manage 自维护与博客实战 Bundle，附对比表、六步落地与 KVMNODE 云 Mac 宿主建议。可与 安装部署文、三层记忆架构 交叉阅读。2026 年 Hermes Agent Skills 为何值得单独深挖？与 Prompt、Memory 的本质区别
2026 年初 Hermes Agent 两个月内 GitHub Star 突破 16 万，核心哲学是 "the agent that grows with you"——Agent 随使用越来越懂你。底层实现正是 Skills 技能系统：与传统一次性 Prompt 不同，Skills 是有标准、可进化、跨会话持久的程序性记忆，遵循 agentskills.io 开放标准，可在 Hermes、Claude Code、Cursor 间移植。
| 维度 | 普通 Prompt | Memory（记忆） | Skills（技能） |
|---|---|---|---|
| 持久性 | 当前对话 | 跨会话永久 | 跨会话永久 |
| 加载时机 | 每次在上下文中 | 每会话自动注入 | 按需加载 |
| Token 成本 | 每次消耗 | 小而稳定 | 激活前零消耗 |
| 内容类型 | 任意意图 | 用户偏好/事实 | 程序性步骤 |
| 可共享性 | 不便 | 私有 | 可发布为社区 Tap |
记忆口诀：Prompt = 便利贴（当次有效）· Memory = 便签本（永久笔记）· Skill = SOP 手册（需要时翻阅）。
把 Skill 当 Prompt 堆：每次会话全量注入，Token 爆炸且无法 progressive disclosure。
description 写得太泛：LLM 在不相关场景误加载，见第十章反例。
忽略条件激活：免费/付费搜索工具并存，两套 Skill 同时占 Level 0 槽位。
Skill 越积越大：单文件超 15KB 无法通过 GEPA 护栏，必须拆到 references/。
笔记本当宿主：改完 Skill 未 /reset、Gateway 休眠，团队 Tap 更新不同步。
SKILL.md 格式深度解析：agentskills.io 标准与 Progressive Disclosure 三级加载
所有 Hermes Skills 遵循 agentskills.io 规范。frontmatter 必填 name（小写+连字符，≤64 字符）与 description（≤1024 字符，建议以 "Use when..." 开头）；推荐填写 version、license、compatibility、实验性 allowed-tools。
---
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]
---
# My Skill Title
## Overview / When to Use / Procedure / Common Pitfalls / Verification Checklist
模块化目录结构（~/.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 判断需要 | 按需单文件 |
写作关键：description 是 Level 0 的全部信息，写清「什么时候用」比「是什么」更重要。可用 skills-ref validate ./my-skill 验证格式合规。
大小控制：<500 行全放 SKILL.md；500–1000 行移详细资料到 references/；>1000 行强烈建议拆分或拆成两个技能；>15KB 超过 GEPA 进化限制必须拆分。
Skill Bundles 与条件激活：一条命令触发完整工作流
Skill Bundles（~/.hermes/skill-bundles/<slug>.yaml）是 Hermes 2026 新增特性：执行 /bundle-name 时列出的技能同时加载，无需逐个触发。Bundle 与同名 Skill 时Bundle 优先；未安装 Skill 跳过不报错；不修改系统提示，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 --instruction "Always write failing tests first"。研究员场景可打包 arxiv、deep-research、plan、excalidraw；MLOps 可打包 vllm、llama-cpp、systematic-debugging。
条件激活（Conditional Activation）让技能根据工具可用性自动显示或隐藏，在 metadata.hermes 配置：
| 字段 | 行为逻辑 |
|---|---|
requires_toolsets | 列出的工具集不存在时隐藏 |
requires_tools | 列出的工具不存在时隐藏 |
fallback_for_toolsets | 列出的工具集存在时隐藏（备选方案） |
fallback_for_tools | 列出的工具存在时隐藏 |
经典场景：duckduckgo-search 设置 fallback_for_tools: [web_search]——有付费 web_search（FIRECRAWL_KEY / BRAVE_SEARCH_KEY）时自动隐藏 DuckDuckGo，节省 Token；API 不可用时备选浮现。平台感知可用 requires_toolsets: [messaging] 与 platforms: [telegram, discord]，hermes skills TUI 可为 CLI/Telegram/Discord 独立开关技能。
Skills Hub 生态、Tap 发布与 Plugin 技能：从安装到团队共享
官方安装渠道：
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、23 技能集成 GitHub Copilot |
| amanning3390/hermeshub | 社区技能注册中心 | 安全扫描认证、API 与市场 |
| kevinnft/ai-agent-skills | 191 个技能，28 分类 | Hermes/Claude Code/Cursor 跨平台 |
| NousResearch/hermes-agent | 官方主仓库 | 内置 Skills 与编写规范权威来源 |
发布团队 Tap：GitHub 仓库结构含 skills.sh.json（Hub 分类）、分类目录下各 SKILL.md。团队成员 hermes skills tap add github:your-org/your-skills-tap；私有仓库加 --token $GH_TOKEN。建议将 ~/.hermes/skills/ 纳入 Git 版本控制跨设备同步，同步后 hermes skills reset 重建内置技能。
Plugin 技能以命名空间 plugin:skill 加载（如 skill_view("superpowers:writing-plans")），不出现在默认 skills_list、仅 opt-in 激活，同插件技能可横向感知。在 plugin.yaml 声明 skills 路径即可构建。
六步落地：从单机 Skill 到团队 Tap + 云 Mac 宿主
验证环境：hermes doctor 确认 Gateway、工具集与 ~/.hermes/ 路径正常。
编写首个 SKILL.md：按 agentskills.io 模板写 description、Procedure、Pitfalls、Verification Checklist。
创建 Bundle：hermes bundles create blog-workflow --skills seo-keyword-research,outline-generator --instruction "Research SEO first"。
配置条件激活：为免费/付费搜索、消息平台分别写 fallback/requires 规则。
发布 Tap：推送到 GitHub，团队 hermes skills tap add；设置 agent_writes_require_approval: true 开启审批门。
云 Mac 7×24 宿主：在 KVMNODE 独占 Mac Mini M4 部署 Gateway，避免笔记本休眠导致 Skill 会话与 GEPA 轨迹中断。
GEPA + DSPy 自进化、进阶编写技巧与可引用技术数据
GEPA（Genetic-Pareto Prompt Evolution）是 2026 ICLR Oral 成果，集成于 hermes-agent-self-evolution。核心思路：不微调模型权重，通过执行轨迹分析、变体生成、多目标帕累托优化改进 SKILL.md 文本。每次优化约 $2–10（纯 API，无需 GPU）。
五阶段进化流程：① 执行轨迹收集（SQLite）→ ② 反思式失败分析（可操作侧信息）→ ③ 靶向变异（10–20 个 SKILL.md 变体）→ ④ 多目标帕累托评估（成功率 × Token 效率 × 速度）→ ⑤ 人工审查 PR 后上线。
git clone https://github.com/NousResearch/hermes-agent-self-evolution 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 --eval-source mixed --trace-dirs ~/.claude/traces,~/.hermes/sessions
四大安全护栏：① pytest tests/ -q 100% 通过；② Skills ≤15KB、工具描述 ≤500 字符；③ 不破坏 Prompt Cache；④ 语义保留检查不偏离原始目的。官方进化路线图：Phase 1 Skill 文件（✅ DSPy+GEPA）→ Phase 2 工具描述 → Phase 3 系统提示 → Phase 4 工具实现代码（Darwinian Evolver）→ Phase 5 全自动持续改进。
进阶编写技巧：Pitfalls 须含具体失败模式、根因与修复步骤；Procedure 可引用 scripts/ 并在失败时 fallback 到 references/manual-extract.md；Agent 可通过 skill_manage(action='patch'|'create') 动态维护技能。
博客工作流实战 Bundle 示例：blog-workflow 打包 seo-keyword-research、outline-generator、code-example-validator、bilingual-checker、publish-to-platform，instruction 要求先调研 SEO、验证代码可运行、生成中英标题选项。
GitHub Star 增速：Hermes Agent 2026 年初两个月突破 160k+ Stars，AI Agent 领域增速最快开源项目之一。
Level 0 Token 预算：全部技能 name+description 合计约 ~3K tokens，是控制成本的第一道闸门。
GEPA 单次成本：约 $2–10/次 纯 API 调用，无需 GPU；配合 sessiondb 真实轨迹效果更好。
跨平台技能库：kevinnft/ai-agent-skills 含 191 个技能、28 个分类，Hermes/Claude/Cursor 通用。
英文 SEO 侧翼策略：避开饱和的 "Hermes tutorial" 综述，主攻 GEPA prompt evolution、agentskills.io SKILL.md、hermes skills tap publish 等低竞争精准词。
注意：Skill 中文正文对 Token 效率影响与英文相近（约 1–1.5 token/字），但 description 建议保留英文或中英双语，底层 LLM 对英文 description 匹配更精确。
摊开替代方案：在个人 MacBook 上跑 Hermes + GEPA 进化合盖即断、SQLite 轨迹库膨胀后 swap 抖动；Linux VPS 无官方 macOS 路径失去 Metal 本地推理与一键安装体验；把 Skill Tap 与 Xcode CI 挤在同一台机器维护重启频繁。对需要 7×24 Gateway 常驻、稳定积累执行轨迹、让 Skills 持续 GEPA 进化的生产环境，KVMNODE 独占 Mac Mini M4 / M4 Pro 月租通常是更优解：launchd 守护、按天/周/月弹性、六区选区。档位见 定价页，订购入口 可把 Agent 宿主从笔记本迁出，与 OpenRouter CLI 工具排行 中的 Hermes 全平台第一数据形成闭环。