2026 Hermes Agent Skills
进阶全攻略

与传统「一次性 Prompt」不同，Hermes 的技能体系是一套有标准、可进化、跨会话持久的程序性记忆。安装入门可看保姆级安装教程，记忆机制可看三层记忆篇；本篇直接进入进阶区域。

所有 Hermes Skills 遵循 agentskills.io 开放标准，确保跨 Agent 可移植（Hermes、Claude Code、Cursor 均可使用）。可用 skills-ref validate ./my-skill 验证格式合规性。

---
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, test-driven-development]
    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 可直接执行的脚本

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] 自动从提示词消失；API 不可用时备选方案自动浮现。平台感知示例：requires_toolsets: [messaging] + platforms: [telegram, discord]，通过 hermes skills TUI 可为不同平台独立开关技能。

官方安装渠道：

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

发布团队 Tap：创建 GitHub 仓库，用 skills.sh.json 控制 Hub 分类，团队成员执行 hermes skills tap add github:your-org/your-skills-tap；私有仓库加 --token $GH_TOKEN。建议将 ~/.hermes/skills/ 纳入 Git 版本控制实现跨设备同步。

GEPA + DSPy 自进化（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

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；Prompt Cache 兼容；语义保留检查。官方进化路线图：Phase 1 Skill 文件（✅ 已实现）→ Phase 2 工具描述 → Phase 3 系统提示 → Phase 4 工具实现代码 → Phase 5 全自动循环。

Plugin 技能以 plugin:skill 命名空间加载，不出现在默认 skills_list，仅用户明确调用时激活，插件内技能可相互引用。进阶编写要点：description 写清触发条件；Common Pitfalls 含具体失败模式与修复步骤；大技能拆到 references/（>500 行建议拆分，>15KB 超 GEPA 限制）；skill_manage 工具让 Agent 动态维护技能，可在 config.yaml 设 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 技能在 metadata.hermes 设 requires_toolsets: [web]，Procedure 覆盖中文长尾（「X 怎么用」「X 教程」）与英文长尾（「how to X」「X vs Y」）及平台热榜交叉验证。

笔记本合盖、x86 VPS 无 macOS 路径、本地磁盘无版本管理——这些宿主方案都会打断 Skill 复利与 GEPA 轨迹积累。对于需要 7×24 Gateway、Skill 自进化与跨设备同步的生产环境，MESHLAUNCH 的 Mac Mini M4 云端裸金属租赁通常是更优解：独占 Apple Silicon、launchd 原生守护、按天/周/月弹性下单，与 Hermes 官方 macOS 路径最契合。延伸阅读：Hermes 中文文档、GEPA 算法、DSPy 框架。