什么时候必须写交接
工作流已经接 Gateway 或定时任务
配置了新的 Provider、Memory 或 Skills
准备迁到 VPS 或换一台机器运行
给客户、同事或未来的自己交付
本轮还有未验证项或已知错误
模板结构
交接文件应该包含什么
当前已验证
写清哪些页面、工作流、命令或 Gateway 已经成功跑过。
最后成功时间验证命令输入样例输出位置截图或日志路径
本轮改动
把本次新增或修改的配置、模板、Skill 和部署项列出来。
改了哪些文件改了哪些环境变量新增了哪些工作流是否影响旧流程
仍损坏或未验证
不要把没验证的东西写成已完成。明确风险可以减少下次排错成本。
失败现象最近错误日志未验证入口需要人工确认的动作
下一步最佳动作
让下一次会话不用重新思考，从最小、最确定的一步继续。
第一条命令要打开的页面要测试的输入成功后再做什么
运行与回滚
长期运行的任务必须知道怎么重启、怎么停、怎么回退。
启动命令停止命令日志路径配置备份回滚步骤
可复制的交接模板
# session-handoff.md
## 当前已验证
- 最后成功时间：2026-05-11 09:30
- 验证命令：hermes doctor && hermes workflow run daily-brief
- 输出位置：outputs/daily-brief-2026-05-11.md
## 本轮改动
- 更新 daily-brief.md 输出字段
- 新增 Gateway 测试群 Chat ID
- Provider 固定为当前默认模型
## 仍损坏或未验证
- Telegram 正式群未接入
- FAQ 更新流程只跑过脱敏样例
## 下一步最佳动作
1. 用 sample-inputs/daily-brief.md 再跑一次
2. 对照 /checklists#workflow 检查输出字段
3. 通过后再接测试群推送
## 运行与回滚
- 启动：hermes gateway start
- 日志：logs/gateway.log
- 回滚：恢复 workflows/daily-brief.md 上一个版本