1. 项目概述为什么你需要为Hermes安装技能包如果你正在使用Hermes无论是作为个人AI助手还是团队协作工具你大概率已经体验过它基础对话和任务处理的能力。但你可能也隐隐感觉到它的“出厂设置”似乎有些局限——比如它无法直接读取你电脑上的文件、不能帮你分析GitHub仓库的代码、或者对实时网络信息的获取显得力不从心。这种感觉是对的因为一个“裸奔”的Hermes其核心能力是相对固定的。而“技能包”正是打破这种局限将Hermes从一个通用聊天机器人定制成你专属的超级工作伙伴的关键。简单来说技能包就是为Hermes扩展功能的插件。你可以把它想象成智能手机上的App。手机本身能打电话、发短信但安装了地图App你才能导航安装了文档处理App你才能编辑文件。Hermes的技能包也是如此它们赋予了Hermes与外部世界交互、处理特定格式数据、调用专业API的能力。而skills.sh就是那个帮你一键安装和管理这些“App”的官方应用商店和包管理器。我最初接触Hermes时也满足于它的基础问答。直到有一次我需要它帮我分析一个本地项目目录的结构它却告诉我“我无法直接访问你的文件系统”。那一刻我才意识到它的潜力远未被挖掘。通过搜索社区我发现了skills.sh和丰富的技能包生态从此打开了新世界的大门。现在我的Hermes可以帮我总结PDF报告、监控服务器日志、甚至作为中间件连接不同的SaaS服务。这篇文章就是把我从摸索到熟练的完整过程以及那些官方文档里没写的“坑”和技巧毫无保留地分享给你。无论你是刚部署好Hermes的新手还是想进一步挖掘其潜力的老用户这篇指南都能让你系统地掌握技能包安装与管理的精髓真正实现Hermes能力的“翻倍”。2. 核心概念与准备工作理解技能包的运作机制在开始动手安装之前我们必须先搞清楚几个核心概念。这能帮你避免后续90%的配置错误和理解偏差明白每一步操作背后的逻辑而不是机械地复制命令。2.1 技能包Skill到底是什么一个Hermes技能包本质上是一个遵循特定规范的软件包。它通常包含以下几个核心部分SKILL.md文件这是技能包的“说明书”和“身份证”。它定义了技能的名称、描述、版本、作者以及最重要的——这个技能能做什么能力描述以及Hermes该如何调用它配置说明。很多人在GitHub上寻找的“最好的skill.md提示词”其实就是指那些编写得极其出色、能力描述清晰且 prompts 设计巧妙的技能包定义文件。执行逻辑这可以是任何形式的代码Python脚本、二进制文件、HTTP服务接口等它包含了实现技能功能的具体逻辑。例如一个“天气查询”技能的执行逻辑可能就是一个调用天气API并格式化返回数据的Python函数。配置清单告诉Hermes在运行时需要哪些环境变量、访问哪些目录或网络端口。当Hermes加载一个技能包后它就能理解并执行该技能包SKILL.md中所描述的新指令或任务。例如加载了file-reader技能包后你就可以对Hermes说“请读取/home/user/report.txt文件并总结其内容。”2.2skills.sh官方的技能包管理器skills.sh不是一个神秘的脚本你可以把它理解为Hermes生态的apt-get或brew。它是一个命令行工具主要功能包括浏览与搜索列出官方或社区维护的技能包仓库。安装与卸载一键将技能包下载、解压并配置到Hermes的正确目录。更新与管理检查已安装技能的更新并进行升级。它的工作原理通常是从预设的Git仓库例如官方的hermes-skills仓库拉取技能包的清单和文件然后根据SKILL.md的指引将其部署到Hermes的external_dirs外部目录中。2.3external_dirs技能包的“家”这是Hermes配置中一个至关重要的概念。external_dirs是一个配置项通常在config.yaml或环境变量中指定它告诉Hermes“除了我自身的核心功能请额外扫描这些目录加载里面的技能包。”你可以配置多个external_dirs。常见的设置是一个目录用于存放通过skills.sh安装的官方/社区技能包。另一个目录用于存放你自己开发的或从其他地方获取的私人技能包。这样做的好处是公私分离管理清晰。当你运行skills.sh install skill-name时脚本会自动将技能包安装到指定的external_dirs中并确保Hermes在下次启动时能识别它。注意很多新手遇到的“安装了技能但Hermes不识别”的问题十有八九是external_dirs配置错误或者Hermes服务没有重启以加载新技能。2.4 准备工作检查你的Hermes环境在安装任何技能包之前请先确认以下事项Hermes已正确安装并运行确保你的Hermes客户端或服务正在运行。可以通过hermes --version或访问其Web界面来验证。找到配置文件定位你的Hermes配置文件。这可能是~/.hermes/config.yamlLinux/macOS用户目录下安装目录下的config.yaml通过环境变量HERMES_CONFIG_FILE指定的文件备份配置文件在进行任何修改前养成备份的好习惯。cp ~/.hermes/config.yaml ~/.hermes/config.yaml.backup确认网络连通性skills.sh需要从Git仓库拉取数据确保你的终端可以访问GitHub等代码托管平台。3. 技能包安装全流程详解从搜索到验证掌握了核心概念后我们就可以开始实战了。本章节将带你完整走一遍安装一个技能包的流程我会以安装一个实用的“网页抓取”技能包为例。3.1 第一步探索与发现技能包首先我们需要知道有哪些技能包可用。skills.sh通常提供了搜索和列表功能。列出所有可用技能包./skills.sh list # 或者如果 skills.sh 在系统路径中 skills.sh list这个命令会从远程仓库拉取索引显示所有可安装的技能包名称和简短描述。搜索特定技能包 如果你知道你需要的大致功能比如“文件处理”或“代码分析”可以使用搜索功能。skills.sh search web skills.sh search pdf skills.sh search git搜索结果是模糊匹配的会列出名称或描述中包含关键词的技能包。查看技能包详情 在安装前详细了解一个技能包是明智的。使用info命令可以查看其SKILL.md的内容。skills.sh info web-scraper这个命令会输出该技能的详细描述、使用示例、配置要求以及可能的依赖项。务必仔细阅读这部分特别是“Configuration”和“Requirements”部分这能帮你提前准备好所需的环境。3.2 第二步安装技能包假设我们决定安装web-scraper这个技能包。安装命令非常简单skills.sh install web-scraper这个过程背后skills.sh会执行以下操作从远程仓库下载web-scraper技能包的压缩包或克隆其Git仓库。将其解压/复制到external_dirs指定的目录中通常是~/.hermes/external_skills或类似路径。根据技能包内的配置可能会尝试安装Python依赖如果技能包包含requirements.txt。实操心得安装时最好在终端保持网络稳定。有时安装失败可能是因为网络超时。如果遇到问题可以尝试添加--verbose或-v参数来获取更详细的日志便于排查。skills.sh install web-scraper -v3.3 第三步配置技能包安装完成并不代表立刻能用。大多数技能包都需要进行一些配置。skills.sh info命令的输出会告诉你需要做什么。常见的配置项包括环境变量例如一个需要调用API的技能包会要求你设置API_KEY。# 在你的shell配置文件如 .bashrc, .zshrc中设置或直接在启动Hermes前设置 export WEB_SCRAPER_API_KEYyour_key_here修改Hermes主配置有些技能包可能需要你在Hermes的config.yaml中添加特定的配置块。例如一个需要访问本地数据库的技能包可能会要求你配置数据库连接字符串。# 在 ~/.hermes/config.yaml 中添加 skills: web-scraper: db_path: /path/to/your/data.db rate_limit: 10安装系统级依赖少数技能包可能依赖特定的系统工具如pandoc文档转换、ffmpeg音视频处理。你需要用系统包管理器如apt,brew,yum提前安装好。关键检查点完成配置后再次运行skills.sh info web-scraper确保所有“Requirements”都已满足通常会以 ✅ 或 ❌ 标记。3.4 第四步重启Hermes并验证这是至关重要的一步Hermes通常在启动时加载external_dirs中的技能包。因此安装并配置好技能包后你必须重启Hermes服务或客户端才能使新技能生效。如果Hermes以前台进程运行直接停止当前进程CtrlC然后重新启动它。如果Hermes以系统服务运行例如通过 systemdsudo systemctl restart hermes # 或者 hermes restart重启后如何验证技能包是否加载成功查看Hermes日志启动时Hermes的日志会列出加载的技能包。寻找类似Loaded external skill: web-scraper的信息。journalctl -u hermes -f # 如果使用systemd # 或直接查看Hermes的输出日志在Hermes交互界面中测试直接向Hermes发送该技能包描述中的指令。例如对于网页抓取技能你可以尝试说“使用web-scraper技能抓取 https://example.com 的标题和首段内容。”使用skills.sh检查skills.sh list --installed这个命令会列出所有已安装在本地的技能包确认web-scraper在列表中。4. 高级管理与故障排查成为技能包专家当你熟练掌握了基础安装流程后以下高级技巧和常见问题的解决方案能让你管理技能包更加得心应手。4.1 技能包的管理与维护更新技能包技能包和普通软件一样会修复Bug和增加新功能。定期更新是个好习惯。# 更新所有已安装的技能包 skills.sh update --all # 更新特定技能包 skills.sh update web-scraper注意更新前请务必查看技能包的更新日志如果有因为新版本可能会变更配置方式或引入不兼容的改动。卸载技能包如果你不再需要某个技能可以将其卸载以释放空间并保持环境整洁。skills.sh uninstall web-scraper卸载命令通常会删除external_dirs中对应的技能包目录。但请注意它通常不会删除你手动配置在config.yaml中的相关配置项或设置的环境变量这些需要你手动清理。安装特定版本或从其他源安装有时你可能需要安装旧版本或者想尝试GitHub上某个开发者自建的技能包。# 从特定的Git仓库URL安装这要求该仓库结构符合Hermes技能包规范 skills.sh install https://github.com/username/custom-skill.git # 安装特定版本如果仓库支持标签 skills.sh install https://github.com/username/custom-skill.gitv1.2.04.2 常见问题与解决方案实录以下是我在大量实践中总结的典型问题希望你永远不会遇到但万一遇到了可以在这里快速找到思路。问题现象可能原因排查步骤与解决方案技能包安装失败提示“Download error”或“Clone failed”1. 网络问题无法访问GitHub等源站。2. 技能包名称拼写错误。3. 源仓库已移除或改名。1. 检查网络连接尝试使用ping github.com。2. 使用skills.sh list确认正确的技能包名称。3. 如果从自定义URL安装检查URL是否有效。技能安装成功但Hermes启动时报错提示技能加载失败1. 技能包的SKILL.md格式错误或不符合规范。2. 技能包依赖的Python库或其他运行时缺失。3.external_dirs配置路径权限不足。1. 查看Hermes错误日志定位具体错误信息。2. 进入技能包目录手动检查SKILL.md语法。3. 运行技能包自带的测试脚本或检查requirements.txt手动安装依赖。4. 检查external_dirs目录的读写权限。Hermes重启后无法识别新技能的命令1. Hermes未成功重启或新进程未加载配置。2. 技能包虽然加载但其“能力描述”未正确注册到Hermes的指令系统中。3. 与已有技能或核心指令冲突。1. 确认Hermes进程确实重启了检查进程ID是否变化。2. 查看启动日志确认是否有该技能的加载记录。3. 尝试使用技能包文档中最基础、最简单的示例指令进行测试。4. 检查是否有同名的内置指令或其他技能指令覆盖。技能执行时报错如“ModuleNotFoundError”或“API Key missing”1. 依赖未安装完整。2. 环境变量未正确设置或未生效。3. 技能包需要的配置文件不存在。1. 根据错误信息安装缺失的Python模块pip install module_name。2. 确认环境变量在启动Hermes的同一个shell环境中已设置。对于服务形式运行的Hermes环境变量需要在服务文件如systemd的.service文件中定义。3. 按照skills.sh info的说明创建或修改所需的配置文件。skills.sh命令本身无法执行或报错1.skills.sh脚本没有执行权限。2. 脚本依赖的工具有缺失如git,curl,jq。3. 脚本版本过旧与当前Hermes版本不兼容。1. 添加执行权限chmod x /path/to/skills.sh。2. 根据错误提示安装缺失的系统工具。3. 尝试从Hermes官方仓库重新下载最新版的skills.sh脚本。4.3 实操心得让技能包管理更优雅的私人技巧使用独立的Python虚拟环境如果你安装的很多技能包都是Python写的并且依赖复杂强烈建议为Hermes的技能包创建一个独立的conda或venv虚拟环境。然后在启动Hermes前激活该环境或者将虚拟环境的Python路径配置到Hermes中。这能完美解决不同技能包之间、技能包与系统Python之间的依赖冲突问题。分类管理external_dirs不要把所有技能包都扔进一个目录。我个人的习惯是~/.hermes/skills/official: 存放通过skills.sh安装的官方/社区技能包。~/.hermes/skills/custom: 存放自己编写或从第三方获取的私人技能包。然后在config.yaml中配置external_dirs为这两个目录的列表。这样结构清晰备份和迁移时也方便。技能包配置版本化将你的~/.hermes/config.yaml文件纳入版本控制如Git。这样当你调整技能包配置、添加新技能时所有的变更都有记录可以轻松回滚到可用的状态。从日志开始排查遇到任何技能相关的问题第一时间查看Hermes的日志。日志的详细程度通常可以通过启动参数如--log-level DEBUG来调整。错误信息、堆栈跟踪都藏在日志里这是定位问题最直接的途径。5. 从使用者到创造者探索自定义技能包当你熟练使用各种技能包后很可能会产生一些独特的想法“要是Hermes能帮我做XXX就好了”。这时你就可以考虑创建自己的技能包。这并不像想象中那么困难。5.1 自定义技能包的基本结构一个最简单的自定义技能包可以只是一个包含SKILL.md文件的目录。SKILL.md是核心。以下是一个极简示例# My Echo Skill ## Description 一个简单的回声技能用于测试。它会重复你说的话。 ## Capabilities - 当用户发送以“回声”开头的消息时技能会被触发。 - 技能会移除“回声”前缀并将剩余文本返回给用户。 ## Configuration 无需特殊配置。 ## Example Usage 用户: “回声你好世界” Hermes: “你好世界”你只需要将这个目录例如命名为my-echo-skill放到external_dirs指定的目录中重启Hermes它就能识别这个简单的“指令模式”技能。当然这只是最基础的。更强大的技能需要编写执行逻辑。5.2 为技能包添加执行逻辑通常执行逻辑是一个独立的可执行脚本或一个服务。Hermes会通过进程间通信IPC或HTTP调用它。社区常见的做法是使用Python并遵循一定的接口规范。例如一个简单的Python技能骨架#!/usr/bin/env python3 import sys import json def main(): # Hermes会通过标准输入stdin传递JSON格式的请求数据 request_data json.loads(sys.stdin.read()) user_input request_data.get(input, ) # 你的技能逻辑 if user_input.startswith(回声): response_text user_input[3:] # 移除“回声” else: response_text 未触发技能。 # 将结果以JSON格式输出到标准输出stdout result {response: response_text} print(json.dumps(result)) if __name__ __main__: main()然后在SKILL.md的Configuration部分你需要指明如何调用这个脚本。更复杂的技能可能会涉及长期运行的服务、数据库连接、外部API调用等。5.3 测试与分享你的技能包在将自定义技能包投入生产使用前务必进行充分测试。你可以在本地external_dirs中测试确保它能被Hermes正确加载和触发。如果你觉得自己的技能包对社区有价值可以考虑将其提交到官方的技能包仓库如果开放贡献或者在自己的GitHub上开源并编写清晰的README和SKILL.md。这样其他人就可以通过skills.sh install https://github.com/yourname/your-skill.git来安装你的作品了。通过skills.sh安装和管理技能包是解锁Hermes全部潜力的标准路径。它从探索、安装、配置到验证形成了一套完整的闭环。更重要的是理解其背后的机制——SKILL.md的定义、external_dirs的配置、技能包的加载流程——能让你在遇到问题时游刃有余。从使用现成的技能包到最终动手打造满足自己独特需求的技能这个过程本身也是对智能体架构和功能扩展的一次深刻学习。我的经验是开始时选择一两个最急需的技能入手比如文件阅读或网络搜索在成功应用并获得正反馈后再逐步探索更复杂的技能最终你将拥有一个完全为你量身定制的、能力强大的AI工作伙伴。 Hermes技能包安装与管理全攻略：从基础配置到高级应用
1. 项目概述为什么你需要为Hermes安装技能包如果你正在使用Hermes无论是作为个人AI助手还是团队协作工具你大概率已经体验过它基础对话和任务处理的能力。但你可能也隐隐感觉到它的“出厂设置”似乎有些局限——比如它无法直接读取你电脑上的文件、不能帮你分析GitHub仓库的代码、或者对实时网络信息的获取显得力不从心。这种感觉是对的因为一个“裸奔”的Hermes其核心能力是相对固定的。而“技能包”正是打破这种局限将Hermes从一个通用聊天机器人定制成你专属的超级工作伙伴的关键。简单来说技能包就是为Hermes扩展功能的插件。你可以把它想象成智能手机上的App。手机本身能打电话、发短信但安装了地图App你才能导航安装了文档处理App你才能编辑文件。Hermes的技能包也是如此它们赋予了Hermes与外部世界交互、处理特定格式数据、调用专业API的能力。而skills.sh就是那个帮你一键安装和管理这些“App”的官方应用商店和包管理器。我最初接触Hermes时也满足于它的基础问答。直到有一次我需要它帮我分析一个本地项目目录的结构它却告诉我“我无法直接访问你的文件系统”。那一刻我才意识到它的潜力远未被挖掘。通过搜索社区我发现了skills.sh和丰富的技能包生态从此打开了新世界的大门。现在我的Hermes可以帮我总结PDF报告、监控服务器日志、甚至作为中间件连接不同的SaaS服务。这篇文章就是把我从摸索到熟练的完整过程以及那些官方文档里没写的“坑”和技巧毫无保留地分享给你。无论你是刚部署好Hermes的新手还是想进一步挖掘其潜力的老用户这篇指南都能让你系统地掌握技能包安装与管理的精髓真正实现Hermes能力的“翻倍”。2. 核心概念与准备工作理解技能包的运作机制在开始动手安装之前我们必须先搞清楚几个核心概念。这能帮你避免后续90%的配置错误和理解偏差明白每一步操作背后的逻辑而不是机械地复制命令。2.1 技能包Skill到底是什么一个Hermes技能包本质上是一个遵循特定规范的软件包。它通常包含以下几个核心部分SKILL.md文件这是技能包的“说明书”和“身份证”。它定义了技能的名称、描述、版本、作者以及最重要的——这个技能能做什么能力描述以及Hermes该如何调用它配置说明。很多人在GitHub上寻找的“最好的skill.md提示词”其实就是指那些编写得极其出色、能力描述清晰且 prompts 设计巧妙的技能包定义文件。执行逻辑这可以是任何形式的代码Python脚本、二进制文件、HTTP服务接口等它包含了实现技能功能的具体逻辑。例如一个“天气查询”技能的执行逻辑可能就是一个调用天气API并格式化返回数据的Python函数。配置清单告诉Hermes在运行时需要哪些环境变量、访问哪些目录或网络端口。当Hermes加载一个技能包后它就能理解并执行该技能包SKILL.md中所描述的新指令或任务。例如加载了file-reader技能包后你就可以对Hermes说“请读取/home/user/report.txt文件并总结其内容。”2.2skills.sh官方的技能包管理器skills.sh不是一个神秘的脚本你可以把它理解为Hermes生态的apt-get或brew。它是一个命令行工具主要功能包括浏览与搜索列出官方或社区维护的技能包仓库。安装与卸载一键将技能包下载、解压并配置到Hermes的正确目录。更新与管理检查已安装技能的更新并进行升级。它的工作原理通常是从预设的Git仓库例如官方的hermes-skills仓库拉取技能包的清单和文件然后根据SKILL.md的指引将其部署到Hermes的external_dirs外部目录中。2.3external_dirs技能包的“家”这是Hermes配置中一个至关重要的概念。external_dirs是一个配置项通常在config.yaml或环境变量中指定它告诉Hermes“除了我自身的核心功能请额外扫描这些目录加载里面的技能包。”你可以配置多个external_dirs。常见的设置是一个目录用于存放通过skills.sh安装的官方/社区技能包。另一个目录用于存放你自己开发的或从其他地方获取的私人技能包。这样做的好处是公私分离管理清晰。当你运行skills.sh install skill-name时脚本会自动将技能包安装到指定的external_dirs中并确保Hermes在下次启动时能识别它。注意很多新手遇到的“安装了技能但Hermes不识别”的问题十有八九是external_dirs配置错误或者Hermes服务没有重启以加载新技能。2.4 准备工作检查你的Hermes环境在安装任何技能包之前请先确认以下事项Hermes已正确安装并运行确保你的Hermes客户端或服务正在运行。可以通过hermes --version或访问其Web界面来验证。找到配置文件定位你的Hermes配置文件。这可能是~/.hermes/config.yamlLinux/macOS用户目录下安装目录下的config.yaml通过环境变量HERMES_CONFIG_FILE指定的文件备份配置文件在进行任何修改前养成备份的好习惯。cp ~/.hermes/config.yaml ~/.hermes/config.yaml.backup确认网络连通性skills.sh需要从Git仓库拉取数据确保你的终端可以访问GitHub等代码托管平台。3. 技能包安装全流程详解从搜索到验证掌握了核心概念后我们就可以开始实战了。本章节将带你完整走一遍安装一个技能包的流程我会以安装一个实用的“网页抓取”技能包为例。3.1 第一步探索与发现技能包首先我们需要知道有哪些技能包可用。skills.sh通常提供了搜索和列表功能。列出所有可用技能包./skills.sh list # 或者如果 skills.sh 在系统路径中 skills.sh list这个命令会从远程仓库拉取索引显示所有可安装的技能包名称和简短描述。搜索特定技能包 如果你知道你需要的大致功能比如“文件处理”或“代码分析”可以使用搜索功能。skills.sh search web skills.sh search pdf skills.sh search git搜索结果是模糊匹配的会列出名称或描述中包含关键词的技能包。查看技能包详情 在安装前详细了解一个技能包是明智的。使用info命令可以查看其SKILL.md的内容。skills.sh info web-scraper这个命令会输出该技能的详细描述、使用示例、配置要求以及可能的依赖项。务必仔细阅读这部分特别是“Configuration”和“Requirements”部分这能帮你提前准备好所需的环境。3.2 第二步安装技能包假设我们决定安装web-scraper这个技能包。安装命令非常简单skills.sh install web-scraper这个过程背后skills.sh会执行以下操作从远程仓库下载web-scraper技能包的压缩包或克隆其Git仓库。将其解压/复制到external_dirs指定的目录中通常是~/.hermes/external_skills或类似路径。根据技能包内的配置可能会尝试安装Python依赖如果技能包包含requirements.txt。实操心得安装时最好在终端保持网络稳定。有时安装失败可能是因为网络超时。如果遇到问题可以尝试添加--verbose或-v参数来获取更详细的日志便于排查。skills.sh install web-scraper -v3.3 第三步配置技能包安装完成并不代表立刻能用。大多数技能包都需要进行一些配置。skills.sh info命令的输出会告诉你需要做什么。常见的配置项包括环境变量例如一个需要调用API的技能包会要求你设置API_KEY。# 在你的shell配置文件如 .bashrc, .zshrc中设置或直接在启动Hermes前设置 export WEB_SCRAPER_API_KEYyour_key_here修改Hermes主配置有些技能包可能需要你在Hermes的config.yaml中添加特定的配置块。例如一个需要访问本地数据库的技能包可能会要求你配置数据库连接字符串。# 在 ~/.hermes/config.yaml 中添加 skills: web-scraper: db_path: /path/to/your/data.db rate_limit: 10安装系统级依赖少数技能包可能依赖特定的系统工具如pandoc文档转换、ffmpeg音视频处理。你需要用系统包管理器如apt,brew,yum提前安装好。关键检查点完成配置后再次运行skills.sh info web-scraper确保所有“Requirements”都已满足通常会以 ✅ 或 ❌ 标记。3.4 第四步重启Hermes并验证这是至关重要的一步Hermes通常在启动时加载external_dirs中的技能包。因此安装并配置好技能包后你必须重启Hermes服务或客户端才能使新技能生效。如果Hermes以前台进程运行直接停止当前进程CtrlC然后重新启动它。如果Hermes以系统服务运行例如通过 systemdsudo systemctl restart hermes # 或者 hermes restart重启后如何验证技能包是否加载成功查看Hermes日志启动时Hermes的日志会列出加载的技能包。寻找类似Loaded external skill: web-scraper的信息。journalctl -u hermes -f # 如果使用systemd # 或直接查看Hermes的输出日志在Hermes交互界面中测试直接向Hermes发送该技能包描述中的指令。例如对于网页抓取技能你可以尝试说“使用web-scraper技能抓取 https://example.com 的标题和首段内容。”使用skills.sh检查skills.sh list --installed这个命令会列出所有已安装在本地的技能包确认web-scraper在列表中。4. 高级管理与故障排查成为技能包专家当你熟练掌握了基础安装流程后以下高级技巧和常见问题的解决方案能让你管理技能包更加得心应手。4.1 技能包的管理与维护更新技能包技能包和普通软件一样会修复Bug和增加新功能。定期更新是个好习惯。# 更新所有已安装的技能包 skills.sh update --all # 更新特定技能包 skills.sh update web-scraper注意更新前请务必查看技能包的更新日志如果有因为新版本可能会变更配置方式或引入不兼容的改动。卸载技能包如果你不再需要某个技能可以将其卸载以释放空间并保持环境整洁。skills.sh uninstall web-scraper卸载命令通常会删除external_dirs中对应的技能包目录。但请注意它通常不会删除你手动配置在config.yaml中的相关配置项或设置的环境变量这些需要你手动清理。安装特定版本或从其他源安装有时你可能需要安装旧版本或者想尝试GitHub上某个开发者自建的技能包。# 从特定的Git仓库URL安装这要求该仓库结构符合Hermes技能包规范 skills.sh install https://github.com/username/custom-skill.git # 安装特定版本如果仓库支持标签 skills.sh install https://github.com/username/custom-skill.gitv1.2.04.2 常见问题与解决方案实录以下是我在大量实践中总结的典型问题希望你永远不会遇到但万一遇到了可以在这里快速找到思路。问题现象可能原因排查步骤与解决方案技能包安装失败提示“Download error”或“Clone failed”1. 网络问题无法访问GitHub等源站。2. 技能包名称拼写错误。3. 源仓库已移除或改名。1. 检查网络连接尝试使用ping github.com。2. 使用skills.sh list确认正确的技能包名称。3. 如果从自定义URL安装检查URL是否有效。技能安装成功但Hermes启动时报错提示技能加载失败1. 技能包的SKILL.md格式错误或不符合规范。2. 技能包依赖的Python库或其他运行时缺失。3.external_dirs配置路径权限不足。1. 查看Hermes错误日志定位具体错误信息。2. 进入技能包目录手动检查SKILL.md语法。3. 运行技能包自带的测试脚本或检查requirements.txt手动安装依赖。4. 检查external_dirs目录的读写权限。Hermes重启后无法识别新技能的命令1. Hermes未成功重启或新进程未加载配置。2. 技能包虽然加载但其“能力描述”未正确注册到Hermes的指令系统中。3. 与已有技能或核心指令冲突。1. 确认Hermes进程确实重启了检查进程ID是否变化。2. 查看启动日志确认是否有该技能的加载记录。3. 尝试使用技能包文档中最基础、最简单的示例指令进行测试。4. 检查是否有同名的内置指令或其他技能指令覆盖。技能执行时报错如“ModuleNotFoundError”或“API Key missing”1. 依赖未安装完整。2. 环境变量未正确设置或未生效。3. 技能包需要的配置文件不存在。1. 根据错误信息安装缺失的Python模块pip install module_name。2. 确认环境变量在启动Hermes的同一个shell环境中已设置。对于服务形式运行的Hermes环境变量需要在服务文件如systemd的.service文件中定义。3. 按照skills.sh info的说明创建或修改所需的配置文件。skills.sh命令本身无法执行或报错1.skills.sh脚本没有执行权限。2. 脚本依赖的工具有缺失如git,curl,jq。3. 脚本版本过旧与当前Hermes版本不兼容。1. 添加执行权限chmod x /path/to/skills.sh。2. 根据错误提示安装缺失的系统工具。3. 尝试从Hermes官方仓库重新下载最新版的skills.sh脚本。4.3 实操心得让技能包管理更优雅的私人技巧使用独立的Python虚拟环境如果你安装的很多技能包都是Python写的并且依赖复杂强烈建议为Hermes的技能包创建一个独立的conda或venv虚拟环境。然后在启动Hermes前激活该环境或者将虚拟环境的Python路径配置到Hermes中。这能完美解决不同技能包之间、技能包与系统Python之间的依赖冲突问题。分类管理external_dirs不要把所有技能包都扔进一个目录。我个人的习惯是~/.hermes/skills/official: 存放通过skills.sh安装的官方/社区技能包。~/.hermes/skills/custom: 存放自己编写或从第三方获取的私人技能包。然后在config.yaml中配置external_dirs为这两个目录的列表。这样结构清晰备份和迁移时也方便。技能包配置版本化将你的~/.hermes/config.yaml文件纳入版本控制如Git。这样当你调整技能包配置、添加新技能时所有的变更都有记录可以轻松回滚到可用的状态。从日志开始排查遇到任何技能相关的问题第一时间查看Hermes的日志。日志的详细程度通常可以通过启动参数如--log-level DEBUG来调整。错误信息、堆栈跟踪都藏在日志里这是定位问题最直接的途径。5. 从使用者到创造者探索自定义技能包当你熟练使用各种技能包后很可能会产生一些独特的想法“要是Hermes能帮我做XXX就好了”。这时你就可以考虑创建自己的技能包。这并不像想象中那么困难。5.1 自定义技能包的基本结构一个最简单的自定义技能包可以只是一个包含SKILL.md文件的目录。SKILL.md是核心。以下是一个极简示例# My Echo Skill ## Description 一个简单的回声技能用于测试。它会重复你说的话。 ## Capabilities - 当用户发送以“回声”开头的消息时技能会被触发。 - 技能会移除“回声”前缀并将剩余文本返回给用户。 ## Configuration 无需特殊配置。 ## Example Usage 用户: “回声你好世界” Hermes: “你好世界”你只需要将这个目录例如命名为my-echo-skill放到external_dirs指定的目录中重启Hermes它就能识别这个简单的“指令模式”技能。当然这只是最基础的。更强大的技能需要编写执行逻辑。5.2 为技能包添加执行逻辑通常执行逻辑是一个独立的可执行脚本或一个服务。Hermes会通过进程间通信IPC或HTTP调用它。社区常见的做法是使用Python并遵循一定的接口规范。例如一个简单的Python技能骨架#!/usr/bin/env python3 import sys import json def main(): # Hermes会通过标准输入stdin传递JSON格式的请求数据 request_data json.loads(sys.stdin.read()) user_input request_data.get(input, ) # 你的技能逻辑 if user_input.startswith(回声): response_text user_input[3:] # 移除“回声” else: response_text 未触发技能。 # 将结果以JSON格式输出到标准输出stdout result {response: response_text} print(json.dumps(result)) if __name__ __main__: main()然后在SKILL.md的Configuration部分你需要指明如何调用这个脚本。更复杂的技能可能会涉及长期运行的服务、数据库连接、外部API调用等。5.3 测试与分享你的技能包在将自定义技能包投入生产使用前务必进行充分测试。你可以在本地external_dirs中测试确保它能被Hermes正确加载和触发。如果你觉得自己的技能包对社区有价值可以考虑将其提交到官方的技能包仓库如果开放贡献或者在自己的GitHub上开源并编写清晰的README和SKILL.md。这样其他人就可以通过skills.sh install https://github.com/yourname/your-skill.git来安装你的作品了。通过skills.sh安装和管理技能包是解锁Hermes全部潜力的标准路径。它从探索、安装、配置到验证形成了一套完整的闭环。更重要的是理解其背后的机制——SKILL.md的定义、external_dirs的配置、技能包的加载流程——能让你在遇到问题时游刃有余。从使用现成的技能包到最终动手打造满足自己独特需求的技能这个过程本身也是对智能体架构和功能扩展的一次深刻学习。我的经验是开始时选择一两个最急需的技能入手比如文件阅读或网络搜索在成功应用并获得正反馈后再逐步探索更复杂的技能最终你将拥有一个完全为你量身定制的、能力强大的AI工作伙伴。