场景 2026-05-26 16:12

Hermes：打造高效的 Skill 组织与管理

告别混乱！3 行配置，把团队 Skill 库接入 Hermes

你是否也被 Hermes 里散落各处的 Skill 搞得头大？ 有的在~/.hermes/skills/，有的藏在项目目录，还有的是同事发来的压缩包、GitHub 复制的文件…… 换电脑要重新复制，团队协作版本混乱，同一份 Skill 多处存放，连自己都分不清 Hermes 到底加载了哪版。 其实，Hermes 官方有个超实用的外部 Skill 目录功能，仅需 3 行配置，就能统一管理团队、个人、跨工具的所有 Skill，彻底告别复制粘贴的混乱！

图片开始教程之前，建议大家使用算力云平台（www.suanlix.com），算力云不仅有海外云主机、热门显卡GPU等产品，现在已搭建好大模型广场，汇集海内外主流大模型。

◆ 价格普惠、计费透明：平台直接对接模型厂商与顶级算力资源，价格低于行业平均水平，还为用户提供了极具性价比的token套餐，6元就能入门

◆ 统一调用，一站式管理：用户无需多个平台注册账号+充值余额，注册后一个账号、一个API Key，即可调用所有模型，带给用户极致便捷的体验。为开发者、企业及个人用户提供高效、便捷的AI能力调用服务。

◆ 完美兼容主流工具：原生支持Hermes、 OpenClaw（龙虾） 等百种 AI 编程与智能体工具，轻松启用，无需复杂配置。
回 到 教 程

一、核心配置：3 行代码，搞定外部目录

打开 Hermes 配置文件~/.hermes/config.yaml，添加以下配置：

  •  
  •  
  •  
skills:  external_dirs:    - ~/.agents/skills

如果是团队场景，需关联多个共享目录，直接追加路径即可：

  •  
  •  
  •  
  •  
  •  
skills:  external_dirs:    - ~/.agents/skills  # 个人通用Skill    - /home/shared/team-skills  # 团队共享Skill    - ${SKILLS_REPO}/skills  # 环境变量指定目录

关键特性（官方支持）

  • 路径支持~自动展开，适配不同用户目录；

  • 支持${VAR}环境变量替换，多机器复用配置更轻松；

  • 配置生效后，执行hermes skills list，外部目录 Skill 会和本地 Skill 一起显示，直接用/技能名调用，和本地 Skill 无差别。

     

二、目录规范：这样建，Hermes 才能识别

外部目录不能直接丢 Markdown 文件，\\ 必须遵循 “一 Skill 一目录，目录含 [SKILL.md](SKILL.md)”\\ 的规则，标准结构如下：

  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
~/.agents/skills/├── research-summary/│   └── SKILL.md├── doc-review/│   ├── SKILL.md│   └── references/└── release-prep/    └── SKILL.md

最小测试案例（直接复制可用）

  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
# 创建目录mkdir -p ~/.agents/skills/doc-review# 写入SKILL.mdcat > ~/.agents/skills/doc-review/SKILL.md << 'EOF'---name: doc-reviewdescription: 检查README、安装说明中的过期命令、缺失步骤---# Doc Review## 适用场景- 检查README、安装步骤、docs目录## 输出格式- 过期命令、缺失步骤、歧义句子EOF

执行hermes skills list | grep doc-review，能看到输出即表示配置生效。

三、3 大核心场景：个人 / 团队 / 跨工具全覆盖

✅ 场景 1：团队共用 Skill，统一版本不混乱

团队固定流程（发布、故障响应、文档审查），无需每人维护一份：

  1. 建团队 Git 仓库（如team-agent-skills），目录结构：

  •  
  •  
  •  
  •  
  •  
  •  
team-agent-skills/└── skills/    ├── release-prep/    │   └── SKILL.md    └── incident-response/        └── SKILL.md

  1. 团队成员克隆仓库，配置 Hermes 指向该目录：

  •  
  •  
  •  
skills:  external_dirs:    - ~/work/team-agent-skills/skills

✅ 场景 2：跨工具共用 Skill，避免重复复制

同时用 Hermes、Claude Code、Cursor？通用 Skill（文档审查、需求澄清）只需存一份：

  • 统一存放路径：~/.agents/skills

  • Hermes 通过external_dirs扫描；

  • 其他工具按自身规则读取，无需重复复制，一次修改全工具同步。

 

✅ 场景 3：个人长期沉淀，稳定 / 试验 Skill 分离

不想把试验 Skill 混入 Hermes 主目录？用独立 Git 仓库管理：

  • 稳定 Skill：保留在~/.hermes/skills/；

  • 试验 / 个人 Skill：存于~/repos/personal-skills/skills；

  • 配置 Hermes 扫描外部目录，主目录干净，试验无风险。

 

四、4 个避坑要点，新手必看

⚠️ 要点 1：外部目录非只读，团队目录要控权限

Hermes 不会自动保护外部目录，若进程有写权限，Agent 可能修改其中 Skill。

  • 团队正式 Skill：修改必须提 PR，禁止直接改共享目录；

  • 目录权限：Linux/macOS 设置只读权限，或作为 Git 只读子模块；

  • 个人修改：先复制到本地试验目录，测试通过再提交团队仓库。

 

⚠️ 要点 2：同名 Skill，本地优先加载

若本地（~/.hermes/skills/）和外部目录有同名 Skill，本地版本会覆盖外部版本。

  • 优势：可通过本地版本临时覆盖团队版本，做个人实验；

  • 风险：易误用旧版，建议团队 Skill 加前缀（如team-doc-review），避免撞名。

 

⚠️ 要点 3：不存在路径会被静默跳过，务必校验

配置中无效 / 不存在的路径，Hermes 会直接忽略不报错，易导致 “Skill 未加载却不知情”。

  • 新机器配置后，必须执行：

  •  
  •  
  •  
  •  
# 检查路径存在ls -la /home/shared/team-skills# 检查Skill加载hermes skills list | grep 团队Skill名

  • 用环境变量时，先echo $SKILLS_REPO确认路径正确。

 

⚠️ 要点 4：external_dirs vs tap，选对方案

Hermes 有两种 Skill 管理机制，适用场景不同：

  • external_dirs：本地 / 团队目录扫描，轻量无依赖，适合内部共享、个人 Git 仓库；

  • tap：订阅 GitHub 公开 Skill 源，支持搜索 / 按需安装，适合公开分发。 两者可同时使用，团队内部优先选external_dirs，公开分享再用tap。

 

五、团队落地最小流程，直接照搬

  1. 建仓库：创建团队 Skill Git 仓库，初始化skills目录；

  2. 写 Skill：编写核心 Skill（如team-doc-review），提交仓库；

  3. 配 Hermes：成员配置external_dirs指向仓库本地路径；

  4. 校验生效：执行hermes skills list确认 Skill 加载；

  5. 规范迭代：Skill 修改走 PR，审查通过后合并，全员同步更新。

 

结尾

Hermes 用久了，真正值钱的不是 “装了多少 Skill”，而是一套可维护的 Skill 组织方式。 记住 3 行核心配置，遵守 4 个规则：

  1. 一 Skill 一目录，必须含 [SKILL.md](SKILL.md)；

  2. 外部目录非只读，团队目录严控权限；

  3. 同名本地优先，团队 Skill 加前缀避撞；

  4. 无效路径静默跳过，配置后必校验。 告别到处复制 [SKILL.md](SKILL.md) 的混乱，让个人、团队、跨工具的 Skill，沉淀为一套可长期维护的能力库！

注：本文转载自【今日头条 - 老年人学AI】，点击阅读原文进入原文链接

 

热门文章

最新文章