用途:设计或审查编码智能体运行时的持久化状态,包括会话与任务两部分,二者共享同一宿主存储、身份模型与恢复机制。不用于产品待办规划;持久化仓库指令与常驻记忆文件应使用 agents-memory 技能。
主要能力:会话方面覆盖会话 ID、选择器流程、过期缓存重置、恢复语义、存储模式与保留策略;记录恢复与跨工作树恢复;恢复路径决策(会话 ID、选择器、ACP 重连、配方重播种);上下文生命周期与分支(继续、回退、清空、压缩、子智能体);检查点、回退与 git/分支对比、后台会话恢复、压缩契约。任务方面覆盖任务类型与生命周期、任务列表协调与队友路由、后台资格、认领与阻塞、取消与终止区分、定时/Webhook/队列触发、持久化触发集成、目标模式循环、Goose 会话与配方模式等。
使用方式:先定义稳定会话身份,区分可恢复与可重算状态,恢复时清理发现缓存并重建实时状态;支持按 UUID、精确标题与选择器/搜索恢复;任务状态存于宿主存储,共享列表需显式认领与释放,认领为租约加栅栏令牌。提供脚本 scripts/recipe_scanner.py 用于静态校验配方蓝图 YAML。
适用场景:设计编码智能体 CLI 的恢复与继续流程、跨工作树恢复、类型化任务与后台执行、取消与前后台转换、定时/Webhook/队列触发、循环与图运行时表面。
限制:检查点仅跟踪智能体自身编辑工具的文件改动,不含 shell 命令改动;崩溃时进行中的工具调用结果未知,不得自动重放非幂等调用;每个会话 ID 仅一个写入者;存储格式内部且版本脆弱,应基于导出或脚本接口构建;Codex 参考中的存储层名称来自源码而非公开文档,使用前需核对当前源码。部分主题(如循环编排)归属其他技能。