Hermes Agent 新手路线：从 0 到第一个可复用自动化

新手最容易走偏的地方

Hermes Agent 看起来能做很多事，但新手第一周不应该追求功能完整，而应该追求一个稳定闭环：能启动、能调用模型、能按固定格式输出、能被人工验收。

30 分钟目标

30 分钟内只追求最小成功：安装 Hermes，配置一个模型 Provider，打开 CLI 发起一次对话，再用 setup 或 doctor 类命令确认关键状态。不要在这个阶段接多个消息平台，也不要写复杂 Skill。

1 天目标

1 天内选择一个真实但低风险的文本任务，例如每日简报、Issue 分类、PR 摘要或内容选题。把输入、输出、运行方式和验收标准写清楚，连续跑 3 次，观察输出是否稳定。

1 周目标

1 周内再考虑部署、Gateway、日志、定时触发和 Skills。这个阶段的关键不是“自动化更多”，而是让它失败时能被发现，输出有人工确认，高风险动作有边界。

不建议一开始做的事

• 直接给 Agent 写入生产系统的权限。
• 同时接多个模型、多个 Gateway、多个工作流。
• 没有日志就上定时任务。
• Prompt 没稳定就沉淀成 Skill。
• 没有人工确认就发外部邮件或客户消息。

一条更稳的路线

先本地 CLI，后消息入口；先只读整理，后草稿生成；先单人使用，后团队频道；先工作流模板，后 Skill；先日志排错，后长期运行。

第一周命令地图：从 setup 到第一个 Skill

把阶段目标翻译成每天实际敲的命令。第一天装完环境，按固定顺序跑四条：

hermes setup
hermes doctor
hermes status
hermes model

四条各管一段：`setup` 走完引导配置，`doctor` 检查依赖是否齐全，`status` 给出所有组件的状态总览，`model` 交互式选定 provider 和默认模型。这个顺序本身就是排查路径——前一条没过，后一条的结果不可信；卡在哪一条，就只动那一层的配置，别跨层乱改。第二到第四天不引入任何新组件，把同一份输入连续投三天，对比要点数量、字段顺序和措辞是否一致；不一致就先回到 `hermes model` 换个模型重测，而不是急着加功能。第五天再进入 Skill 环节，节奏是先搜、再看、后装：

hermes skills search daily
hermes skills inspect <技能名>
hermes skills install <技能名>

`inspect` 在安装前预览技能内容，免得装完才发现和任务对不上号。第一周只装这一个，装完跑一次 `hermes skills check` 做检查。

用 -z 单次执行替代反复开会话

从第三天起，固定任务别再每次开交互式会话。全局参数 `-z`（即 `--oneshot`）接一段提示词，执行完就退出：

hermes -z "把今天的未读 Issue 总结成三条要点"

一条命令进得了 shell 历史、放得进脚本，三次运行的结果摆在终端里逐行对比，稳定与否一眼可见。要接住上一次的上下文，加 `--continue`；要回到某个指定会话，用 `--resume` 带上会话标识；临时换模型加 `-m`，不必动配置。还可以用 `--skills` 点名本次要用的技能，正好检验第五天装的那个 Skill 接不接得住任务。偏好可视化界面的话，交互模式有 `--tui` 可选，但固定任务还是走 `-z` 更利于复跑。周末把这条命令的输入来源和期望输出补写进项目 README，下周扩展时就不用靠记忆还原。第七天收尾时，你手里应该有一条可重复执行的 `-z` 命令加一个验收过的 Skill——两样合起来，就是这条路线终点处说的"第一个可复用自动化"。

还没有真实场景？可以先领取 [Free Starter 模板包](/free-template-pack)，从低风险只读任务开始试跑。