SuperAPI AI 工具集

session-checkpoint

智能体与模型

查看项目

更新于 10-16 00:03

技能介绍

用途:在长时间运行的工作流中保存会话状态,实现崩溃恢复、上下文刷新以及跨会话连续性。核心思路是 /clear 加 ledger 重载可提供干净且信号完整的上下文,避免反复 /compact 造成的累积退化。

配置依赖:需在 .agents.yml 中设置 session.ledger: true,可选 ledger_path,默认 .agents/session_ledger.md。ledger 按 worktree 隔离,属临时会话状态;交接内容进入主 worktree,用于 Skill("learn")。

主要流程:检查配置,未启用则跳过并返回提示;确定 ledger 路径并用 mkdir -p .agents 确保目录存在;收集目标、约束与假设、关键决策,以及 Done/Now/Next 状态、未决问题(不确定项标 UNCONFIRMED)、工作集(文件、ID、命令);按固定格式写入 ledger;返回简短确认。

使用时机:上下文用量约 70% 时提前检查点,85% 以上立即检查点并考虑 /clear 加重载;多日实现每段工作结束时检查点;复杂重构在大改动前后检查点。30 分钟以内的快速任务、简单 bug 修复或单文件改动,以及已使用 /handoff 的会话可跳过。

集成方式:在其他智能体的高风险操作前、每个里程碑后、上下文超过 70% 时调用该技能。

清空后恢复:自动读取 ledger 恢复上下文,校验 UNCONFIRMED 项,先问 1 至 3 个验证问题,再从 Now 段继续。

限制:资料未提供具体价格、平台支持范围及与其他工具的兼容性细节;需依赖配置启用,否则不创建文件。