Hermes Agent Skills 進階全攻略 2026：SKILL.md、Bundles 與 GEPA 自我進化

2026 年初，Nous Research 發布 Hermes Agent，兩個月內 GitHub Star 突破 16 萬，成為 AI Agent 領域增速最快的開源專案之一。標語不是「更大的模型」，而是 「the agent that grows with you」——Agent 會隨使用越來越懂你。

這一切的底層實現，就是 Skills 技能系統。與傳統一次性 Prompt 不同，Hermes 技能是有標準、可進化、跨會話持久的程序性記憶。本文不聊基礎入門，直接進入進階：漸進載入如何控制 Token 成本、條件激活如何感知環境、Skill Bundles 如何一鍵觸發複雜工作流、DSPy + GEPA 如何讓技能自動變強，以及開源社群有哪些現成優質技能倉庫可直接 Tap。

• Token 外洩：每次會話把完整 SOP 塞進上下文，還沒選任務就燒掉大量 Token。Skills 設計為按需載入，當成常駐 Prompt 等於自廢武功。
• description 太模糊：寫「協助寫程式」會在無關場景被誤激活。description 是 Level 0 的唯一判斷依據，必須寫清「何時用、何時不用」。
• 工作流未打包：團隊每次開會話手動敲五個斜線指令——code review、TDD、PR、除錯、部署——而非一個 Bundle 一次載入。
• 改完不生效：會話中途修改 SKILL.md 不會立即反映，需 /reset 或 --now 強刷（後者會使 Prompt Cache 失效、增加成本）。
• Skills 與 MCP 混淆：MCP 提供工具能力，Skills 教 Agent如何正確使用這些工具。只有 MCP 沒有 Skill，Agent 可能亂調資料庫。

三種上下文機制長得像，行為卻完全不同。寫第一個 SKILL.md 前先對照下表。

記憶口訣：Prompt = 便利貼（當次有效）；Memory = 便簽本（永久筆記）；Skill = SOP 手冊（需要時翻閱）。

所有 Hermes Skills 遵循 agentskills.io 開放標準，可跨 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
- Use for: [具體場景]
- Don't use for: [排除場景]

## Procedure
1. 步驟一（含精確命令）
2. 步驟二
3. 步驟三

## Common Pitfalls
1. 失敗模式 + 修復
2. 邊界情況

## Verification Checklist
- [ ] 驗證點 1
- [ ] 驗證點 2

目錄模組化：

├── SKILL.md              # 核心步驟（建議 ≤500 行）
├── references/
│   ├── api-docs.md       # 按需載入
│   └── examples.md
├── templates/
│   └── config.yaml
└── scripts/
    └── setup.sh          # Agent 可直接執行

Progressive Disclosure（漸進式載入） 是 Token 控制核心：

description 是 Level 0 的全部資訊。寫清「什麼時候用」比「它是什麼」更重要——LLM 靠它決定是否載入完整技能。

Skill Bundles 是 Hermes 2026 新增特性，目前仍被低估。Bundle 是輕量 YAML，把多個技能打包成一個斜線命令；執行 /bundle-name 時列出的技能同時載入。

路徑：~/.hermes/skill-bundles/<slug>.yaml

name: backend-dev
description: |
  Full backend feature workflow — code review, TDD, and PR management.
  Use at the start of any new backend feature session.
skills:
  - github-code-review
  - test-driven-development
  - github-pr-workflow
instruction: |
  Always write failing tests first before implementation.
  Open PRs with co-author tags for pair-programming sessions.
  Never push directly to main.

name: research-session
description: Load all research tools at once for deep-dive sessions.
skills:
  - arxiv
  - deep-research
  - plan
  - excalidraw
instruction: |
  Start every session by checking recent papers on the topic.
  Create an Excalidraw diagram for any architecture discussed.

優先級規則：Bundle 與同名 Skill 衝突時 Bundle 優先；未安裝的技能跳過並提示，不報錯；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 下配置：

metadata:
  hermes:
    requires_toolsets: [web]
    requires_tools: [web_search]
    fallback_for_toolsets: [browser]
    fallback_for_tools: [browser_navigate]

免費／付費搜尋切換：DuckDuckGo 技能設 fallback_for_tools: [web_search]。配置 FIRECRAWL_KEY 或 BRAVE_SEARCH_KEY 後付費 web_search 激活，DuckDuckGo 自動從提示詞消失以省 Token；API 不可用時備選自動浮現。

平台感知：用 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 之間流通。

可引用數據點 1：Hermes Agent 2026 年初兩個月 GitHub Star 突破 160,000。

可引用數據點 2：Level 0 技能目錄（全部 name + description）合計約 3K Token。

可引用數據點 3：社群倉庫 ai-agent-skills 收錄 191 個跨平台技能、28 個分類。

以 GitHub 倉庫作 Tap，可讓整個團隊甚至社群訂閱你的技能集——這是少有人講的進階技巧。

my-skills-tap/
├── skills.sh.json
├── mlops/
│   ├── vllm-deploy/SKILL.md
│   └── model-benchmark/SKILL.md
├── research/
│   ├── paper-summarizer/SKILL.md
│   └── citation-finder/SKILL.md
└── README.md

{
  "groupings": [
    {
      "title": "MLOps & Model Deployment",
      "skills": ["vllm-deploy", "model-benchmark"]
    },
    {
      "title": "AI Research Workflows",
      "skills": ["paper-summarizer", "citation-finder"]
    }
  ]
}

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

版本管理：將 ~/.hermes/skills/ 納入 Git 做跨裝置同步；git pull 後執行 hermes skills reset 重建內建技能。

GEPA（Genetic-Pareto Prompt Evolution） 是 ICLR 2026 Oral 成果，整合於 hermes-agent-self-evolution。核心思路：不微調模型權重，只透過分析執行軌跡、生成變體、多目標帕累托優化來改進技能文本本身。

成本：每次優化約 $2–10（純 API 呼叫，無需 GPU）。

五階段進化流程：

1. Stage 1 軌跡收集：從 SQLite 讀取全量推理軌跡（工具呼叫、分支、錯誤）。
2. Stage 2 反思式失敗分析：LLM 產出「為什麼失敗」的可操作側資訊。
3. Stage 3 靶向變異：針對根因生成 10–20 個 SKILL.md 變體。
4. Stage 4 多目標帕累托評估：同時優化成功率 × Token 效率 × 速度。
5. Stage 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

四大安全護欄（全部通過才生成 PR）：

• 全量測試：pytest tests/ -q 100% 通過
• 大小限制：Skills ≤ 15KB，工具描述 ≤ 500 字元
• Prompt Cache 相容：不可在會話中途修改導致快取失效
• 語意保留：變體不可偏離技能原始核心目的

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

插件以 plugin:skill 命名空間打包技能：

• 預設不出現在 skills_list，減少系統提示雜訊
• 僅在使用者明確呼叫時激活（Opt-in）
• 同插件內技能可相互感知（橫向展示兄弟技能）

skill_view("superpowers:writing-plans")

Agent 會提示：「This plugin also includes: superpowers:editing, superpowers:research」。

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.

description: |
  Use when reviewing a pull request, checking for code quality issues,
  security vulnerabilities, or style violations. Handles GitHub PR URLs
  and local git diff output. Do NOT use for writing new code.

Pitfalls 章節是品質分水嶺：具體失敗模式、根因分析、可操作的修復步驟——而非泛泛警告。

腳本化：在 Procedure 中引用 scripts/extract_schema.py；失敗時載入 references/manual-extract.md 作為手動後備。

skill_manage 讓 Agent 以程式化方式 patch 或建立技能。在 config.yaml 開啟審批門：skills.agent_writes_require_approval: true。

目標：為 Hermes 建一套完整的部落格寫作輔助技能體系。

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.

---
name: seo-keyword-research
description: |
  Use when planning a technical blog post. Researches search volume,
  competition, and related queries for Chinese and English audiences.
metadata:
  hermes:
    requires_toolsets: [web]
    tags: [seo, blogging, content]
---

## Procedure
1. 從使用者或上下文識別主題
2. 中文長尾：「X 怎麼用」「X 教程」「X 最佳實踐」
3. 英文長尾：「X tutorial」「how to X」「X vs Y」
4. 交叉比對平台趨勢（掘金、Dev.to、HN）
5. 輸出關鍵字矩陣：每語言 3–5 主詞 + 10–15 長尾

會話開始執行 /blog-workflow，Agent 先研究關鍵字、產大綱、驗證程式範例、準備雙語標題，再動筆寫正文。

1. 01
   安裝 Hermes 與基線技能：依 安裝教學 完成部署。訂閱官方 Tap 與至少一個社群倉庫（hermes skills tap add github:ChuckSRQ/awesome-hermes-skills）。用 hermes skills list 確認 Level 0 目錄維持在約 3K Token 以內。
2. 02
   控制台撥備雲端 Mac：登入 NUKCLOUD 控制台，選 16 GB+ 記憶體（GEPA 進化與活躍會話並行建議 32 GB）。定價頁 按小時試跑適合技能編寫試點。
3. 03
   編寫並驗證 SKILL.md：在 ~/.hermes/skills/ 依 agentskills.io 建立技能。執行 skills-ref validate ./my-skill。撰寫精確 description，超過 500 行拆至 references/。
4. 04
   打包 Bundles 與條件激活：為重複工作流新增 YAML Bundle。設定 fallback_for_tools 做免費／付費工具切換。以 /bundle-name 冒煙測試，確認缺失技能僅警告不崩潰。
5. 05
   發布團隊 Tap 並跑 GEPA：推送技能至 GitHub Tap；隊友執行 hermes skills tap add。Clone hermes-agent-self-evolution，設 HERMES_AGENT_PATH，以 --eval-source sessiondb 進化一個技能（預算 $2–10/次）。合併前審查 PR diff。
6. 06
   常駐化與固定月租：將 ~/.hermes/skills/ 納入 Git；用 launchd 保持 Hermes 閘道或 Telegram Bot 7×24。試點通過後於 下單頁 鎖定規格。IDE 與終端機 Agent 分工見 Cursor Skills 指南；節點撥備細節見 生產就緒 Runbook。

在筆電跑 Hermes 常見合蓋休眠中斷 Telegram 會話、共享 VPS 頻寬抖動打斷長 Agent 迴圈、會話中途改技能導致 Prompt Cache 失效。GEPA 進化與夜間 Agent 需要機器常醒、網路穩定。生產級 Skills 實驗室與團隊 Tap 場景下，NUKCLOUD 多區域裸機 Mac / 雲端 Mac 節點在獨佔租戶邊界與規格彈性上更易與 Skills 工作流對齊——定價頁按小時試跑，技能目錄穩定後再轉固定月租。

官方文件：

• Hermes Agent 官方文件
• Hermes Agent 中文文件
• Skills 系統完整參考
• Creating Skills 開發者指南
• agentskills.io 開放標準

開源倉庫：

• NousResearch/hermes-agent
• hermes-agent-self-evolution — GEPA 工具
• awesome-hermes-skills
• hermeshub
• ai-agent-skills — 191 跨平台技能
• gepa-ai/gepa — GEPA 演算法（MIT）
• stanfordnlp/dspy — DSPy 框架

社群內容：

• SegmentFault：Hermes Agent 中文開發者實戰指南
• Hermes 中文站 — 自訂技能
• Dev.to：自我改進 Agent 解剖
• YouTube：Hermes 速成（GEPA 與擴展）
• YouTube：Skill Bundles 深度解析