这个 Skill 能做什么,适合哪些场景?
checkpoint-mode 是 Loki Mode 自治框架中的一个编排器技能,实现"选择性自治"模式。它不再是让代理无限自主运行,而是每处理 N 个任务或 M 分钟后暂停,生成已完成工作、下一步计划和资源消耗的总结,然后等待用户在信号目录中写入批准文件才继续。该模式源自 Tim Dettmers 的研究文章《Use Agents or Be Left Behind》。对于方法尚需调整的新项目、高成本操作以及需要审计留痕的受监管环境,它比完全自主的"永续模式"更合适。
- 按任务数(LOKI_CHECKPOINT_FREQUENCY)或时间(LOKI_CHECKPOINT_TIME)触发暂停,并在架构、部署等指定阶段后强制暂停
- 生成检查点总结:已完成任务、下一步行动、耗时、所用代理与预估成本
- 在 .loki/signals/ 写入 CHECKPOINT_SUMMARY 文件并轮询等待 CHECKPOINT_APPROVED 信号
- 用户批准后移除信号并恢复工作流
- 将检查点效果指标(任务数、批准耗时、返工次数)记录到 .loki/metrics/checkpoint-mode/
- 开发方法尚未定型的新项目,用户希望每 10 个任务左右审阅一次方向
- 涉及昂贵 API 调用或云资源的高成本操作,需要人工把关后再继续
- 受监管环境要求保留阶段性审批的审计轨迹
- 学习新领域时,用户想通过定期检查点引导代理的路线
- 需求明确、需要通宵无人值守构建的场景——SKILL.md 明确建议这类情况用永续模式(Perpetual Mode)
- 生产部署等关键系统需要每步审批的,应使用监督模式(Supervised Mode)而非检查点模式
如何安装这个 Skill?
- Shell / 命令行
- 本地文件系统
Loki Mode runtime (LOKI_AUTONOMY_MODE env vars)orchestrator agent typesignal directory .loki/signals/
该技能随 Loki Mode 仓库一起分发(仓库整体提供 npm、Homebrew、Docker 等安装方式),技能本身位于 agent-skills/checkpoint-mode/。安装 Loki Mode 主程序后即可使用:
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/asklokesh/loki-mode.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/agent-skills/checkpoint-mode" ~/.claude/skills/
rm -rf "$tmp"根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。
如何使用这个 Skill?
安装后,把下面任意一句发给 Agent 即可触发:
- 用检查点模式构建这个新项目,每 10 个任务暂停给我看总结
- 设置 LOKI_AUTONOMY_MODE=checkpoint 并在架构阶段后强制暂停
- 给我看一下最近一个检查点的总结和指标
通过环境变量启用并配置,由编排器代理在运行时自动遵循:
LOKI_AUTONOMY_MODE=checkpoint
LOKI_CHECKPOINT_FREQUENCY=10
LOKI_CHECKPOINT_TIME=60
LOKI_CHECKPOINT_PHASES="architecture,deployment"运行时:代理完成达到阈值数量任务后暂停,写入 .loki/signals/CHECKPOINT_SUMMARY_*.md,人工审阅后创建 .loki/signals/CHECKPOINT_APPROVED 文件,代理检测到该信号即恢复工作。
这个 Skill 有哪些优点和局限?
- 在浪费资源于错误方向之前提供纠偏机会
- 暂停时输出包含任务、成本、代理使用情况的透明总结
- 每个检查点可记录为指标,便于审计与调优
- 配置简单,纯环境变量驱动,可与永续/监督模式按场景切换
- 依赖 Loki Mode 运行时与信号文件机制,不能脱离该框架独立使用
- 需要人工在环,频繁批准会拖慢完全自动化场景的进度
- 文档中的 Python 伪代码是示意性指令,并非可独立执行的脚本
- 仓库许可为 BUSL-1.1(源码可得但非传统开源),商业使用需注意许可条款
这个 Skill 与同类方案有什么区别?
与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| Loki 检查点模式(Checkpoint Mode) 本页 | 68 · 推荐 | ★ 1.1k | 17 天前 | NOASSERTION |
| Harness — 智能体团队架构工厂 | 50 · 谨慎使用 | ★ 9.2k | 28 天前 | Apache-2.0 |
| 多智能体架构模式 | 55 · 谨慎使用 | ★ 18k | 14 天前 | MIT |
| 计划执行编排器 | 51 · 谨慎使用 | ★ 101k | 12 天前 | Apache-2.0 |
| 循环预算守护 | 29 · 不推荐 | ★ 12k | 11 天前 | MIT |
SKILL.md 自带与永续模式(从不暂停,适合过夜构建)和监督模式(每个任务都需批准,适合关键系统)的对比:检查点模式介于两者之间,默认每 10 个任务审批一次。
FollowSkills 如何评估这个 Skill?
与主技能相反方向的设计——「选择性自主」模式,每 N 个任务暂停一次等待人工批准,明确列出何时该用检查点模式、何时该用永久自主模式,这是同一生态里更谨慎的一个子技能。
点击维度查看打分理由
证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。
本条评估按 FSRS 1.0 标准完成,维度分不做换算,已进入按 FSRS 2.0 重新评估的复核队列。
查看完整评分方法 →