loop-me 教程与原理
把生活里的重复模式炼成可执行的工作流规格

- 类型:知识点问答(教程 + 设计原理 + 实用性评估)
- 来源:GitHub 官方源码 + 官方 README + 第三方资料(见文末「资料来源」)
- 整理时间:2026-11-22
- 状态提示:loop-me 位于官方仓库
skills/in-progress/,属 beta,可随时改动或消失,且不随插件分发 [2]
一句话解释
loop-me 是一个 beta skill:用 /grilling 的追问方式,把生活中反复发生的事拷问成可直接实现的工作流规格,写进 workflows/*.md。[1][2]
核心要点
- 输入是「loop(循环)」:职业节奏、每周节奏、早晨例行、任何重复活动。生活是「大 loop 套小 loop」,可预测才值得委托。[1]
- 输出只有 spec:唯一交付物是
workflows/*.md;它不实现、不调度、不写代码,只保证实现者读后「一个问题都不用问」。[1] - 有状态:与
grill-me无状态不同,它把进度和术语写进工作区文件,支持跨会话继续。[1][5] - 手动触发:
disable-model-invocation: true,Agent 不会自己启动。[1][3] - 强约束很少:不强制 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-meargument-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 尽量往后推,先把活干完,再一次性、晚一点、带着完整材料问你 |
| Brief | checkpoint 给你的不是原始输出,而是一页可决策摘要:产出了什么、为什么、链接到资产本身 |
第 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]
资料来源
- loop-me/SKILL.md(官方源码) — 全部核心规则、loop lens、词汇表、DoD、工作区结构
- in-progress/README.md(官方) — beta 状态、安装方式、不随插件分发
- grilling/SKILL.md(官方源码) — 轮次、frontier、推荐答案、事实 vs 决策
- 官方文档:grill-me — 无状态对照、一次一问配置、原语定位
- WQU:开源 Skills 系列新增 loop-me — 中文二手解读与设计哲学;「一次一问」与官方源码冲突,未采信
- GitHub commit bfdaef8 — 2026-07-31「describe grilling as round-by-round everywhere」,佐证官方轮次口径
- implement-spec/SKILL.md(官方源码) — spec 到实现的下游 skill
- SoFarBot:loop-me — 第三方安装命令与能力摘要
