SuperAPI AI 工具集

checkpoint

通用与其它

查看项目

更新于 10-15 21:35

技能介绍

用途:在长时间、多步骤任务中把当前分析上下文、发现与进度写入外部检查点文件,防止上下文丢失。它是 memory-management(Part 1:基于文件的外部记忆)中 CHECKPOINT_CREATE 协议的用户入口;memory-management 本身不可直接由用户调用,因此该命令是创建手动检查点的规范方式。

主要能力:收集任务状态、关键发现(含 file:line)、已分析/修改的文件、进度、决策、下一步与未决问题;按 CHECKPOINT_CREATE 模板写入检查点文件;同步更新任务跟踪。文件保存路径为 plans/reports/checkpoint-{YYYYMMDD}-{HHMMSS}-{slug}.md,文件名时间戳由 date +%Y%m%d-%H%M%S 生成。必需章节包括 Task Context、Key Findings、Files Analyzed、Progress、Important Context、Next Steps、Recovery Instructions。

使用方式:在复杂多步任务、预期上下文压缩前、功能开发关键里程碑或完成重要分析阶段后调用。恢复时使用 $recover(CHECKPOINT_RECOVER 协议)。相关命令还有 $context、$compact、$watzup。建议每 30-60 分钟保存一次,内容具体到文件路径与行号,记录决策原因并包含恢复步骤。

限制:检查点结构由 memory-management Part 1 单一定义,本技能仅作命令入口,不重复模板;在 Codex 中需以 $skill-name 调用,并忽略 Claude 专有模式切换指令;若所需步骤或工具在当前环境无法运行,应先停止并询问用户。其余平台与收费信息暂未提供。