最后更新 2026-10-05 · HermesAgent.Work 编辑组 整理维护(内容维护说明)· 步骤过时或无法复现可反馈
先别急着改模板
很多新手下载资源包后第一反应是把所有 Prompt 都改一遍,这反而容易把问题变复杂。第一次使用 Starter 包只做一件事:选一个低风险工作流,保持目录结构不变,先跑出一次稳定结果。
推荐目录理解
hermes-agent-starter-pack/
README.md
workflows/
daily-brief.md
github-issue-triage.md
content-idea.md
skills/
starter-daily-briefing/
SKILL.md
examples.md
checklists/
setup-checklist.md
deployment-lite.md
troubleshooting/
common-errors.mdworkflows 是直接可复制的任务模板,skills 是把稳定流程沉淀成 Skill 的示例,checklists 用来验收环境,troubleshooting 用来记录常见错误。
30 分钟路线
- 0-5 分钟:打开 README,确认你要跑的是日报、Issue 分类还是内容选题。
- 5-10 分钟:复制对应工作流,不改结构,只填自己的输入来源。
- 10-20 分钟:确认 Provider、Memory、Skills 目录和环境变量。
- 20-25 分钟:用 CLI 跑一次,保存输入和输出。
- 25-30 分钟:对照验收清单,看是否能重复跑出同样格式。
第一次选哪个模板
如果你只是想感受 Hermes Agent,选 daily-brief.md。它风险最低,只需要整理信息。开发者可以选 github-issue-triage.md,内容运营可以选 content-idea.md。不要第一次就接外部发送、数据库写入或生产系统。
验收标准
第一次跑通不是“看起来能输出”就结束,而是要满足四个条件:输入来源固定、输出字段固定、失败能定位、人工能快速检查。只要这四件事成立,后续才值得扩展到消息平台和定时任务。
跑通之后先 backup:把能用的环境冻结成 zip
第一次按验收标准跑出稳定结果,先别急着动模板,把这套刚刚能用的环境固化下来:
hermes backup它把 Hermes home 里的配置和数据打包成一个 zip,~/.hermes/config.yaml 和 ~/.hermes/.env 都包含在内(Hermes 代码本身和检查点不在里面)。之后你再去改 Prompt、换输入来源、调整 Skill,改崩了就用 hermes import <zip 路径> 从这个 zip 恢复,几分钟回到刚跑通的那个状态。打包的节奏跟着改动走:模板大改之前、新增输入来源之前各打一次,zip 按日期命名,放到这台机器以外的地方。顺带认识一下 ~/.hermes/checkpoints/,运行过程中的检查点都落在这个目录,用 hermes checkpoints 查看和清理;它和 backup 是两回事——前者是过程快照,后者是配置和数据的打包。新手期最大的时间黑洞是"昨天还能跑,今天不知道动了哪"——有这个 zip 在,任何激进改动都有退路。
sessions export:试跑记录不靠手工复制
30 分钟路线里"保存输入和输出"那一步可以自动化。会话本来就落在本地 SQLite 里,直接用 sessions 这组命令管理:
hermes sessions list
hermes sessions rename
hermes sessions export
hermes sessions stats每完成一轮试跑就 rename 一次,把三轮分别命名成可识别的名字,后面核对输出字段时按名字定位,不用在一堆默认标题里翻找。export 支持导出 JSONL,把导出文件和工作流模板放进同一个项目目录,验收时对照字段是否漂移。只想快速翻一翻对话内容,不必先导出,hermes sessions browse 可以直接浏览。stats 看累计数据;废掉的某一轮用 hermes sessions delete 单独删除,记录攒多了再用 hermes sessions prune 批量清理没价值的部分。这套留痕动作的成本接近零,换来的是把"第一次跑通"从一句口头描述变成可复查的档案:模板没改、记录在手,下一次扩展输入来源时才说得清"变化是从哪一版开始的",而不是凭印象争论。
还没有真实场景?可以先领取 Free Starter 模板包,从低风险只读任务开始试跑。