# Hermes Agent 技能：安裝技能與建立自己的技能 > 目錄與 GitHub、SKILL.md 格式、/learn、檢查、更新及移除 Hermes Agent 技能，並附完整命令範例。 Source: https://ailoot.ai/blog/zh-hant-tw/hermes-agent-skills/ Canonical: https://ailoot.ai/blog/zh-hant-tw/hermes-agent-skills/ Language: zh-Hant-TW Publisher: Ailoot (https://ailoot.ai/) Translation: guide-117 Revision: sha256-0420a0e220f13d013983515c35adb3b839549ae477ba988f3980e6fe5e52a4d7 技能是為代理程式儲存的指示：你只要描述一次如何執行某項工作，之後呼叫 `/skill-name` 時，Hermes 就會套用這些指示，不必一再說明。現成技能只需一個命令即可安裝；你也可以用兩種方式建立自己的技能：手動撰寫 SKILL.md，或使用 `/learn`。 如果你還沒有安裝 Hermes，請先閱讀[這個代理程式是什麼，以及如何安裝](https://ailoot.ai/blog/zh-hant-tw/hermes-agent-install-setup/)，再開始使用技能。
Ailoot 的實用操作說明請參閱[文件](https://ailoot.ai/docs/)。
## Hermes Agent 中的技能是什麼？
重點 技能是包含代理程式指示的檔案：要做什麼、使用哪些命令、注意什麼，以及常見錯誤。技能會以 SKILL.md 檔案的形式儲存在 `~/.hermes/skills/` 資料夾中，並可附上相關資料。安裝後，技能會自動成為代理程式任何聊天中的 `/name` 命令。
你可以在傳給代理程式的訊息中撰寫提示。技能則儲存在獨立檔案中，Hermes 能在未來的工作中使用其中的指示。代理程式可以取得技能名稱和說明清單，並在技能與任務相關時載入完整內容。這能節省上下文空間：不必一次載入所有指示。 技能本身不會賦予代理程式新工具或存取權；它只會說明如何使用代理程式原本就能使用的工具。與外部服務的新整合由 MCP 負責，這是另一個主題。如果任務需要精確的程式邏輯、特殊授權或事件串流處理，就需要代理程式工具，光靠技能並不足夠。 如果標準任務的現成技能指示符合需求，而且來源已確認，就選用現成技能。如果你需要保留自己的操作順序、限制和輸出格式，就自行撰寫技能。如果你已經有資料，或已完成某個流程而不想手動撰寫檔案，就使用 `/learn`。

技能是包含代理程式所需資訊的文件，代理程式只會在需要時載入。

— Hermes Agent 文件（由英文翻譯），https://hermes-agent.nousresearch.com/docs/user-guide/features/skills
這種格式是開放的，且與 [Agent Skills 規格](https://agentskills.io/specification)相容，因此其他目錄中的技能通常不必更改格式，就能在 Hermes 中使用；不過，特定技能可能需要自己的工具或金鑰。如果你願意，也可以分享自己的技能。 ## 已安裝哪些技能？技能存放在哪裡？
重點 預設情況下，技能會儲存在 `~/.hermes/skills/` 資料夾，並依類別分成子資料夾（如果你使用非標準設定檔或 HERMES_HOME 變數，路徑會不同；`hermes config path` 會顯示路徑）。安裝後的 Hermes 已內建數十種技能，從搜尋 arXiv 到操作 GitHub 和文件都有。`hermes skills list` 命令會顯示清單，你也可以在聊天中詢問代理程式有哪些技能。
資料夾的結構如下： ``` ~/.hermes/skills/ ├── research/ │ └── arxiv/ │ ├── SKILL.md │ └── scripts/ ├── productivity/ │ └── pdf/ │ ├── SKILL.md │ └── references/ └── .hub/ ``` SKILL.md 是唯一必備的檔案。其他內容依需求新增：較長的資料放在 `references/`，輔助程式放在 `scripts/`，範本和檔案則放在 `templates/` 與 `assets/`。 內建目錄收錄了日常工作所需的技能，例如尋找 GIF、操作 PDF、試算表、YouTube、GitHub 和筆記。完整清單及說明請見[內建技能目錄](https://hermes-agent.nousresearch.com/docs/reference/skills-catalog)頁面。每次執行 `hermes update` 時，Hermes 也會更新內建技能，同時保留你對它們所做的修改。 ## 如何從目錄安裝現成技能？
重點 使用 `hermes skills browse` 開啟目錄，以 `hermes skills search` 尋找所需技能，用 `hermes skills inspect` 查看技能卡片，再用 `hermes skills install` 安裝。每項技能在安裝前都會經過安全檢查；官方技能不會觸發第三方來源警告。
1. ### 搜尋目錄 ```bash hermes skills search pdf ``` 搜尋會涵蓋所有已連線的來源。若要不加篩選地查看完整目錄，請執行 `hermes skills browse`。 2. ### 查看技能卡片 ```bash hermes skills inspect skills-sh/anthropics/skills/pdf ``` 卡片會顯示說明、來源和信任等級。尚未閱讀卡片前，不要安裝別人的技能。 3. ### 安裝技能 ```bash hermes skills install skills-sh/anthropics/skills/pdf ``` Hermes 會下載 SKILL.md 及其相關檔案、執行安全檢查，並將所有內容放入 `~/.hermes/skills/`。技能會立即以 `/pdf` 命令供你使用。如果技能需要額外工具或金鑰，SKILL.md 會列出相關需求，Hermes 也會在安裝時告知你。 安全檢查會尋找試圖將資料傳送到外部、注入給代理程式的指示，以及可能刪除或損壞檔案的命令。來源的信任等級各不相同： | 等級 | 技能來源 | 安裝時的處理方式 | |----|----|----| | 內建 | Hermes 隨附 | 已經存在，不需要安裝 | | 官方 | Hermes 儲存庫中的 optional-skills 資料夾 | 安裝時不會出現第三方來源警告：`hermes skills install official/security/1password` | | 受信任 | openai/skills、anthropics/skills、huggingface/skills 和 NVIDIA/skills 儲存庫 | 檢查較不嚴格 | | 其他 | 目錄、其他人的 GitHub 儲存庫、直接連結 | 顯示警告並進行完整檢查 | 如果檢查發出警告，你可以加上 `--force` 旗標繼續安裝，但請先閱讀檢查發現的風險。「危險」判定無法略過。檢查本身不能保證安全：第一次執行別人的技能之前，請先閱讀其指示和相關命令。 ## 如何從 GitHub 或連結安裝技能？
重點 使用 `hermes skills install owner/repository/path` 從 GitHub 安裝技能，或使用 SKILL.md 檔案的直接連結；Hermes 會下載相關檔案。你可以用 `hermes skills tap add` 連結自己的技能來源，之後就能像使用其他目錄一樣使用它。
有三種安裝方式： ```bash # 1. GitHub 儲存庫中的特定技能（儲存庫內的路徑接在名稱後面） hermes skills install anthropics/skills/skills/pdf # 2. 任何網站上 SKILL.md 的直接連結（在聊天中分享這項技能） hermes skills install '' # 3. 將整個儲存庫連結為來源（替換成你的擁有者名稱與儲存庫名稱） hermes skills tap add myorg/skills-repo hermes skills install myorg/skills-repo/deploy-runbook ``` 使用直接連結時，Hermes 會下載 SKILL.md，以及其中提及的服務子資料夾中的檔案；不會下載網站上無關的檔案。連結會記錄為來源，之後執行 `hermes skills update` 時，Hermes 會從同一個網址更新技能。 除了 GitHub 之外，也可以連結外部技能目錄。你可以使用相同的 `hermes skills search` 命令搜尋其中的技能，並指定來源。
注意 GitHub 將未經驗證的請求限制為每小時 60 次。如果在安裝或搜尋時遇到速率限制錯誤，請將 `GITHUB_TOKEN` 加到 `~/.hermes/.env` 檔案中；限制會提高到每小時 5000 次請求。
## 安裝後如何使用技能？
重點 安裝的技能會自動成為命令：輸入 `/skill-name`，並在同一行輸入任務。不需要另外啟用。它可在終端機、網頁介面，以及透過 gateway 使用的即時通訊軟體中運作。你可以在一則訊息中呼叫最多五項技能，也可以把常用組合變成一個命令。
在終端機中輸入 `hermes ...` 命令；在與代理程式的聊天中輸入 `/skill-name` 呼叫技能（可在同一個終端機、網頁介面或即時通訊軟體中使用）： ``` /gif-search funny cats /github-pr-workflow create a PR for the authorization rewrite ``` 如果輸入 `/skill-name` 時沒有附上任務，Hermes 會載入指示並詢問你要它做什麼。一行最多可呼叫五項技能；其餘文字會成為任務內容： ``` /github-pr-workflow /test-driven-development close issue 123 and open a PR ``` 如果你經常使用某些組合，可以使用技能組合包；在 Hermes 的術語中，這稱為 bundles。執行 `hermes bundles create backend-dev --skill github-pr-workflow --skill test-driven-development`，即可將多項技能整合成一個簡短的 `/backend-dev` 命令。這種組合包會充當別名；其中的技能必須先安裝。 如果 gateway 已連線，Telegram 也能使用斜線命令；設定方式請見[如何將 Hermes Agent 連線到 Telegram](https://ailoot.ai/blog/zh-hant-tw/hermes-agent-telegram-setup/)。你也可以用手機執行技能。 ## 如何建立自己的技能：SKILL.md 要寫什麼？
重點 自己的技能是一個位於 `~/.hermes/skills/` 的資料夾，必備檔案只有 SKILL.md：先寫一段包含名稱和說明的簡短標頭，再依序整理成不同區段，例如使用時機、操作步驟、常見錯誤和驗證方式。內容使用純文字，不需要寫程式。簡單的技能只需要一個資料夾和一個檔案。

技能是為 Hermes Agent 加入新能力的主要方式：比工具更容易建立，不需要修改代理程式的程式碼，也可以與社群分享。

— Hermes Agent 文件（由英文翻譯），https://hermes-agent.nousresearch.com/docs/developer-guide/creating-skills
你可以複製以下技能，再依自己的需求調整： ```markdown --- name: weekly-review description: Weekly review: what got done, what stalled, plan for next week version: 1.0.0 metadata: hermes: tags: [planning, review] --- # Weekly review ## When to Use When the user asks to review the week or put together a plan for the next one. ## Procedure 1. Get the week's task list from the file the user provided, or ask them for it. 2. Sort the tasks into three groups: done, stalled, and new. 3. Name three priorities for the coming week. ## Pitfalls - Don't invent tasks that aren't in the original list. ## Verification Ask the user to confirm that the tasks are correctly sorted into “done,” “stalled,” and “new.” ``` 三個連字號之間的標頭是中繼資料。主要欄位是 `name`（使用拉丁字母並以連字號分隔，呼叫技能命令時會用到）和 `description`。代理程式會根據 description 欄位，判斷這項技能是否適合目前的任務，以及是否應該載入。如果 description 太籠統，需要這項技能時它可能不會載入。 標頭之後是指示區段。`When to Use` 說明何時載入技能；`Procedure` 提供操作步驟；`Pitfalls` 列出代理程式常犯的錯誤以及避免方法；`Verification` 說明如何檢查結果。如果指示很長，請將主要內容移至 `references/` 中的檔案；這些檔案只會在需要時載入，輔助程式則放在 `scripts/`。
提示 將最常見的情境放在前面，較少見的情況放在檔案末尾。Hermes 會由上而下讀取技能，這種順序能節省上下文。
如果技能需要 API 金鑰，請在標頭中使用 `required_environment_variables` 宣告變數名稱；不要將金鑰本身寫入檔案。Hermes 會在本機終端機第一次呼叫時詢問一次金鑰值，之後便會自動提供（在即時通訊軟體中，Hermes 會提示你在本機設定金鑰）。`platforms`、`config`、`blueprint` 等欄位請參閱官方文件頁面[建立技能](https://hermes-agent.nousresearch.com/docs/developer-guide/creating-skills)。 檔案準備好後，依照下列步驟操作： 1. ### 建立技能資料夾 ```bash mkdir -p ~/.hermes/skills/weekly-review ``` 資料夾名稱要與標頭中的 `name` 欄位相同。 2. ### 儲存 SKILL.md 在資料夾中建立名為 `SKILL.md` 的檔案並寫入指示。你可以使用上面的範例，再依任務需求改寫。 3. ### 呼叫技能並檢查 輸入 `/weekly-review`，請代理程式回顧你這一週的情況。如果它按照指示中的步驟執行，表示技能正常運作。 ## 如何使用 /learn 從現有資料建立技能？
重點 `/learn` 命令會根據現有資料建立技能：提供文件資料夾、網頁連結、筆記，或口頭描述一個流程，Hermes 就會依照既定慣例撰寫 SKILL.md，供你檢查。使用書籍或大型檔案集時，建立的技能會按主題分成個別檔案。
``` /learn documentation for the demo API in ~/projects/example-docs, especially the section on authentication /learn https://hermes-agent.nousresearch.com/docs/user-guide/features/skills /learn how I just published a site to hosting ``` 如果你剛和代理程式完成複雜流程，可以趁所有步驟還留在對話中時，請它用 `/learn` 將流程存成技能。下次 Hermes 就會依照現成指示重複操作。 書籍、規格或文件檔案集等大型來源無法全部放進單一檔案。Hermes 會建立精簡的 SKILL.md，附上主題索引，並將細節移至 `references/`。這些檔案在代理程式為回答問題而載入前，不會佔用上下文。對同一主題再次呼叫 `/learn` 時，內容會附加至現有技能，而不是建立重複項目。 ## 如何確認技能是否正常運作？
重點 執行 `hermes chat --toolsets skills -q`，並輸入與技能有關的要求來檢查，例如提供任務清單，請代理程式回顧一週的工作。如果代理程式依照指示將任務分類，技能就能正常運作。如果它像平常一樣回答，請檢查檔名、標頭中的 description，以及資料夾的位置。
```bash hermes chat --toolsets skills -q "review my week using the weekly-review skill: done - report and calls, stalled - hosting payment" ``` 這是文件建議的測試方式：執行技能，確認代理程式是否遵循指示。如果沒有，請檢查三種可能原因。第一，資料夾名稱或標頭中的 `name` 可能與你呼叫的名稱不一致。第二，description 可能沒有清楚說明何時該使用技能；請改用任務本身會出現的詞語撰寫 description。第三，資料夾可能不在 `~/.hermes/skills/` 中，因此 Hermes 找不到。請注意，`--toolsets skills` 旗標會限制測試使用的工具集：它可以顯示代理程式如何遵循指示，但不會檢查技能的相依項目，例如外部程式。 在終端機中執行 `hermes skills list`，即可查看目前安裝的項目。 ## 如何更新和移除技能？
重點 `hermes skills check` 會顯示已安裝的技能是否在來源端有更新；`hermes skills update` 會下載新版本；`hermes skills uninstall name` 則會移除技能。更新時，Hermes 會保留你對別人技能所做的修改，並略過已變更的檔案。若要還原原始版本，hub 技能請使用 `hermes skills update name --force`；內建技能請使用 `hermes skills reset name --restore`。
```bash hermes skills check # 來源中的變更內容 hermes skills update # 下載新版本 hermes skills uninstall pdf # 從 hub 移除技能 ``` 若要移除手動建立的技能，請刪除 `~/.hermes/skills/` 中對應的資料夾。如果你自訂了別人的技能，`update` 會保留現有內容：Hermes 會比較雜湊值，並略過已變更的檔案，以免覆寫你的修改。若要還原 hub 技能的原始版本，請使用 `hermes skills update name --force`；若要還原內建技能，請使用 `hermes skills reset name --restore`。這兩個命令都會覆寫你的修改，請先儲存自己的版本。 如果你不需要內建技能，而且它們讓清單變得雜亂，可以執行 `hermes skills opt-out`，讓更新時不再加入內建技能。`opt-out --remove` 命令也會移除你尚未修改的內建技能。 ## 技能無法安裝或運作時該怎麼辦？
重點 最常見的三個問題是：GitHub 每小時 60 次的請求限制、安全檢查封鎖安裝，以及檔案放錯資料夾。遇到速率限制時，請加入 `GITHUB_TOKEN`。檢查封鎖安裝時，請閱讀判定結果。Hermes 找不到技能時，請確認技能是否位於 `~/.hermes/skills/`。
| 症狀 | 原因 | 處理方式 | |----|----|----| | 搜尋或安裝時出現速率限制錯誤 | 未使用權杖時，GitHub 每小時最多允許 60 次請求 | 將 `GITHUB_TOKEN` 加入 `~/.hermes/.env` | | 安裝遭到封鎖 | 檢查發現技能程式碼存在風險 | 閱讀安裝時顯示的檢查結果；若要重新檢查已安裝的技能，請執行 `hermes skills audit`。如果是警告，可以使用 `--force` 繼續；如果判定為「危險」，則無法繼續 | | 技能已安裝，但 `/name` 無法使用 | 名稱不相符或資料夾位置錯誤 | 執行 `hermes skills list`，並檢查 `~/.hermes/skills/` 資料夾 | | 技能甚至沒有出現在清單中 | SKILL.md 限制了平台或必要工具 | 開啟 SKILL.md，檢查 `platforms` 和 `requires_*` 欄位 | | 更新後沒有取得新版本 | 你在本機修改了檔案，而 Hermes 會保留修改 | 如果需要原始版本，hub 技能請使用 `update name --force`，內建技能請使用 `reset --restore`；如果你認為自己的版本更重要，則不必處理 | | 其他儲存庫中的技能無法載入 | 必須將該儲存庫標記為受信任 | 在該儲存庫中執行 `hermes skills trust` | Hermes 會從 Git 儲存庫內的 `.hermes/skills/` 和 `.agents/skills/` 資料夾尋找技能。載入前，你必須將儲存庫標記為受信任，因為這些檔案包含代理程式會遵循的指示。完成後，來自該儲存庫的技能只會在該儲存庫中運作，並接受相同的安全檢查。將儲存庫標記為受信任只需執行一次。 ## 第一步該做什麼？
重點 先從目錄安裝一項現成技能，只需一個命令。接著，將你反覆使用的指示交給 `/learn`，再用工作中的實際任務檢查結果。
接下來可閱讀[如何將 Hermes Agent 連線到 Telegram](https://ailoot.ai/blog/zh-hant-tw/hermes-agent-telegram-setup/)，以便從手機呼叫技能；如果你想安排定時技能，也可閱讀[如何讓代理程式在伺服器上全天候執行](https://ailoot.ai/blog/zh-hant-tw/hermes-agent-vps-24-7/)。若你正在選擇代理程式，請參閱[OpenClaw 或 Hermes Agent](https://ailoot.ai/blog/zh-hant-tw/openclaw-vs-hermes-agent/)比較。
### 來源 - [Hermes Agent 文件](https://hermes-agent.nousresearch.com/docs/) - [Skills System - 技能的運作方式](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills) - [Creating Skills - 如何撰寫自己的技能](https://hermes-agent.nousresearch.com/docs/developer-guide/creating-skills) - [內建技能目錄](https://hermes-agent.nousresearch.com/docs/reference/skills-catalog) - [官方選用技能](https://hermes-agent.nousresearch.com/docs/reference/optional-skills-catalog) - [Hermes Agent 的 GitHub 儲存庫](https://github.com/NousResearch/hermes-agent) - [Open Agent Skills 標準](https://agentskills.io/specification)
你可以前往 [ailoot.ai](https://ailoot.ai/) 繼續探索 Ailoot。
## 常見問題：Hermes Agent 技能：安裝技能與建立自己的技能 ### 已安裝 skill 為什麼沒有斜線指令？ 查已安裝清單、SKILL.md 檔名及 name、目前 profile 的 skills 目錄。平台、必要工具或儲存庫信任限制也可能阻止載入。 ### 有限 skills smoke-test 會驗證全部相依嗎？ 不會。skills-only 測是否載入遵循指示；必要工具、程式及金鑰另查，再驗證一次有界真實成果，才用完整流程。 ## Ailoot · 公司及其專案組合 Ailoot以累積的營運經驗、廣大的客戶群、穩定的服務及持續的KPI管理為基礎。 公司及其專案組合：數百萬客戶，每月銷售額達數十億。 Ailoot將這些營運經驗用於API存取，讓客戶的產品、代理、應用程式及自動化流程使用AI功能。