SuperAPI AI 工具集

checkpointed-agent-loop

智能体与模型

查看项目

更新于 10-15 20:33

技能介绍

用途:当迁移、重构、测试修复或调查可能跨多个会话,需要有限重试,或在宣告完成前必须留下验证证据时,可用此技能。它不适用于单行编辑,或已有自身持久化运行器的工作流。

主要能力:在普通 Claude Code 工作外增加一个本地检查点文件,让新上下文从显式状态恢复,而非从聊天记录重建进度。状态仅允许 planned→running,running→verifying|failed|blocked,verifying→succeeded|running|failed|blocked;succeeded、failed、blocked 为终态。进入 running 消耗一次尝试,不能超过 maxAttempts;没有至少一条通过的验证证据时,拒绝转为 succeeded。

使用方式:先设置 SKILL_DIR 与 CHECKPOINT,用 init 初始化并指定有限预算,例如 node "$SKILL_DIR/scripts/checkpoint-loop.mjs" init --file "$CHECKPOINT" --task "data-migration" --objective "..." --max-attempts 3 --next-action "..."。每次有界尝试前 transition 到 running,动作后转到 verifying,自行运行检查并用 evidence 记录检查名、结果与安全产物路径,再决定 succeeded、重试 running、failed 或 blocked。新会话先运行 status --file "$CHECKPOINT" --format summary 恢复。

限制:该 Node.js 工具只存储状态与证据,不执行命令、不调用模型、不生成智能体、不访问密钥或网络;实际工具调用与人工审批仍由 Claude Code 负责。检查点不得写入密钥、令牌、密码、个人数据或含密日志;破坏性操作、外部写入、支付、部署和权限变更仍需正常人工审批。畸形或被手工改动的检查点应视为无效并停止复核。资料未提供收费、价格或平台支持信息。