為什麼 Skill 改了但 Agent 還在用舊版？

Skill 修改在當前會話不生效，需 /reset 開新會話，或安裝時加 --now 強制刷新（會導致 Prompt Cache 失效，消耗更多 Token）。

GEPA 進化出的技能安全嗎？

通過四大護欄（全量測試、大小限制 Skills ≤15KB、Prompt Cache 兼容、語義保留）且需人工 PR 審查；仍建議逐 diff 人工 review。

如何在 Claude Code 中複用 Hermes Skills？

複製 SKILL.md 到 ~/.claude/skills/，或使用 kevinnft/ai-agent-skills 等跨 Agent 安裝腳本，一次安裝多端可用。

Skill 的中文內容會影響 Token 效率嗎？

中文字符約 1–1.5 token/字，與英文相近；但 description 欄位建議保留英文或中英雙語，底層 LLM 對英文 description 的路由匹配更精確。

Hermes Agent Skills 進階全攻略：從 SKILL.md 到 GEPA 自我進化與 Skill Bundles 工作流（2026）

Q: Skills 和 MCP 有什麼區別？

Skills 是程序性知識文件，教 Agent 如何完成多步驟任務；MCP 是工具協議，提供額外 API 調用能力。兩者互補——Skills 可編排 MCP 工具調用。

若你的 Hermes Agent 仍靠一次性 Prompt 驅動，每個會話都在重複付全量上下文成本，程序性知識卻無法複利。本文面向進階用戶與團隊技術負責人：涵蓋 agentskills.io SKILL.md 格式、三級漸進載入、Skill Bundles YAML、條件激活四規則、GEPA + DSPy 自進化（$2–10/次）、Skill Tap 發布、常駐硬體決策矩陣、Mac 雲五步 Runbook 與五題 FAQ——讓 Gateway 在你合蓋後仍持續累積技能資產。

痛點拆解：為何 Skills 需要單獨深研

Prompt 無法跨會話、跨倉庫複用。 部署清單與 PR 模板散落在聊天記錄裡，新人入職又要重貼十二步。Skills 把程序性知識寫進 Git——但只有理解 SKILL.md 路由與漸進載入，才能真正省 Token 並提高激活精度。
全量載入燒掉上下文。 把所有指令塞進系統提示，每輪對話都在付固定成本。Hermes Level 0 目錄約 3K Token，多數團隊卻從不調 description、不拆分 references——導致錯誤 Skill 被觸發或該觸發時不觸發。
進化與在線脫節。 GEPA 能從執行軌跡改進 SKILL.md，但若 Gateway 在筆電上睡眠、或在無原生 macOS 的 Linux 上跑，腳本靜默失敗、軌跡庫斷檔。參見站內 Hermes 三層記憶與常駐硬體一文，說明為何 7×24 在線會放大 Skill 複利。

1. 為什麼 Hermes Skills 值得單獨深入研究

2026 年初 Nous Research 開源 Hermes Agent，兩個月內 GitHub Star 突破 16 萬，成為 AI Agent 領域增速最快的開源專案之一。核心賣點不是更大的模型，而是 the agent that grows with you——Agent 會隨使用越來越懂你。底層實現就是技能（Skills）系統：有標準、可進化、跨會話持久的程序性記憶，而非一次性 Prompt。

本文不聊安裝入門，直接進入 SKILL.md 編寫、Bundles、條件激活、社區 Tap 與 GEPA 自進化——把 Demo Agent 變成可投產的技能庫所需的機制。

2. Skills ≠ Memory ≠ Prompts

維度	普通 Prompt	Memory（記憶）	Skills（技能）
持久性	當前對話	跨會話，永久	跨會話，永久
載入時機	每次都在上下文中	每次會話自動注入	按需載入（關鍵差異）
Token 成本	每次消耗	小而穩定	激活前零消耗
內容類型	任意意圖	用戶偏好/事實	程序性步驟（如何做某件事）
維護者	用戶手動	Agent 自動	用戶 + Agent
可共享性	不便共享	私有	可發布為社區 Tap

記憶口訣：Prompt = 便利貼；Memory = 便簽本；Skill = SOP 手冊（需要時翻閱）。

3. SKILL.md 格式與漸進載入

所有 Hermes Skills 遵循 agentskills.io 開放標準，可在 Hermes、Claude Code、Cursor 間移植。

---
name: my-skill
description: |
  Use when the user needs to [...].
version: 1.0.0
metadata:
  hermes:
    tags: [devops, automation]
    requires_toolsets: [terminal]
---

# My Skill Title

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

## Common Pitfalls
- 失敗模式 + 修復方案

目錄結構（~/.hermes/skills/）：

~/.hermes/skills/my-category/my-skill/
├── SKILL.md              # 核心步驟（建議 ≤500 行）
├── references/           # 按需載入
├── templates/
└── scripts/              # 本地執行，僅輸出進上下文

Progressive Disclosure 三級載入

層級	內容	觸發時機	Token 成本
Level 0	`name` + `description`	會話開始（全部技能）	目錄合計約 3K
Level 1	完整 SKILL.md 正文	`/skill-name` 或 LLM 匹配	視檔案長度
Level 2	`references/`、`scripts/`	執行中按需	單檔按需

description 寫「何時用」，而非「是什麼」。 LLM 僅靠 Level 0 文本路由；模糊描述導致誤觸發或永不激活。

4. Skill Bundles：一條命令觸發完整工作流

Skill Bundles 是 Hermes 2026 新增特性，將多個技能打包為斜杠命令。路徑：~/.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.

AI 研究員工作流範例

name: research-session
skills:
  - arxiv
  - deep-research
  - plan
  - excalidraw
instruction: |
  Start every session by checking recent papers on the topic.

優先級規則： Bundle 與同名 Skill 衝突時 Bundle 優先；未安裝的 Skill 跳過並提示；Bundle 不修改系統提示（Prompt Cache 友好）。

hermes bundles create backend-dev \
  --skills github-code-review,test-driven-development,github-pr-workflow \
  --instruction "Always write failing tests first"

5. 條件激活（四種規則）

在 metadata.hermes 下配置，技能可隨工具可用性自動顯示或隱藏：

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

欄位	行為邏輯
`requires_toolsets`	列出的工具集不存在時隱藏
`requires_tools`	列出的工具不存在時隱藏
`fallback_for_toolsets`	列出的工具集存在時隱藏（備選方案）
`fallback_for_tools`	列出的工具存在時隱藏（備選方案）

典型場景：duckduckgo-search 設 fallback_for_tools: [web_search]——配置 Firecrawl/Brave 付費搜索時，免費備選自動消失，節省 Token。

6. Skills Hub 與開源生態

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

倉庫	描述	亮點
ChuckSRQ/awesome-hermes-skills	生產級精選技能	Deep Research、MLOps、Apple 整合
amanning3390/hermeshub	社區註冊中心，安全掃描	每技能經提示注入檢測
kevinnft/ai-agent-skills	191 技能，28 分類	Hermes / Claude / Cursor 通用
NousResearch/hermes-agent	官方主倉庫	內建技能權威來源

格式驗證：skills-ref validate ./my-skill。

7. 發布 Skill Tap

my-skills-tap/
├── skills.sh.json
├── mlops/vllm-deploy/SKILL.md
└── research/paper-summarizer/SKILL.md

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 跨裝置同步；pull 後執行 hermes skills reset 重建內建技能。

8. GEPA + DSPy 自我進化

GEPA（Genetic-Pareto Prompt Evolution） 為 ICLR 2026 Oral 成果，見 hermes-agent-self-evolution。不微調模型權重，僅從執行軌跡優化 SKILL.md 文本。成本：每次約 $2–10（純 API，無需 GPU）。

五階段進化流程

執行軌跡收集 — SQLite 存全量推理軌跡（工具調用、分支、錯誤）。
反思式失敗分析 — LLM 生成可操作側信息，而非僅「失敗了」。
靶向變異 — 針對根因生成 10–20 個 SKILL.md 變體。
多目標帕累托評估 — 同時優化成功率 × Token 效率 × 速度。
人工審查 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 sessiondb

四大安全護欄

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

五階段進化路線圖

階段	優化目標	引擎	狀態
Phase 1	SKILL.md 文件	DSPy + GEPA	✅ 已實現
Phase 2	工具描述	DSPy + GEPA	🔲 計劃中
Phase 3	系統提示片段	DSPy + GEPA	🔲 計劃中
Phase 4	工具實現代碼	Darwinian Evolver	🔲 計劃中
Phase 5	全自動持續改進	自動化流水線	🔲 計劃中

9. Plugin 技能

插件以 plugin:skill 命名空間打包技能——不出現在默認 skills_list，僅在用戶明確調用時激活，並可感知同插件兄弟技能：

skill_view("superpowers:writing-plans")
# Agent: "This plugin also includes: superpowers:editing, superpowers:research"

在 plugin.yaml 中聲明：

name: my-hermes-plugin
skills:
  - name: writing-plans
    path: skills/writing-plans/SKILL.md

10. 編寫技巧與 skill_manage

description 精度： 錯誤：「Helps with code.」正確：「Use when reviewing a pull request… Do NOT use for writing new code.」

Pitfalls 章節 是分水嶺——具體失敗模式、根因與修復（限流、選擇器脆弱、超大 diff Token 溢出）。

大小控制： <500 行放 SKILL.md；500–1000 拆 references/；>15KB 無法通過 GEPA 護欄。

skill_manage(
    action='patch',
    name='github-code-review',
    old_string='Check for obvious bugs',
    new_string='Check for: null pointers, SQL injection, XSS, logic errors'
)

skills:
  agent_writes_require_approval: true  # config.yaml 審批門

11. 博客工作流實戰案例

# ~/.hermes/skill-bundles/blog-workflow.yaml
name: blog-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.

seo-keyword-research 設 requires_toolsets: [web]，在寫大綱前輸出中英文關鍵詞矩陣（各 3–5 主詞 + 10–15 長尾）——正是 VPSMAC 多語言博客產線的實際工作流。

12. 常駐硬體決策矩陣

宿主	7×24 在線	GEPA 軌跡連續性	原生 macOS / Xcode	最適場景
本地 MacBook	❌ 合蓋即斷	❌ 會話庫有缺口	✅	編寫、短測
Linux VPS	✅ systemd	✅ 純 CLI 技能	❌	文本 Agent，無 Apple 工具鏈
VPSMAC Mac 雲節點	✅ launchd	✅ 軌跡持續累積	✅ 裸機 SSH	Hermes Gateway + GEPA 閉環

13. 五步 Runbook：Mac 雲投產技能庫

步驟 1 — 審計並安裝基礎技能。 hermes skills tap add 訂閱團隊 Tap；skills-ref validate 驗證格式；記錄 Bundle 與工作流對應關係。

步驟 2 — 編寫或修補 SKILL.md。 Level 0 description 寫清觸發語；超 500 行拆 references/；生產環境開啟 agent_writes_require_approval。

步驟 3 — 建立 Bundles 與條件規則。 hermes bundles create blog-workflow --skills …；為免費/付費工具設 fallback_for_tools。

步驟 4 — 在 VPSMAC Mac 節點部署 Gateway。 Git 同步 ~/.hermes/skills/ 與 skill-bundles/；launchd KeepAlive 常駐；確認 Cron 與 IM 通道 7×24 連通。

步驟 5 — 啟用 GEPA 進化循環。 設定 HERMES_AGENT_PATH；每週 evolve_skill --eval-source sessiondb；PR 人工審批後合併；換機前備份 ~/.hermes。

14. 可引用硬核數據（2026-06）

Hermes Agent 上線兩個月 GitHub Star 16 萬+；Skills + Honcho 用戶模型構成 closed learning loop。
Level 0 技能目錄合計約 3K Token，與單個 Skill 正文長度解耦。
GEPA 單次優化 $2–10，純 API；Skills 須 ≤ 15KB 才過護欄。
kevinnft/ai-agent-skills：191 技能、28 分類，Hermes / Claude / Cursor 一鍵安裝。

15. 常見問題 FAQ

Skills 和 MCP 有什麼區別？ Skills 教程序；MCP 供工具。Skills 可編排 MCP 調用。

Skill 改了但 Agent 還用舊版？ 需 /reset 新會話，或 --now 安裝（會失效 Prompt Cache）。

GEPA 進化的技能安全嗎？ 四大護欄 + 人工 PR；仍須逐 diff review。

Claude Code 如何複用？ 複製到 ~/.claude/skills/ 或用跨平台安裝腳本。

中文內容 Token 成本？ 約 1–1.5 token/字；description 建議英文以利路由。

16. 延伸資源

Hermes 官方文檔 · 中文文檔 · agentskills.io 標準
hermes-agent-self-evolution · gepa-ai/gepa · stanfordnlp/dspy
awesome-hermes-skills · hermeshub · ai-agent-skills

17. 結語：技能複利的前提是 Gateway 一直跑著

筆電編寫、廉價 VPS 跑 Docker、WSL2 都能裝 Hermes——但各有短板：睡眠中斷軌跡採集；Linux 缺原生 macOS 簽名與 Metal 腳本；本機硬體把 GEPA 數據綁在一台機器上且備份麻煩。Skill Bundles 與條件激活省 Token；GEPA 把失敗變成更好的 SKILL.md——前提是會話庫在穩定硬體上持續增長。

把技能庫當基礎設施的團隊，租賃 VPSMAC Apple Silicon Mac 雲節點 可獲 launchd 7×24、Git 同步 ~/.hermes 與按月升配 RAM，無需為換代買新機。在裸機 macOS 上投產技能庫，讓 GEPA 迭代、你審 PR——而不是追 uptime。