Skip to content

建立 2026-09-19 更新 2026-09-19

技能

技能（Skill）是一份 Markdown 文件，教代理「某類任務該怎麼做」：什麼時候用、步驟是什麼、常見陷阱與怎麼驗證。Hermes 內建大量技能，也會在完成複雜任務後自己寫新的，這是它「越用越聰明」的主要來源。

SKILL.md 的格式

每個技能是 ~/.hermes/skills/ 底下的一個資料夾，核心是 SKILL.md：

~/.hermes/skills/
└── devops/
    └── my-skill/
        ├── SKILL.md
        ├── references/
        ├── templates/
        ├── scripts/
        └── examples/

檔案開頭是 YAML front matter，接著是說明本文：

---
name: my-skill
description: 簡短說明這個技能做什麼
version: 1.0.0
platforms: [macos, linux]
metadata:
  hermes:
    tags: [python, automation]
    category: devops
---

本文通常包含「何時使用」「步驟」「常見陷阱」「驗證方式」等段落。

漸進式載入：為何不怕技能很多

技能多了會吃掉上下文嗎？不會，Hermes 分三層載入：

層級 載入內容 成本
0 所有技能的名稱與簡述（skills_list()） 約 3k tokens
1 某個技能的完整內容（skill_view(name)） 用到才載入
2 技能裡的特定參考檔（skill_view(name, path)） 需要才載入

代理只有在真正需要時，才會讀完整內容。

瀏覽、搜尋與安裝

hermes skills browse                           # 瀏覽技能庫
hermes skills search <關鍵字>                   # 依關鍵字搜尋
hermes skills install official/security/1password   # 安裝官方選用技能
hermes skills install openai/skills/k8s        # 從 GitHub 安裝
hermes skills check                            # 檢查是否有上游更新

在對話中也能直接叫用，用斜線加技能名稱：

/gif-search funny cats
/github-pr-workflow /test-driven-development fix issue #123

第二行示範一次疊加多個技能（最多 5 個）。

安裝第三方技能前先讀過

技能會影響代理怎麼使用終端機與檔案。從陌生來源安裝時，請先打開 SKILL.md 與 scripts/ 讀過，確認沒有你不想讓它做的事。

讓代理自己寫技能

代理用 skill_manage 工具維護「程序性記憶」，動作有 create（新增完整技能）、patch（局部修改，最省 token，優先使用）、write_file（加輔助檔）與 delete。

你也可以用 /learn 主動要求它從資料產生技能：

/learn <來源>

來源可以是文件、原始碼、網站或先前的對話；產生後可在核准關卡檢視再啟用。

推薦影音

/learn 自動產生技能

簡述：約 7 分鐘介紹 /learn：如何從文件、原始碼、網站與過往對話產生結構化的 SKILL.md，以及漸進式載入如何節省 token。適合讀完本頁、想看實際畫面的人。

相關資料