今天是深度使用Hermes Agent的第三天,结论依然不变:
Hermes是OpenClaw🦞的“高替”,用惯了Hermes Agent,就回不去龙虾了...
承接昨天的文章,继续贴出更多官方文档汉化内容~ 今天是Hermes Agent最重要的会自我进化的Skills系统! (更多内容请访问我建的Hermes Agent汉化站: https://hermes-doc.aigc.green/getting-started/quickstart )
目录结构
Hermes Agent首次安装完成之后的目录结构大致如下:
~/.hermes/├── .env├── config.yaml├── SOUL.md├── hermes-agent/├── skills/├── memories/├── sessions/├── logs/└── ...其他运行目录
Hermes Agent会在安装过程中将全部源代码都拉入 /hermes-agent/ 目录中,运行环境及工作代码都在这个目录里;剩下的 /skills, /sessions/, memories/, SOUL.md等文件,熟悉OpenClaw的同学一看就笑了,这不就是OpenClaw的workspace么 没错,默认状态下,/.hermes/ 这个根目录就是Hermes Agent的workspace,等效于OpenClaw的 /.openclaw/workspace/ ;只有在多Agents情况下,Hermes才会多出一个 /.hermes/profiles/ 目录来作为其他agents的workspace。
技能系统 Skills
Skills是Agent在需要时可以加载的知识和行动文档。它们遵循渐进式披露模式,以最小化令牌使用量,并且兼容 agentskills.io 开放标准(Claude Code、Codex等Coding Agent都使用的skills标准语法)。
所有技能都位于 ~/.hermes/skills/ —— 这是主目录和唯一可信源。在全新安装时,捆绑的技能会从代码仓库复制到此目录。从hub安装的以及代理创建的技能也会放在这里。代理可以修改或删除任何技能。
你也可以将 Hermes 指向外部技能目录——这些是除了本地目录外还会被扫描的额外文件夹。请参阅后面的外部技能目录。
使用技能
每个已安装的技能都会自动作为一个斜杠命令可用:
## 在 CLI 或任何消息平台中:/gif-search funny cats/axolotl help me fine-tune Llama 3 on my dataset/github-pr-workflow create a PR for the auth refactor/plan design a rollout for migrating our auth provider# 仅输入技能名称会加载它,并让代理询问你的需求:/excalidraw
捆绑的 plan 技能是一个很好的例子,它是一个具有自定义行为的、由技能支持的斜杠命令。运行 /plan [请求] 会指示 Hermes 在需要时检查上下文,编写一个 Markdown 实施计划而不是执行任务,并将结果保存在相对于活动工作空间/后端工作目录的 .hermes/plans/ 下。
你也可以通过自然对话与技能交互:
hermes chat --toolsets skills -q "你有什么技能?"hermes chat --toolsets skills -q "给我看看 axolotl 技能"
渐进式披露
技能使用一种节省令牌的加载模式:
Level 0: skills_list() → [{name, description, category}, ...] (~3k tokens)Level 1: skill_view(name) → 完整内容 + 元数据 (可变)Level 2: skill_view(name, path) → 特定的参考文件 (可变)
代理只在真正需要时才加载完整的技能内容。
SKILL.md 格式
---name: my-skilldescription: 此技能功能的简要描述version: 1.0.0platforms: [macos, linux] # 可选——限制在特定的操作系统平台metadata: hermes: tags: [python, automation] category: devops fallback_for_toolsets: [web] # 可选——条件激活(见下文) requires_toolsets: [terminal] # 可选——条件激活(见下文)---# 技能标题## 何时使用此技能的触发条件。## 步骤1. 第一步2. 第二步## 常见问题- 已知的失败模式及修复方法## 验证如何确认它已成功。
平台特定技能
技能可以使用 platforms 字段限制自己只在特定的操作系统上运行:
| 值 | 匹配 |
|---|---|
macos |
macOS (Darwin) |
linux |
Linux |
windows |
Windows |
platforms: [macos] # 仅 macOS (例如,iMessage, Apple Reminders, FindMy)platforms: [macos, linux] # macOS 和 Linux
当设置此字段时,技能会在不兼容的平台上自动从系统提示、skills_list() 和斜杠命令中隐藏。如果省略,技能将在所有平台上加载。
条件激活(备用技能)
技能可以根据当前会话中可用的工具自动显示或隐藏自己。这对于备用技能最为有用——这些是免费或本地的替代方案,应该只在高级工具不可用时才出现。
metadata: hermes: fallback_for_toolsets: [web] # 仅当这些工具集不可用时显示 requires_toolsets: [terminal] # 仅当这些工具集可用时显示 fallback_for_tools: [web_search] # 仅当这些特定工具不可用时显示 requires_tools: [terminal] # 仅当这些特定工具可用时显示
| 字段 | 行为 |
|---|---|
fallback_for_toolsets |
当列出的工具集可用时,技能被隐藏。当它们缺失时显示。 |
fallback_for_tools |
同上,但检查的是单个工具而不是工具集。 |
requires_toolsets |
当列出的工具集不可用时,技能被隐藏。当它们存在时显示。 |
requires_tools |
同上,但检查的是单个工具。 |
示例: 内置的 duckduckgo-search 技能使用了 fallback_for_toolsets: [web]。当你设置了 FIRECRAWL_API_KEY 时,web 工具集可用,代理会使用 web_search —— DuckDuckGo 技能保持隐藏。如果 API 密钥缺失,web 工具集不可用,DuckDuckGo 技能会自动作为备用方案出现。
没有任何条件字段的技能行为与之前完全一样——它们总是显示。
加载时的安全设置
技能可以声明所需的环境变量,而不会从发现列表中消失:
required_environment_variables: - name: TENOR_API_KEY prompt: Tenor API 密钥 help: 从 https://developers.google.com/tenor 获取密钥 required_for: 完整功能
当遇到缺失的值时,Hermes 仅在技能实际在本地 CLI 中加载时才会安全地询问。你可以跳过设置并继续使用该技能。消息界面永远不会在聊天中询问密钥——它们会告诉你在本地使用 hermes setup 或 ~/.hermes/.env。
一旦设置,声明的环境变量会自动传递到 execute_code 和 terminal 沙箱——技能的脚本可以直接使用 $TENOR_API_KEY。对于非技能的环境变量,请使用 terminal.env_passthrough 配置选项。详情请参阅环境变量传递。
技能目录结构
~/.hermes/skills/ # 唯一可信源├── mlops/ # 分类目录│ ├── axolotl/│ │ ├── SKILL.md # 主要说明(必需)│ │ ├── references/ # 附加文档│ │ ├── templates/ # 输出格式│ │ ├── scripts/ # 可从技能调用的辅助脚本│ │ └── assets/ # 补充文件│ └── vllm/│ └── SKILL.md├── devops/│ └── deploy-k8s/ # 代理创建的技能│ ├── SKILL.md│ └── references/├── .hub/ # 技能中心状态│ ├── lock.json│ ├── quarantine/│ └── audit.log└── .bundled_manifest # 跟踪已植入的捆绑技能
外部技能目录
如果你在 Hermes 之外维护技能——例如,一个被多个 AI 工具共享的 ~/.agents/skills/ 目录——你可以告诉 Hermes 也扫描这些目录。
在 ~/.hermes/config.yaml 的 skills 部分下添加 external_dirs:
skills: external_dirs: - ~/.agents/skills - /home/shared/team-skills - ${SKILLS_REPO}/skills
路径支持 ~ 扩展和 ${VAR} 环境变量替换。
工作原理
- • 只读:外部目录仅用于技能发现扫描。当代理创建或编辑技能时,它总是写入
~/.hermes/skills/。 - • 本地优先:如果同一个技能名称同时存在于本地目录和外部目录中,则本地版本优先。
- • 完全集成:外部技能会出现在系统提示索引、
skills_list、skill_view以及/skill-name斜杠命令中——与本地技能没有区别。 - • 不存在的路径会被静默跳过:如果配置的目录不存在,Hermes 会忽略它而不报错。这对于可能并非每台机器上都存在的可选共享目录很有用。
示例
~/.hermes/skills/ # 本地(主目录,读写)├── devops/deploy-k8s/│ └── SKILL.md└── mlops/axolotl/ └── SKILL.md~/.agents/skills/ # 外部(只读,共享)├── my-custom-workflow/│ └── SKILL.md└── team-conventions/ └── SKILL.md
所有四个技能都会出现在你的技能索引中。如果你在本地创建一个名为 my-custom-workflow 的新技能,它会覆盖外部版本。
Agent管理的技能 (skill_manage 工具) -- Hermes最重要能力
Agent可以通过 skill_manage 工具创建、更新和删除自己的技能。这是代理的程序性记忆(Procedural Memory)——当它弄清楚一个非平凡的工作流程时,它会将该方法保存为一个技能以供将来重用。
代理何时创建技能
- • 成功完成复杂任务(5 次以上工具调用)后
- • 当它遇到错误或死胡同并找到可行路径时
- • 当用户纠正其方法时
- • 当它发现一个非平凡的工作流程时
操作
| 操作 | 用途 | 关键参数 |
|---|---|---|
create |
从头创建新技能 | name, content (完整的 SKILL.md),可选的 category |
patch |
针对性修复(推荐) | name, old_string, new_string |
edit |
主要结构重写 | name, content (完整的 SKILL.md 替换) |
delete |
完全移除技能 | name |
write_file |
添加/更新支持文件 | name, file_path, file_content |
remove_file |
移除支持文件 | name, file_path |
Tip
patch操作是推荐的更新方式——它比edit更节省令牌,因为只有更改的文本会出现在工具调用中。
技能中心
从官方official、skills.sh、直接已知技能端点以及官方可选技能中浏览、搜索、安装和管理技能。
常用命令
hermes skills browse # 浏览所有中心技能(官方优先)hermes skills browse --source official # 仅浏览官方可选技能hermes skills search kubernetes # 搜索所有来源hermes skills search react --source skills-sh # 搜索 skills.sh 目录hermes skills search https://mintlify.com/docs --source well-knownhermes skills inspect openai/skills/k8s # 安装前预览hermes skills install openai/skills/k8s # 安装并进行安全扫描hermes skills install official/security/1passwordhermes skills install skills-sh/vercel-labs/json-render/json-render-react --forcehermes skills install well-known:https://mintlify.com/docs/.well-known/skills/mintlifyhermes skills list --source hub # 列出从中心安装的技能hermes skills check # 检查已安装的中心技能是否有上游更新hermes skills update # 在需要时重新安装有上游更改的中心技能hermes skills audit # 重新扫描所有中心技能的安全性hermes skills uninstall k8s # 移除一个中心技能hermes skills publish skills/my-skill --to github --repo owner/repohermes skills snapshot export setup.json # 导出技能配置hermes skills tap add myorg/skills-repo # 添加自定义 GitHub 源
支持的技能中心来源
| 来源 | 示例 | 说明 |
|---|---|---|
official |
official/security/1password |
随 Hermes 分发的可选技能。 |
skills-sh |
skills-sh/vercel-labs/agent-skills/vercel-react-best-practices |
可通过 hermes skills search <query> --source skills-sh 搜索。当 skills.sh 的别名与仓库文件夹不同时,Hermes 会解析别名风格的技能。 |
well-known |
well-known:https://mintlify.com/docs/.well-known/skills/mintlify |
直接从网站的 /.well-known/skills/index.json 提供的技能。使用网站或文档 URL 进行搜索。 |
github |
openai/skills/k8s |
直接 GitHub 仓库/路径安装和自定义源。 |
clawhub, lobehub, claude-marketplace |
特定来源的标识符 | 社区或市场集成。 |
集成的中心和注册中心
Hermes 目前集成了以下技能生态系统和发现来源:
1. 官方可选技能 (official)
这些技能在 Hermes 仓库内部维护,安装时自带信任度。
- • 目录:官方可选技能目录
- • 仓库内源位置:
optional-skills/ - • 示例:
hermes skills browse --source officialhermes skills install official/security/1password
2. skills.sh (skills-sh)
这是 Vercel 的公共技能目录。Hermes 可以直接搜索它,查看技能详情页面,解析别名形式的短名称,并从底层的源码仓库安装。
- • 目录:skills.sh
- • CLI/工具仓库:vercel-labs/skills
- • 官方 Vercel 技能仓库:vercel-labs/agent-skills
- • 示例:
hermes skills search react --source skills-shhermes skills inspect skills-sh/vercel-labs/json-render/json-render-reacthermes skills install skills-sh/vercel-labs/json-render/json-render-react --force
3. 知名技能端点 (well-known)
这是基于 URL 的发现方式,从发布 /.well-known/skills/index.json 的网站获取。它不是单一的中心化枢纽,而是网络发现约定。
- • 实时端点示例:Mintlify 文档技能索引
- • 参考服务器实现:vercel-labs/skills-handler
- • 示例:
hermes skills search https://mintlify.com/docs --source well-knownhermes skills inspect well-known:https://mintlify.com/docs/.well-known/skills/mintlifyhermes skills install well-known:https://mintlify.com/docs/.well-known/skills/mintlify
4. 直接 GitHub 技能 (github)
Hermes 可以直接从 GitHub 仓库和基于 GitHub 的 taps 安装。当你已经知道仓库/路径或者想添加自己的自定义源仓库时,这很有用。
默认 taps(无需设置即可浏览):
- • openai/skills
- • anthropics/skills
- • VoltAgent/awesome-agent-skills
- • garrytan/gstack
- • 示例:
hermes skills install openai/skills/k8shermes skills tap add myorg/skills-repo
5. ClawHub (clawhub)
一个作为社区源集成的第三方技能市场。
- • 站点:clawhub.ai
- • Hermes 源标识:
clawhub
6. Claude 市场风格仓库 (claude-marketplace)
Hermes 支持发布 Claude 兼容的插件/市场清单的市场仓库。
已知的集成源包括:
- • anthropics/skills
- • aiskillstore/marketplace
Hermes 源标识:claude-marketplace
7. LobeHub (lobehub)
Hermes 可以从 LobeHub 的公共目录中搜索并转换智能体条目为可安装的 Hermes 技能。
- • 站点:LobeHub
- • 公共智能体索引:chat-agents.lobehub.com
- • 支撑仓库:lobehub/lobe-chat-agents
- • Hermes 源标识:
lobehub
安全扫描与 --force
所有通过 hub 安装的技能都会经过一个安全扫描器的检查,它会检测数据窃取、提示注入、破坏性命令、供应链信号和其他威胁。
hermes skills inspect ... 现在也会在有可用信息时展示上游元数据:
- • 仓库 URL
- • skills.sh 详情页面 URL
- • 安装命令
- • 每周安装次数
- • 上游安全审计状态
- • 知名索引/端点 URL
当你已经审查了一个第三方技能并想覆盖一个非危险的政策阻止时,请使用 --force:
hermes skills install skills-sh/anthropics/skills/pdf --force
重要行为:
- •
--force可以覆盖针对谨慎/警告类发现的政策阻止。 - •
--force不会覆盖dangerous扫描裁决。 - • 官方可选技能 (
official/...) 被视为自带信任,不会显示第三方警告面板。
信任级别
| 级别 | 来源 | 策略 |
|---|---|---|
builtin |
Hermes 自带 | 始终信任 |
official |
仓库内的 optional-skills/ |
自带信任,无第三方警告 |
trusted |
受信任的注册表/仓库,例如 openai/skills, anthropics/skills |
比社区源更宽松的策略 |
community |
其他一切 (skills.sh, 知名端点, 自定义 GitHub 仓库, 大多数市场) |
非危险发现可以用 --force 覆盖;dangerous 裁决保持阻止 |
更新生命周期
hub 现在会追踪足够的来源信息,以重新检查已安装技能的在线副本:
hermes skills check # 报告哪些已安装的 hub 技能在上游发生了变化hermes skills update # 仅重新安装有可用更新的技能hermes skills update react # 更新一个特定的已安装 hub 技能
这使用了存储的源标识加上当前上游 bundle 内容哈希来检测变更。
斜杠命令(在聊天中)
所有相同的命令都可以通过 /skills 使用:
/skills browse/skills search react --source skills-sh/skills search https://mintlify.com/docs --source well-known/skills inspect skills-sh/vercel-labs/json-render/json-render-react/skills install openai/skills/skill-creator --force/skills check/skills update/skills list
官方可选技能仍然使用像
official/security/1password和official/migration/openclaw-migration这样的标识符。
内置技能目录
Hermes 附带一个庞大的内置技能库,安装时会复制到 ~/.hermes/skills/ 目录下。本页面记录了位于仓库 skills/ 目录下的内置技能。
apple
Apple/macOS 专属技能 —— iMessage、提醒事项、备忘录、查找以及 macOS 自动化。这些技能仅在 macOS 系统上加载。
| 技能 | 描述 | 路径 |
|---|---|---|
apple-notes |
通过 macOS 上的 memo CLI 管理 Apple 备忘录(创建、查看、搜索、编辑)。 | apple/apple-notes |
apple-reminders |
通过 remindctl CLI 管理 Apple 提醒事项(列出、添加、完成、删除)。 | apple/apple-reminders |
findmy |
通过 AppleScript 和屏幕截图,在 macOS 上使用 FindMy.app 追踪 Apple 设备和 AirTag。 | apple/findmy |
imessage |
通过 macOS 上的 imsg CLI 发送和接收 iMessage/短信。 | apple/imessage |
autonomous-ai-agents
用于启动和编排自主 AI 编程智能体及多智能体工作流的技能 —— 运行独立的智能体进程、委派任务、协调并行工作流。
| 技能 | 描述 | 路径 |
|---|---|---|
claude-code |
将编码任务委派给 Claude Code(Anthropic 的 CLI 智能体)。用于构建功能、重构、PR 审查和迭代式编码。需要安装 claude CLI。 | autonomous-ai-agents/claude-code |
codex |
将编码任务委派给 OpenAI Codex CLI 智能体。用于构建功能、重构、PR 审查和批量问题修复。需要安装 codex CLI 和一个 git 仓库。 | autonomous-ai-agents/codex |
hermes-agent-spawning |
将额外的 Hermes Agent 实例作为自主子进程启动,用于独立的长期运行任务。支持非交互式单次运行模式 (-q) 和用于多轮协作的交互式 PTY 模式。与 delegate_task 不同 —— 这会运行一个完全独立的 hermes 进程。 | autonomous-ai-agents/hermes-agent |
opencode |
将编码任务委派给 OpenCode CLI 智能体,用于功能实现、重构、PR 审查和长期运行的自主会话。需要安装并认证 opencode CLI。 | autonomous-ai-agents/opencode |
data-science
用于数据科学工作流的技能 —— 交互式探索、Jupyter 笔记本、数据分析和可视化。
| 技能 | 描述 | 路径 |
|---|---|---|
jupyter-live-kernel |
通过 hamelnb 使用实时 Jupyter 内核进行有状态的、迭代式的 Python 执行。当任务涉及探索、迭代或检查中间结果时加载此技能。 | data-science/jupyter-live-kernel |
creative
创意内容生成 —— ASCII 艺术、手绘风格图表和视觉设计工具。
| 技能 | 描述 | 路径 |
|---|---|---|
ascii-art |
使用 pyfiglet(571 种字体)、cowsay、boxes、toilet、image-to-ascii、远程 API(asciified, ascii.co.uk)和 LLM 后备方案生成 ASCII 艺术。无需 API 密钥。 | creative/ascii-art |
ascii-video |
"ASCII 艺术视频的生产管线 —— 支持任何格式。将视频/音频/图像/生成式输入转换为彩色 ASCII 字符视频输出(MP4、GIF、图像序列)。… |