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 全平台第一資料形成閉環。