模型入口
Provider
负责把 Hermes Agent 接到 OpenRouter、Nous Portal、Ollama 或兼容端点。第一步先保证短问答稳定，再谈复杂工作流。
验收：模型名、API Key、上下文窗口和备用模型都有记录。
概念入门
Agent Harness 中文指南
先别急着写复杂提示词。把 Provider、Memory、Skills、Workflow、权限和验收分清楚，Hermes Agent 才容易跑稳。
先分清边界
别把所有问题都交给提示词
只改 Prompt 很快会遇到瓶颈。Hermes Agent 要稳定跑起来，还需要模型入口、上下文、记忆、工具权限、日志、验收和交接记录。
Prompt
告诉模型这一次要怎么回答。它适合临时指令，不适合承担长期状态和复杂执行。
Context
管理模型这一次能看到什么，包括历史消息、文件片段、工具结果和检索内容。
Harness
把模型、工具、记忆、权限、日志和工作流放在同一套运行规则里。
长期状态
Memory
保存项目规则、用户偏好、环境差异和会反复使用的事实。它解决的是“下次还记得什么”。
验收：重开会话后能读到少量高价值事实，且没有写入敏感信息。
可复用方法
Skills
把稳定流程写成 Skill，例如代码审查、日报整理、FAQ 更新或客户跟进草稿。它解决的是“下次怎么做”。
验收：低风险任务能触发，输入、输出和人工确认边界清楚。
运行方式
Workflow
定义输入来源、触发频率、输出位置和消息推送。工作流负责把前面的配置接到具体任务里。
验收：输入固定、输出固定、失败有日志，连续运行 3 次不漂移。
验收循环
Verification
用测试、清单、人工确认和运行日志检查结果，避免自动化悄悄失败或越权执行。
验收：每个高风险动作都有确认，失败能回到最小复现。
交接记录
Handoff
记录环境变量、运行命令、最后成功时间、下一步和回滚方式，让长期任务可以被接住。
验收：换电脑、换服务器或换人后能继续运行。
上手路线
中文用户可以按这 4 步开始
先跑通，再复用，最后再长期运行。这个顺序比一开始堆工具更稳。
- 01
完成 setup 验收
确认 Provider、Memory、Skills 目录和 Gateway 状态，先用 CLI 完成一次干净短问答。
- 02
选择低风险工作流
从每日简报、Issue 分类、内容选题或 PR 摘要开始，固定输入来源和输出字段。
- 03
补 Memory 和 Skill
把稳定事实写入 Memory，把跑稳的操作步骤写成 Skill，不要把第一版错误流程固定下来。
- 04
加入验证和交接
补运行日志、人工确认、失败重试、最后成功时间和回滚方式，再进入长期部署。
运行规则
上线前至少检查这些
- 先用一个稳定 Provider 跑通短问答，不同时排查多个模型来源。
- Memory 只保存稳定事实，临时输入和敏感内容保持克制。
- 工作流跑 3 到 5 次以后，再把稳定部分写成 Skill。
- 消息平台先用私聊或测试群，高风险动作必须人工确认。
- 每个长期任务都留下日志、重启命令、最后成功时间和回滚方式。
常见误区
不要把复杂度提前放大
把所有内容都塞进 Prompt
Prompt 适合当次任务，长期规则应该进入 Memory，稳定方法应该进入 Skill。
过早追求多 Agent
新手先把单个工作流跑稳。只有任务域明显分开、工具数量过多或权限边界不同，才考虑拆分。
没有验证循环
没有日志、清单和人工确认的自动化，只是把失败藏起来。先让失败能被看见，再让它自动运行。
一开始就给高权限
日报、摘要、分类和草稿可以先自动化；删除、发布、付款、改生产数据必须保留人工确认。
从概念到实践
先领免费 Starter 包，跑出一次结果
Starter 包包含入门工作流、Skill 示例和部署检查清单。先用一个低风险任务验证 Provider、Memory、Skills 和输出格式，再决定是否进入长期部署。