开发与工程

Loki 检查点模式(Checkpoint Mode)

让自治编码代理每完成 N 个任务就暂停、生成总结并等待人工批准,在自主性与可控性之间取得平衡。

68/ 100
推荐

整体可靠,存在已披露的局限;按说明试用并保留回滚路径。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 1.1k
最近更新
17 天前
License
NOASSERTION
selective-autonomyorchestrationcheckpoint-reviewapproval-signal
+3agent-workflowcost-controlaudit-trail

这个 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?

开始前你需要
Agent 需要具备
  • Shell / 命令行
  • 本地文件系统
需要预先安装
  • Loki Mode runtime (LOKI_AUTONOMY_MODE env vars)
  • orchestrator agent type
  • signal directory .loki/signals/

该技能随 Loki Mode 仓库一起分发(仓库整体提供 npm、Homebrew、Docker 等安装方式),技能本身位于 agent-skills/checkpoint-mode/。安装 Loki Mode 主程序后即可使用:

通用方式:手动安装到 Claude Code(macOS / Linux)
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?

FollowSkills 评估 · FSRS-1.0
推荐
68/ 100 五分制 3.4 / 5
1价值适配14 / 20 · 3.5/5

与主技能相反方向的设计——「选择性自主」模式,每 N 个任务暂停一次等待人工批准,明确列出何时该用检查点模式、何时该用永久自主模式,这是同一生态里更谨慎的一个子技能。

2可靠性13 / 20 · 3.3/5
3安全性21 / 25 · 4.2/5
4证据6 / 15 · 2.0/5
5易用性8 / 10 · 4.0/5
6维护性6 / 10 · 3.0/5
1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年7月17日 评估证据[1]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

本条评估按 FSRS 1.0 标准完成,维度分不做换算,已进入按 FSRS 2.0 重新评估的复核队列。

查看完整评分方法 →

常见问题

暂停频率可以调整吗?
可以。LOKI_CHECKPOINT_FREQUENCY 控制任务数阈值,LOKI_CHECKPOINT_TIME 控制分钟数阈值,LOKI_CHECKPOINT_PHASES 可指定架构、部署等阶段后强制暂停。
批准流程是怎样的?
代理在暂停时写入 .loki/signals/ 下的检查点总结文件;你审阅后手动创建 CHECKPOINT_APPROVED 信号文件,代理检测到该文件即恢复执行。
它会产生额外成本吗?
检查点总结会记录每次的代理使用与预估成本(示例中为 15 分钟、$0.45),定期暂停反而有助于在高成本操作失控前止损。
这个技能基于什么研究?
SKILL.md 标注研究来源为 Tim Dettmers 2026 年的文章《Use Agents or Be Left Behind》,其核心观点是超过 90% 的代码应由代理编写,但要以带反馈回路的短促自治爆发迭代推进。

同仓库的其他 Skills

均来自 asklokesh/loki-mode

相关 Skills