hermes agent自动化任务需通过yaml格式skill文件实现，存于~/.hermes/skills/，支持工具链调用、变量注入、确认机制及soul.md行为约束，并可通过cli注册、运行与调试。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望让Hermes Agent执行结构化、可复用、可调度的自动化任务，则需通过编写脚本实现。Hermes Agent本身不依赖传统编程语言脚本文件（如.py或.sh），而是基于其内置技能（Skill）系统，以 YAML 格式定义任务流程与工具调用逻辑。以下是编写 Hermes Agent 脚本的核心方法：
一、使用 Skill YAML 定义可复用技能
Hermes Agent 的“脚本”本质是 Skill 文件，存放在 ~/.hermes/skills/ 目录下，以 .yaml 后缀命名。每个 Skill 描述一个完整任务单元，包含触发条件、输入参数、执行步骤与输出格式。
1、在终端中进入技能目录：
cd ~/.hermes/skills/
2、创建新技能文件：
touch web_scrape_summary.yaml
3、用文本编辑器打开该文件，填入标准 YAML 结构：
4、确保 skill.name 字段唯一且不含空格，例如 use_web_scrape_summary
5、在 steps 列表中按顺序声明工具调用，每个 step 必须包含 tool 和 input 字段
二、调用内置工具组合构建脚本逻辑
Hermes Agent 提供数十种预置工具（如 browser、shell、file、code、image_gen），脚本通过串联这些工具形成执行链。工具调用支持变量注入与上下文传递，无需硬编码值。
1、在 YAML 的 input 字段中使用双大括号语法引用上下文变量，例如 {{ query }} 或 {{ url }}
2、在 step 中指定 tool: browser，并设置 input: { url: "{{ url }}", action: "scrape" }
3、后续 step 可直接使用前一步 output 中的 key，例如 {{ previous_step.summary }}
4、为防止敏感操作误执行，对 shell 或 file.write 类工具，必须显式添加 confirm: true 字段
三、通过 CLI 注册并测试自定义脚本
YAML 文件保存后需注册进 Hermes 运行时环境才能被识别和调用。注册过程会校验语法、工具可用性及参数完整性，失败时返回具体错误位置。
1、执行注册命令：
hermes skill register web_scrape_summary.yaml
2、查看已注册技能列表：
hermes skill list
3、手动触发测试运行：
hermes skill run use_web_scrape_summary --url "https://example.com"
4、若提示 tool not found，检查 ~/.hermes/.env 中是否启用对应插件，例如 ENABLE_BROWSER=true
四、利用 SOUL.md 约束脚本行为风格
SOUL.md 是 Hermes Agent 的人格配置文件，位于 ~/.hermes/SOUL.md。它不直接执行逻辑，但深度影响脚本输出的语气、长度、技术深度与安全边界，属于脚本运行的隐式上下文层。
1、打开 SOUL.md 文件：
vim ~/.hermes/SOUL.md
2、在文件末尾添加约束块：
```behavior_constraints
- 拒绝生成任何可执行二进制文件路径
- 输出摘要不得超过 300 字
- 所有代码示例必须带注释说明用途```
3、保存后重启 Hermes 进程使约束生效：
killall hermes && hermes start
4、再次运行同一脚本，观察输出是否符合新增约束
五、调试脚本执行流程与错误定位
脚本执行失败时，Hermes 默认仅返回简短错误消息。需启用详细日志模式才能查看每一步工具输入、输出、耗时与异常堆栈，这对修复 YAML 语法错误、参数类型不匹配或工具权限问题至关重要。
1、临时启用调试日志：
hermes skill run use_web_scrape_summary --debug --url "https://example.com"
2、日志中定位含 ERROR 或 FAILED 的行，重点关注 tool 返回状态码与 stderr 内容
3、若报错 Permission denied for file.write，检查 ~/.hermes/ 目录所属用户是否与当前运行用户一致
4、若 browser 工具超时，确认 CAMOFOX_URL 环境变量已正确配置且服务进程正在运行
