HermesAgent.Work
Skills

Hermes Agent Skills 装完不生效:触发条件、会话重启和 Skill 目录排查

安装 Skill 后搜索不到、不会触发或输出不稳定时,按 Skill 名称、目录、When to Use、会话重启和低风险测试排查。

2026-05-138 分钟阅读SkillsSkillsSkill 不生效/skills install排错

先确认 Skill 是否真的安装到当前目录

hermes skills browse
hermes skills search <keyword>
/skills

如果命令里能看到,但会话里不触发,通常不是安装失败,而是触发条件或会话状态问题。

重启会话再测试

安装 Skill 后建议新开 Hermes 会话。旧会话可能没有重新读取 Skill 目录,尤其是你刚用 `/skills install` 或命令行安装之后。

检查 When to Use

Skill 的触发描述要具体。不要只写“用于工作流”,而要写清楚:什么输入、什么场景、什么时候必须使用、什么时候不要使用。触发条件越模糊,越容易不触发或误触发。

用低风险输入连续测三次

不要第一次就接客户消息、生产仓库或自动发送。先用样例输入测试 3 次,检查输出字段是否一致、失败时是否能定位、人工是否能快速判断。

什么时候该重写 Skill

如果每次都要额外解释一大段,说明 Skill 还没有把流程讲清楚。把稳定步骤、输入约束、输出格式和示例补进 Skill,再测试。

下一步

如果你还没有真实场景,可以先领取 Free Starter 模板包,从每日简报、Issue 分类和内容选题三个低风险任务开始。

常见问题

把搜索里最常见的疑问集中放在这里,适合排查时快速确认方向。

Skill 安装后为什么不触发?+
常见原因是会话没有重启、Skill 描述太宽、When to Use 不清楚,或者当前任务和 Skill 的触发条件不匹配。
Skill 装得越多越好吗?+
不是。围绕一个真实工作流只装必要 Skill,目录越复杂,排查成本越高。
怎么判断 Skill 真的可用?+
用低风险输入连续测试 3 次,确认输入要求、输出字段和失败边界都稳定,再接入正式流程。