Hermes Agent 的 Skills、Plugins、Gateway 深度解析

1. 為什么要單獨分析這三個系統(tǒng)

如果說：

• run_agent.py 是“Agent 大腦主循環(huán)”
• tools/ 是“執(zhí)行能力層”

那么：

• skills/ 是“可復(fù)用經(jīng)驗層”
• plugins/ 是“擴展機制層”
• gateway/ 是“外部接入層”

這三者決定了 Hermes Agent 為什么不是一個封閉單體，而是一個可以持續(xù)擴展、接入多生態(tài)、多平臺、多工作流的系統(tǒng)。

2. Skills 系統(tǒng)：它本質(zhì)上是什么

Skills 不是 Python 插件，也不是代碼模塊。

它本質(zhì)上是一種：

面向 Agent 的、按需加載的知識文檔/工作流文檔系統(tǒng)。

它解決的問題是：

• 有些能力不需要寫成工具代碼
• 但又不適合每次都把完整說明塞進 system prompt

于是 Hermes 采用了技能機制：

• 平時只給模型一個技能索引
• 需要時再加載具體 skill 內(nèi)容
• skill 可以帶 references、templates、scripts、assets

這就是文檔里所謂的 progressive disclosure。

3. Skills 的核心設(shè)計

3.1 數(shù)據(jù)結(jié)構(gòu)

典型技能目錄結(jié)構(gòu)：

<skill-name>/
  SKILL.md
  references/
  templates/
  scripts/
  assets/

SKILL.md 是核心。

它一般包含：

• frontmatter
• 使用條件
• 操作步驟
• 常見坑
• 驗證方法

3.2 技能發(fā)現(xiàn)與索引

相關(guān)關(guān)鍵位置：

• agent/skill_commands.py
• agent/skill_utils.py
• tools/skills_tool.py
• tools/skills_hub.py
• hermes_cli/skills_hub.py

工作方式大致是：

1. 掃描本地技能目錄
2. 解析 SKILL.md frontmatter
3. 生成 skill 索引
4. 將 skill 映射為 slash command
5. 在需要時通過 skill_view 加載完整內(nèi)容

3.3 技能的“按需加載”

文檔中給出了 3 層加載模式：

• skills_list()：只看索引
• skill_view(name)：加載某個技能主內(nèi)容
• skill_view(name, path)：加載技能附屬文件

這種設(shè)計的價值非常大：

• 節(jié)省 token
• 降低默認(rèn) system prompt 膨脹
• 讓技能數(shù)量可以擴展得很大

4. Skills 的運行方式

4.1 Skill 可以像 slash command 一樣使用

例如：

• /plan
• /github-pr-workflow
• /gif-search

說明 skill 在用戶感知層像“命令”，但底層其實是文檔型能力加載。

4.2 Skill 也可以在自然對話中被調(diào)用

這說明 skill 不是強依賴顯式 slash command 的，而是 Agent 可主動發(fā)現(xiàn)和裝載。

4.3 Skill 可以有條件顯示

文檔明確支持：

• platforms
• fallback_for_toolsets
• requires_toolsets
• fallback_for_tools
• requires_tools

這意味著 skill 系統(tǒng)已經(jīng)不是簡單文件夾掃描，而是具備運行時條件裝配能力。

5. Skills Hub：技能生態(tài)層

tools/skills_hub.py 和 hermes_cli/skills_hub.py 說明 Hermes 還做了一個更進一步的事情：

把 skills 做成可安裝、可搜索、可審計、可隔離來源的生態(tài)系統(tǒng)。

它支持的內(nèi)容包括：

• 官方 optional skills
• GitHub skill source
• lock file
• quarantine
• audit log
• taps
• index cache

這已經(jīng)非常接近包管理器思路。

5.1 為什么這很重要

因為 skill 一旦規(guī)模變大，用戶就不可能只靠倉庫自帶內(nèi)容：

• 需要外部來源
• 需要 provenance
• 需要審計
• 需要緩存
• 需要信任等級

Hermes 已經(jīng)顯式意識到了這一點。

6. Plugins 系統(tǒng)：它和 Skills 的區(qū)別

這是很多人第一次看倉庫時最容易混淆的點。

Skill

• 更偏知識/流程
• 通常是 Markdown + 附屬文件
• 給 Agent 提示和流程指導(dǎo)
• 不直接修改 Hermes 核心執(zhí)行邏輯

Plugin

• 是真正的程序級擴展
• 能注冊 hook
• 能注冊 tool
• 能注冊 CLI 子命令
• 能注冊 slash command
• 甚至能替換 context engine

所以：

Skill 是“給模型看的能力文檔”，Plugin 是“給系統(tǒng)加能力的代碼擴展”。

7. Plugins 系統(tǒng)怎么工作

關(guān)鍵文件：

• hermes_cli/plugins.py

它明確寫了三種插件來源：

1. 用戶插件
   • ~/.hermes/plugins/<name>/
2. 項目插件
   • ./.hermes/plugins/<name>/
3. pip entrypoint 插件
   • hermes_agent.plugins

7.1 一個插件需要什么

目錄型插件至少要有：

• plugin.yaml
• __init__.py
• register(ctx) 函數(shù)

7.2 插件能做什么

從 PluginContext 看，插件至少可以：

• register_tool(...)
• register_cli_command(...)
• register_command(...)
• dispatch_tool(...)
• inject_message(...)
• register_context_engine(...)

這意味著插件能力很強，幾乎能插進系統(tǒng)多個層面。

8. Plugin Hooks：生命周期插點

VALID_HOOKS 目前包括：

• pre_tool_call
• post_tool_call
• pre_llm_call
• post_llm_call
• pre_api_request
• post_api_request
• on_session_start
• on_session_end
• on_session_finalize
• on_session_reset

這說明插件機制不是“只支持加載工具”，而是真正支持生命周期擴展。

8.1 這帶來的價值

• 可以監(jiān)控工具調(diào)用
• 可以附加上下文
• 可以做審計
• 可以做自定義日志/遙測
• 可以做會話前后處理

8.2 這也帶來風(fēng)險

• Hook 太強，調(diào)試復(fù)雜度會上升
• 插件之間可能發(fā)生行為沖突
• 對時序的依賴會增大

9. Memory Plugins：插件體系中的一個重點方向

plugins/memory/ 說明 Hermes 已經(jīng)把“記憶后端”做成插件化能力。

當(dāng)前可見的 memory plugin 包括：

• honcho
• supermemory
• holographic
• mem0
• openviking
• retaindb
• hindsight
• byterover

9.1 Honcho

從 plugins/memory/honcho/README.md 看，Honcho 是高度 AI-native 的記憶后端：

• 雙層上下文注入
• dialectic reasoning
• session summary
• user / AI peer model
• cadence 控制

它已經(jīng)不是簡單 KV memory，而是偏用戶建模系統(tǒng)。

9.2 Supermemory

偏語義記憶服務(wù)：

• semantic search
• profile recall
• explicit memory tools
• session-end ingest

9.3 Holographic

偏本地知識庫型設(shè)計：

• SQLite
• FTS5
• trust scoring
• entity resolution
• HRR retrieval

9.4 說明了什么

這說明 Hermes 的 memory 層不是“寫死一個實現(xiàn)”，而是把記憶視為可插拔基礎(chǔ)設(shè)施。

這是非常平臺化的設(shè)計思路。

10. Gateway 系統(tǒng)：為什么它是 Hermes 的第二核心

如果不算 run_agent.py，我認(rèn)為倉庫里第二重要的系統(tǒng)就是 gateway/。

因為它決定了：

• Hermes 能否脫離本地終端使用
• Hermes 能否成為常駐機器人
• Hermes 能否跨平臺連續(xù)對話
• Hermes 能否把 cron、memory、tool、session 這些能力帶到外部世界

11. Gateway 的基本結(jié)構(gòu)

關(guān)鍵文件：

• gateway/run.py
• gateway/config.py
• gateway/session.py
• gateway/delivery.py
• gateway/platforms/base.py
• gateway/platforms/*.py

工作流大致是：

平臺消息入站
  -> 平臺適配器解析 event
  -> gateway session 解析/構(gòu)建 session_key
  -> 構(gòu)造 AIAgent 或復(fù)用會話上下文
  -> AIAgent 運行
  -> 流式狀態(tài)/工具進度/審批/提問回調(diào)
  -> 平臺適配器格式化出站消息

12. Gateway 為什么復(fù)雜

因為它不是一個單純 webhook 層，而是同時要處理：

• 多平臺差異
• 會話邊界
• 多用戶/群組/線程
• 中斷和排隊
• 背景進程通知
• 語音/圖片/附件
• 審批流
• session routing
• restart/drain
• platform reconnect

所以 tests/gateway/ 數(shù)量非常多是合理的。

13. 平臺適配器設(shè)計

gateway/platforms/base.py 是所有平臺適配器的基類。

它提供的典型基礎(chǔ)能力包括：

• 消息截斷/編碼長度處理
• 代理/網(wǎng)絡(luò)處理
• 平臺共通發(fā)送接口抽象
• 背景消息與媒體處理輔助

然后每個平臺單獨實現(xiàn)自己的協(xié)議細(xì)節(jié)。

當(dāng)前可見平臺包括：

• Telegram
• Discord
• Slack
• WhatsApp
• Signal
• Matrix
• Mattermost
• Email
• Dingtalk
• Feishu
• WeCom
• Weixin
• webhook
• Home Assistant
• API server

這說明 Gateway 其實已經(jīng)是一個“多協(xié)議消息操作系統(tǒng)”了。

14. Gateway 的核心價值

14.1 脫離本地終端

你不需要開著終端守著 Hermes。

可以：

• 在 Telegram 上問它
• 在 Discord 上繼續(xù)同一個 Agent
• 讓它在遠(yuǎn)程機器上工作

14.2 將 Agent 變成“常駐服務(wù)”

CLI 更像前臺工具。

Gateway 更像服務(wù)形態(tài)。

14.3 讓 cron、send_message、memory 真正有價值

因為只有 Gateway 在，下面這些能力才真正形成閉環(huán)：

• 定時任務(wù)完成后發(fā)消息
• 后臺進程完成后通知
• 多渠道 home channel
• session continuity

15. API Server 也是 Gateway 體系的一部分

gateway/platforms/api_server.py 特別值得注意。

它讓 Hermes 可以對外表現(xiàn)成：

• OpenAI Chat Completions API
• OpenAI Responses API

作用非常大：

• Open WebUI、LobeChat、LibreChat 等前端可以直接接入
• 第三方工具可以把 Hermes 當(dāng)成“兼容 OpenAI 的 Agent Server”

這相當(dāng)于把 Hermes 從“應(yīng)用”變成“服務(wù)接口”。

16. Skills、Plugins、Gateway 三者的關(guān)系

可以這樣理解：

Skills

回答：

“Agent 應(yīng)該知道怎么做這件事嗎？”

Plugins

回答：

“系統(tǒng)本身應(yīng)該增加什么能力和擴展點？”

Gateway

回答：

“用戶和外部平臺怎樣連接到這個 Agent？”

它們分別處在三個不同層：

• Skills：知識層
• Plugins：系統(tǒng)擴展層
• Gateway：交互接入層

17. 這三個系統(tǒng)的優(yōu)點

Skills 的優(yōu)點

• 低成本擴展能力
• 適合沉淀經(jīng)驗
• token 更經(jīng)濟
• 易于社區(qū)共享

Plugins 的優(yōu)點

• 可編程擴展強
• 能注冊工具和 hooks
• 適合深度定制

Gateway 的優(yōu)點

• 讓 Hermes 真正成為多平臺 Agent
• 支持長期運行和遠(yuǎn)程交互
• 把消息、自動化、通知、會話串聯(lián)起來

18. 這三個系統(tǒng)的風(fēng)險點

Skills 的風(fēng)險

• skill 質(zhì)量不均
• 文檔可能過時
• prompt injection 風(fēng)險
• skill 數(shù)量膨脹后治理困難

Plugins 的風(fēng)險

• hook 沖突
• 調(diào)試復(fù)雜
• 權(quán)限邊界更難控
• 插件加載順序與兼容性問題

Gateway 的風(fēng)險

• 平臺差異巨大
• 行為開關(guān)多
• 并發(fā)和狀態(tài)同步復(fù)雜
• 測試矩陣膨脹

19. 我的結(jié)論

Hermes Agent 的強大，不只是因為它有很多工具，而是因為它同時做對了三件更難的事情：

1. 用 Skills 沉淀“經(jīng)驗和流程”
2. 用 Plugins 暴露“系統(tǒng)擴展點”
3. 用 Gateway 把 Agent 送到“真實交互環(huán)境”

這三個系統(tǒng)疊加，才讓 Hermes 從一個“能調(diào)工具的 LLM 應(yīng)用”，變成一個“可長期演化的 Agent 平臺”。

如果你后續(xù)要二開，這三個方向分別適合：

• 想快速增強業(yè)務(wù)知識：優(yōu)先看 Skills
• 想深度改系統(tǒng)能力：優(yōu)先看 Plugins
• 想做機器人/平臺接入：優(yōu)先看 Gateway

到此這篇關(guān)于Hermes Agent 的 Skills、Plugins、Gateway全解析的文章就介紹到這了,更多相關(guān)Hermes Agent 深度解析內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論