HermesAgent外部技能库导入指南：新手必看教程
将外部开发的技能库集成到 Hermes Agent 是扩展其功能的核心操作。系统遵循严格的安全与架构规范，不支持任意脚本执行或动态代码注入，所有外部技能必须通过标准流程完成格式验证与正式注册。这一流程清晰直接，主要包含验证、导入与注册三个环节。以下我们将详细解析几种主流的导入方法。
一、前置格式校验：确保技能库合规
在导入前，首要任务是确认你的技能库文件符合 Hermes Agent 的架构规范。系统要求外部技能库必须是一个结构化的文件集合，通常组织在 skills/ 目录下，并使用 YAML 或 JSON 格式定义。每个技能定义必须包含几个关键字段：name（唯一标识）、description（功能描述）、steps（执行步骤序列）以及 tools（依赖的工具列表）。请注意：steps 中引用的任何工具（例如 terminal、browser），都必须在当前 Hermes 环境中预先注册。若技能使用了自定义工具，请先通过 hermes tool install 命令完成安装与注册。
你可以按以下清单进行逐项检查：
1. 检查技能库根目录下是否存在 manifest.yaml 或 manifest.json 文件。该清单文件定义了技能集的元数据，包括名称、版本及包含的入口文件。
2. 确认每个技能子目录内都包含一个 skill.yaml（或 skill.json）文件。核查其中的 name 字段是否全局唯一，且命名符合规范（通常建议使用小写字母、数字和下划线）。
3. 运行系统校验命令进行最终确认：hermes skill validate --path /path/to/external/skills。当终端输出“✅ All skills valid”提示时，即表示格式验证通过。
二、标准导入流程：使用 hermes skill import 命令
这是最常用且高效的导入方式。该命令会将外部技能库复制到本地 ~/.hermes/skills/ 目录下的指定命名空间中，并自动完成运行时注册。导入后，技能即可在对话中被调用，或通过 /skills 命令进行管理。
具体操作步骤如下：
1. 执行基础导入命令：hermes skill import --from /path/to/external/skills --namespace myorg。其中“myorg”可替换为你自定义的命名空间名称。
2. 若目标位置已存在同名技能，需使用 --force 标志进行覆盖。
3. 导入完成后，建议执行 hermes skill reload 命令以刷新技能运行时缓存，确保新技能立即可用。
三、手动部署与注册：适用于离线环境或深度定制
在网络受限环境，或需要对技能元数据进行精细控制的场景下，可以采用这种手动方式。它绕过了 import 命令的自动处理，但要求你更熟悉 Hermes 技能的生命周期管理。
操作流程如下：
1. 文件部署：将整个外部技能目录直接拷贝至 Hermes 的技能存储路径，例如：~/.hermes/skills/myorg/。“myorg”为你定义的命名空间。
2. 更新注册表：使用文本编辑器打开 ~/.hermes/skills/registry.yaml 文件，在 namespaces 列表下新增一条记录，指明命名空间名称与对应路径，格式如：- name: myorg; path: ~/.hermes/skills/myorg。
3. 激活技能：运行命令 hermes skill register --namespace myorg，通知系统加载并激活该命名空间下的所有技能。
4. 验证状态：最后，使用 hermes skill list --namespace myorg 命令进行查验，确认所有技能均已列出且状态为 active。
四、从 Git 仓库导入：实现团队协作与版本控制
对于需要团队协同维护或进行版本化分发的技能库，直接从 Git 仓库导入是最佳实践。Hermes 支持从公开或私有的 Git 仓库拉取技能库，要求仓库结构清晰，仅包含技能定义文件，避免混入构建产物或无关文档。
执行步骤如下：
1. 执行远程导入命令：hermes skill import --git https://github.com/username/skills-repo.git --ref v1.2.0 --namespace team。其中 --ref 参数用于指定分支、标签或提交哈希，以锁定特定版本。
2. 若导入私有仓库，需提前在系统中配置 SSH 密钥，或设置 GIT_AUTH_TOKEN 等环境变量完成身份认证。
3. 导入成功后，Hermes 会在本地 ~/.hermes/skills/_git/team/ 路径下创建仓库的克隆副本，并自动完成所有技能的注册，之后便可直接调用。