Skip to main content

使用技巧与最佳实践

这是一页偏实战的速查指南,适合在你已经装好 Hermes 之后快速提升使用体验。这里不会重复基础安装步骤,而是聚焦那些最容易立刻见效的习惯。

获得更好的结果

把目标说具体

不要只说“帮我修一下”或“看看这个”。更好的表达方式是直接说明:

  • 目标是什么
  • 出问题的文件或模块在哪里
  • 你期待的结果是什么
  • 已知错误信息或限制条件是什么

例如,不要说“修复测试”,而要说“修复 tests/test_auth.py 中失败的登录测试,要求继续使用 pytest 和现有 fixture”。

一次给够关键上下文

如果你已经知道文件路径、堆栈信息、复现步骤或设计约束,最好在第一条消息里一起给出。这样通常能减少来回澄清的轮次,也更容易让 Hermes 一次性走对方向。

让代理自己探索

当任务本身需要查文件、跑命令、读日志或改代码时,通常直接说目标就够了。例如:

  • “找出为什么构建失败并修复它”
  • “把这个仓库的登录流程梳理出来”
  • “检查最新改动有没有回归风险”

Hermes 有文件、终端、搜索和代码执行能力,不需要你手动把每一步都拆开指挥。

CLI 使用习惯

善用斜杠命令

CLI 里最常用的一组命令通常是:

  • /model:切换模型或提供商
  • /compress:压缩当前上下文
  • /title:给会话命名,便于之后恢复
  • /resume:继续之前的会话
  • /tools:查看或临时启用 / 禁用工具
  • /skills:搜索和安装技能
  • /verbose:切换工具输出显示级别

如果你记不清命令名,直接输入 / 再按 Tab 查看自动补全通常最快。

学会在合适的时候中断

如果代理明显走偏了,按一次 Ctrl+C 中断当前响应,然后马上补一句新的方向说明,通常比等它完整跑完更高效。

会话恢复很重要

如果你经常处理中长任务,建议给重要会话加标题,然后用:

hermes -c
hermes -r "我的项目名"

这样你不需要每次重新铺上下文。

上下文文件

把长期规则写进 AGENTS.md

如果某个项目里总有一批固定规则,例如:

  • 使用哪种测试框架
  • 代码风格要求
  • 目录约定
  • 哪些文件不能改
  • PR 或提交信息格式

那么最省事的方式通常不是每次重复提醒,而是把这些规则放进项目根目录的 AGENTS.md。Hermes 会自动读取它。

SOUL.md 管默认风格,用 AGENTS.md 管项目规则

一个简单记法:

  • SOUL.md 更像“你希望代理默认是什么样的人”
  • AGENTS.md 更像“这个项目里要遵守什么规则”

如果你想让 Hermes 长期保持某种语气、偏好或默认工作方式,可以编辑全局 SOUL.md;如果你想约束某个仓库里的行为,就写 AGENTS.md

技能与工具

复杂流程优先想想有没有技能

遇到重复性强、步骤明确的任务时,先看看是否已经有现成技能,而不是每次都写长提示解释流程。可以用:

/skills

来浏览和搜索技能。

不要过早关闭工具

如果任务本来就需要读代码、跑命令或查资料,保持工具可用通常更好。过早禁用工具,往往会让代理退化成只能“猜”的纯聊天模式。

记忆与会话

让 Hermes 记住真正长期有效的信息

更适合保存到记忆里的内容通常包括:

  • 你的输出偏好
  • 团队长期约定
  • 项目背景设定
  • 持续有效的个人工作习惯

不适合保存到长期记忆里的内容通常是:

  • 一次性的临时任务
  • 今天才有效的状态
  • 很快就会过时的上下文

长期记忆越干净,后续会话越稳定。

定期压缩长会话

当一个会话已经持续很久,或者你感觉上下文开始臃肿时,主动使用 /compress 往往能让后续响应更稳,也更节省上下文窗口。

成本与性能

根据任务选择模型

一个实用原则是:

  • 日常问答、轻量改动、常规搜索:优先快模型
  • 复杂重构、深度调试、长文档梳理:再切到更强模型

不是所有任务都需要最贵、最慢的模型。

让一次请求做完整的事

与其拆成很多零碎请求,不如在一条消息里把目标、限制和验收标准说清楚。这样通常能减少往返次数,也更省成本。

安全建议

不要把敏感信息直接贴进对话

包括但不限于:

  • API 密钥
  • 私人令牌
  • 数据库密码
  • 生产环境机密配置

如果必须提到,优先用占位符替代。

对高风险操作保持明确授权

当任务涉及删除、覆盖、批量修改、危险命令或生产环境操作时,最好明确告诉 Hermes 哪些可以做,哪些不可以做。边界越清晰,风险越低。

一个简单的使用原则

把 Hermes 当作“有工具的协作者”,而不是“会聊天的搜索框”。

你给它的目标越清晰、约束越明确、上下文越干净,它的表现通常就越稳定。对需要长期协作的项目,提前整理好 AGENTS.mdSOUL.md、技能和工具设置,往往比任何提示词技巧都更有价值。