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

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

如果說：

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

那么：

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

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

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

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

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

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

它解決的問題是：

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

于是 Hermes 采用了技能機(jī)制：

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

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

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

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

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

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

SKILL.md 是核心。

它一般包含：

• frontmatter
• 使用條件
• 操作步驟
• 常見坑
• 驗(yàn)證方法

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. 在需要時(shí)通過 skill_view 加載完整內(nèi)容

3.3 技能的“按需加載”

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

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

這種設(shè)計(jì)的價(jià)值非常大：

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

4. Skills 的運(yùn)行方式

4.1 Skill 可以像 slash command 一樣使用

例如：

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

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

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

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

4.3 Skill 可以有條件顯示

文檔明確支持：

• platforms
• fallback_for_toolsets
• requires_toolsets
• fallback_for_tools
• requires_tools

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

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

tools/skills_hub.py 和 hermes_cli/skills_hub.py 說明 Hermes 還做了一個(gè)更進(jìn)一步的事情：

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

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

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

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

5.1 為什么這很重要

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

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

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

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

這是很多人第一次看倉庫時(shí)最容易混淆的點(diǎn)。

Skill

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

Plugin

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

所以：

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

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

關(guān)鍵文件：

• hermes_cli/plugins.py

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

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

7.1 一個(gè)插件需要什么

目錄型插件至少要有：

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

7.2 插件能做什么

從 PluginContext 看，插件至少可以：

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

這意味著插件能力很強(qiáng)，幾乎能插進(jìn)系統(tǒng)多個(gè)層面。

8. Plugin Hooks：生命周期插點(diǎn)

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

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

8.1 這帶來的價(jià)值

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

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

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

9. Memory Plugins：插件體系中的一個(gè)重點(diǎn)方向

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è)計(jì)：

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

9.4 說明了什么

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

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

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

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

因?yàn)樗鼪Q定了：

• Hermes 能否脫離本地終端使用
• Hermes 能否成為常駐機(jī)器人
• 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 運(yùn)行
  -> 流式狀態(tài)/工具進(jìn)度/審批/提問回調(diào)
  -> 平臺適配器格式化出站消息

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

因?yàn)樗皇且粋€(gè)單純 webhook 層，而是同時(shí)要處理：

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

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

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

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

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

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

然后每個(gè)平臺單獨(dú)實(shí)現(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 其實(shí)已經(jīng)是一個(gè)“多協(xié)議消息操作系統(tǒng)”了。

14. Gateway 的核心價(jià)值

14.1 脫離本地終端

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

可以：

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

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

CLI 更像前臺工具。

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

14.3 讓 cron、send_message、memory 真正有價(jià)值

因?yàn)橹挥?Gateway 在，下面這些能力才真正形成閉環(huán)：

• 定時(shí)任務(wù)完成后發(fā)消息
• 后臺進(jìn)程完成后通知
• 多渠道 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)該增加什么能力和擴(kuò)展點(diǎn)？”

Gateway

回答：

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

它們分別處在三個(gè)不同層：

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

17. 這三個(gè)系統(tǒng)的優(yōu)點(diǎn)

Skills 的優(yōu)點(diǎn)

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

Plugins 的優(yōu)點(diǎn)

• 可編程擴(kuò)展強(qiáng)
• 能注冊工具和 hooks
• 適合深度定制

Gateway 的優(yōu)點(diǎn)

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

18. 這三個(gè)系統(tǒng)的風(fēng)險(xiǎn)點(diǎn)

Skills 的風(fēng)險(xiǎn)

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

Plugins 的風(fēng)險(xiǎn)

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

Gateway 的風(fēng)險(xiǎn)

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

19. 我的結(jié)論

Hermes Agent 的強(qiáng)大，不只是因?yàn)樗泻芏喙ぞ?，而是因?yàn)樗瑫r(shí)做對了三件更難的事情：

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

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

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

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

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

最新評論