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 框架。