2026-11-22-loop-me教程与原理_cover_960x480.png

  • 类型:知识点问答(教程 + 设计原理 + 实用性评估)
  • 来源:GitHub 官方源码 + 官方 README + 第三方资料(见文末「资料来源」)
  • 整理时间:2026-11-22
  • 状态提示:loop-me 位于官方仓库 skills/in-progress/,属 beta,可随时改动或消失,且不随插件分发 [2]

一句话解释

loop-me 是一个 beta skill:用 /grilling 的追问方式,把生活中反复发生的事拷问成可直接实现的工作流规格,写进 workflows/*.md。[1][2]

核心要点

  1. 输入是「loop(循环)」:职业节奏、每周节奏、早晨例行、任何重复活动。生活是「大 loop 套小 loop」,可预测才值得委托。[1]
  2. 输出只有 spec:唯一交付物是 workflows/*.md;它不实现、不调度、不写代码,只保证实现者读后「一个问题都不用问」。[1]
  3. 有状态:与 grill-me 无状态不同,它把进度和术语写进工作区文件,支持跨会话继续。[1][5]
  4. 手动触发:disable-model-invocation: true,Agent 不会自己启动。[1][3]
  5. 强约束很少:不强制 AI、不强制 checkpoint、不强制 schedule;这些必须由拷问结果决定。[1]

教程:从零到一份 spec

第 0 步:安装

官方仓库处于 in-progress,插件不包含它,必须单独装;且它依赖 grilling 访谈纪律,建议两者一起装。[2][3]

# 方式 A:skills CLI(Claude Code / Cursor / 70+ agent)
npx skills@latest add mattpocock/skills --skill=loop-me
npx skills@latest add mattpocock/skills --skill=grilling

# 方式 B:手动
git clone https://github.com/mattpocock/skills.git
# 复制 skills/in-progress/loop-me 与 skills/productivity/grilling
# 到目标 agent 的 skills 目录,如 ~/.claude/skills/

loop-me 的 openai.yaml 明确 allow_implicit_invocation: false,即只能用户手动调用。[3]

第 1 步:准备一个工作目录

它把当前目录当状态工作区。建议为「个人运营系统」单开一个文件夹,避免 spec 混进项目仓库。

mkdir ~/loops && cd ~/loops

它会维护两个位置:[1]

路径作用
workflows/*.md一个 loop 一份 spec,唯一真相源;可被创建、编辑、删除
NOTES.md记录你的真实世界:用的工具、处理的渠道、你自己的术语

第 2 步:启动

/loop-me

argument-hint 写的是「A workflow to design, or nothing to go find one」:[1]

  • 带想法:/loop-me 我想把每天整理 AI 资讯的流程固定下来
  • 不带:让它用 loop lens 主动帮你找「你没意识到但一直在重复」的事。

第 3 步:回答追问

它跑的是 grilling 纪律:[1][3]

  • 把想法画成设计树,每个决策下挂子决策。
  • 每轮只问 frontier:前提已确定、当下能答的问题。
  • 每题编号,并附 ➡️ 推荐答案;问法保证「yes 即接受推荐」。
  • 依赖本轮未答问题的,排到下一轮;答完重算 frontier。
  • 能查文件/工具就自己查(必要时派 sub-agent),不把事实问题抛给你。
⚠️ 资料冲突:有第三方文章写「一次一问」[5],但官方 grilling 源码明确「一轮问完整 frontier」[3],且官方 2026-07-31 提交名为「describe grilling as round-by-round everywhere」[6]。以官方为准。想一次一问,按官方文档可在全局 CLAUDE.md 加一句 When grilling, ask one question at a time.

第 4 步:拷问的四个核心词

这些词不是清单,只在 spec 需要时才启用:[1]

词含义
Trigger每次运行由什么触发:事件(新邮件、新 issue)或定时(每天早上)。事件驱动通常更高效
Checkpoint人在回路的确认点。可以没有,全自动;也可以完全不用 AI
Push right把 checkpoint 尽量往后推,先把活干完,再一次性、晚一点、带着完整材料问你
Briefcheckpoint 给你的不是原始输出,而是一页可决策摘要:产出了什么、为什么、链接到资产本身

第 5 步:完成标准

spec done 的定义只有一条:实现者 agent 读完不需要再问任何问题。[1]
会话中它会边问边改 workflows/*.md,并把新术语打磨成规范词记进 NOTES.md。疑问没挖尽,就不算完成。

一个可预期的过程(示意,非实录)

你:/loop-me 我想固化「每周整理炼知炉内容」这件事
它:Q1 触发方式?(推荐:每周日晚上事件触发,而非固定 cron)
    Q2 人需要在哪一步介入?(推荐:只在选选题时,发布前不介入)
    ...
你:1 yes;2 只在选题时
它:Q3 若本周没有新材料怎么办?...(下一轮)

这是根据源码规则构造的示意对话,不是官方录制的运行记录。[1][3]

设计原理分析

1. 从「重复模式」切入,而非从「我要一个 Agent」切入

大多数自动化失败在起点:先选工具,再找事做。loop-me 反过来——先用 loop lens 找出生活里已经在重复的事,判断可预测性,再谈委托。[1]
分析:这是一个很强的需求发现框架。它承认「值得自动化」的东西往往不是宏大流程,而是你每周都在做、却从没写下来的小事。

2. Spec 是唯一交付物,实现被刻意排除

源码只有一句核心命令:Run a stateful /grilling session whose only output is workflow specs.[1]
分析:把「想清楚」和「做出来」彻底解耦。好处是 spec 可读、可 diff、可交给任何实现者;代价是它本身不产生自动化,用户必须再接 implement-spec 等实现 skill [7],否则会停在纸面。

3. 复用 grilling 原语,但把状态外置到文件

grill-me 无状态、loop-me 有状态;同一套追问纪律,前者产出共识,后者产出文件。[1][4]
分析:这是「同一访谈内核 + 不同持久化策略」的架构。跨会话能力来自文件系统而非模型记忆,因此可版本化、可审阅、可中断。但也意味着它绑定工作目录,换了目录就等于失忆。

4. 反模板化:只给词汇,不给结构

源码明确:词汇表「never a checklist」,且「Mandate nothing structural」——没有 AI / checkpoint / schedule 是默认。[1]
分析:这是与多数 workflow 模板相反的取向。它避免「为了用 Agent 而造 Agent」,但也把质量压力交给提问者:一个不会回答的人,会被拷问出一堆看似完整、实则空洞的 spec。

5. Push right + Brief 是对人类注意力的显式定价

源码把 checkpoint 定义成「晚到的、一次性的、带着 decision-ready brief 的决策」,并写明「Speed of review is imperative」。[1]
分析:这是整个人机分工里最值钱的一条。多数自动化把人当路由器,频繁打断;它把人当最终审批者。设计上把人类的稀缺资源(注意力)放在最不可替代的位置。

实用性评估

适合

  • 已有一件重复了几十次、你却从没写下来的事:周报、内容整理、账单、复盘。
  • 你要把流程交给别人或另一个 agent 实现,需要零歧义的 spec。
  • 你在做个人运营系统,希望术语和流程跨会话稳定。[1][5]

不适合

  • 只想快速做一次的事:直接用普通对话更快。
  • 需要立刻看到可运行自动化:它只出 spec,不出实现。[1]
  • 谈不出来的问题(界面长什么样、体验如何):先做原型,再回来写 spec。[4]
  • 没装 grilling:只装 loop-me 可能跑不起来;官方 README 的批量安装命令也只列了单个 skill。[2][3]

风险

  • beta 风险:位于 in-progress,不进插件、无正式文档页、可随时变更或删除。[2]
  • 依赖风险:与 grill-me、grill-with-docs 同源,若 grilling 未加载,会退化成「一次性问完且无推荐答案」。[3]
  • 空转风险:Definition of Done 很严格,范围大时会话可能极长;官方通用建议是先拆小块。
  • 点头风险:一路 yes 会得到一份你没真正决定过的 spec。[4]

综合判断:它是一个「需求编辑器」,不是「自动化生成器」。价值集中在把隐性重复劳动显性化;如果你的问题已经是「怎么实现」,它帮不上太多。

延伸方向

  • grilling:访谈原语,控制追问节奏。[3]
  • grill-me:无状态版,适合对齐任意计划。[4]
  • implement-spec / to-spec:把 spec 推进到实现或结构化PRD。[7]
  • writing-fragments / writing-beats:同仓库 in-progress 的写作类 skill,同样基于拷问。[2]

资料来源

  1. loop-me/SKILL.md(官方源码) — 全部核心规则、loop lens、词汇表、DoD、工作区结构
  2. in-progress/README.md(官方) — beta 状态、安装方式、不随插件分发
  3. grilling/SKILL.md(官方源码) — 轮次、frontier、推荐答案、事实 vs 决策
  4. 官方文档:grill-me — 无状态对照、一次一问配置、原语定位
  5. WQU:开源 Skills 系列新增 loop-me — 中文二手解读与设计哲学;「一次一问」与官方源码冲突,未采信
  6. GitHub commit bfdaef8 — 2026-07-31「describe grilling as round-by-round everywhere」,佐证官方轮次口径
  7. implement-spec/SKILL.md(官方源码) — spec 到实现的下游 skill
  8. SoFarBot:loop-me — 第三方安装命令与能力摘要