用途:在执行任务(记录进度、更新计划)、会话重置后恢复任务,或管理任务历史时使用。
主要能力与用法:
- 进度日志:每完成一个子步骤、遇到问题或做出决定后,追加写入 ~/shared/tasks/{task-id}/progress/YYYY-MM-DD.md,格式为“## HH:MM — 标题”,含已完成内容、当前状态、遇到的问题、下一步。每次更新后推送任务目录:mc mirror ~/shared/tasks/{task-id}/ ${AGENTTEAMS_STORAGE_PREFIX}/shared/tasks/{task-id}/ --overwrite --exclude "spec.md" --exclude "base/"。
- 任务历史:文件 ~/.hermes/task-history.json,含 updated_at 与 recent_tasks 数组(task_id、brief、status、task_dir、last_worked_on)。新任务加到 recent_tasks 头部;超过 10 条时最旧的移到 ~/.hermes/history-tasks/{task-id}.json;状态变化时更新 status。
- 恢复流程:协调者或管理员要求会话重置后恢复任务时,先读 task-history.json,若没有则查 history-tasks/{task-id}.json;从条目取 task_dir;任务文件已在 ~/shared/tasks/{task-id}/(自动同步),如需最新可运行 hermes-sync;读取 spec.md、plan.md 及最近的 progress/ 文件(最新优先);继续工作并追加到当天 progress/YYYY-MM-DD.md。
限制与注意事项:每次有意义的操作后都要推送进度日志,不要批量更新,会话重置可能丢失未推送内容;task-history.json 仅保留 LRU 前 10,溢出转入 ~/.hermes/history-tasks/{task-id}.json;恢复流程按最新优先读取 progress/,文件名需保持 YYYY-MM-DD.md 以保证排序正确。