10-Minute Quick Start — 从零到第一个 Production Agent¶

目标:10 分钟内,你有一个带状态、可验证、能定时运行的 Agent 骨架。本教程是 Journey A(新用户)的主路径,全部使用仓库内文件,零外部依赖。

前置¶

git clone https://github.com/Komagon/hermes-production-patterns.git
cd hermes-production-patterns

cp -r starter-kits/basic-agent ~/my-agent
cd ~/my-agent

你得到:SKILL.md + STATE.md + AGENTS.md + .env.example。

打开 SKILL.md,只改三处:

原则:确定性步骤(换算、聚合、格式化)写明用脚本,不要让 LLM 心算。

STATE.md 已经是可用的空状态。每次运行:

先读 STATE → 干活 → 每步写回 STATE

这就是重启不丢进度的全部秘密。

hermes run --skill SKILL.md --state STATE.md

验证三件事:

把 starter-kits/maker-checker/checker/PROMPT.md 复制过来,在另一个会话里用 Checker 角色验证你的产出:

# 会话 2(独立实例)
加载 checker PROMPT → 对照产出判定 PASS/FAIL

这一步解决 Agent 生产环境最大的坑:自己验自己。

参考 starter-kits/cron-production/cron-config.example,把你的技能配置成每日定时任务,并确认:

Trigger(cron / 手动)
   ↓
Agent(SKILL.md 定义)
   ↓
STATE(跨运行进度)
   ↓
Checker(独立验证)
   ↓
Publish / Fail→Retry

这就是 🟢 Starter Stack + 🔵 Quality Stack 的雏形。