🤖HermesBlog
Hermes 实战教程 · 第1篇2026/8/9· Easy Understand Hermes Agent

最佳实践——用好 Hermes 的 10 个技巧

Hermes 实战教程第1篇:最佳实践。官方总结的高效使用技巧。

这篇教程讲的是:怎么把 Hermes Agent 用得又快又省,像老手一样少走弯路。


第1步:把话说清楚,别让 AI 猜

模糊的指令只会得到模糊的结果。别只说“修一下代码”,要说“修复 api/handlers.py 第 47 行的 TypeError——process_request()parse_body() 收到了 None”。你给的上下文越多,来回折腾的次数就越少。把报错信息直接粘贴进去,Hermes 能自己解析。

第2步:把常用规则写进 AGENTS.md

如果你总在重复“用 tab 不用空格”“我们用的是 pytest”“API 地址是 /api/v2”,那就把这些写进项目根目录的 AGENTS.md 文件。Hermes 每次会话都会自动读取它,一次配置,永久生效。

# 项目约定
- 这是 FastAPI 后端,用 SQLAlchemy ORM
- 数据库操作一律用 async/await
- 测试放 tests/ 目录,用 pytest-asyncio
- 永远不要提交 .env 文件

第3步:放手让 Agent 用工具

别一步步指挥。说“找到并修复失败的测试”,而不是“打开 tests/test_foo.py,看第 42 行,然后……”。Hermes 自带文件搜索、终端和代码执行能力,让它自己探索和迭代

第4步:用斜杠命令调用现成技能

做复杂工作流之前,先输入 /skills 看看有没有现成的技能。比如 /github-pr-workflow 就能直接帮你走完 PR 流程,不用每次从头写长提示词

第5步:掌握 CLI 的快捷操作

  • 多行输入:按 Alt+EnterCtrl+J 换行,不会误发送
  • 粘贴检测:直接粘贴代码块或报错,Hermes 会当作一条消息处理
  • 中断重定向:按一次 Ctrl+C 打断当前回复,输入新消息重新引导;2 秒内按两次则强制退出
  • 恢复会话:用 hermes -c 恢复上次会话,或用 hermes -r "项目名" 按标题恢复
  • 粘贴图片:按 Ctrl+V 直接把截图贴进对话,Hermes 能用视觉分析 UI 报错或设计稿
  • 命令补全:输入 / 再按 Tab,所有内置命令和技能都会列出来,不用背

第6步:用 SOUL.md 定制 AI 性格

想让 Hermes 说话简洁直接?编辑 ~/.hermes/SOUL.md 文件:

# 灵魂
你是一位资深后端工程师。回答要简洁直接。
除非被要求,否则不做解释。优先给一行解决方案。
始终考虑错误处理和边界情况。

记住:SOUL.md 管性格,AGENTS.md 管项目规则。

第7步:分清记忆和技能

记忆存事实:你的环境、偏好、项目位置。技能存流程:多步骤操作、工具用法。用记忆回答“是什么”,用技能回答“怎么做”。遇到 5 步以上且会重复的任务,直接说“把刚才的操作存成技能 deploy-staging”,下次输入 /deploy-staging 就能一键执行。

第8步:别破坏提示词缓存

LLM 提供商会缓存对话前缀,缓存命中时费用大幅降低。频繁切换模型、触发供应商回退或轮换凭证,都会让缓存失效,下一条消息按全价重新读取。长会话中偶尔切换没事,来回切就很费钱。

第9步:用 /compress 压缩长会话

会话太长导致响应变慢?运行 /compress 把历史对话总结成精简版,保留关键上下文,大幅减少 token 消耗。用 /usage 随时查看用量。

第10步:批量操作交给脚本

别一条条跑终端命令。让 Hermes 写个 Python 脚本一次搞定:“写个脚本把所有 .jpeg 文件重命名为 .jpg 并运行”——比逐个处理更快更省钱


总结: 核心就三句话——给足上下文、善用配置文件和技能、注意缓存和 token 消耗。把这 10 个技巧用起来,Hermes 的效率至少翻一倍。

下篇预告: 下一篇我们讲怎么用 delegate_task 让多个子 Agent 并行干活,一次搞定三个调研任务。

📖 官方文档

本文根据 Hermes Agent 官方文档编写,原文见:官方文档 › guides/best-practices