Skill Learning

loop-me

1. Bilingual SKILL.md

左右滑动可直接切换英文版与中文版；两种语言按段落自动对齐。英文中的蓝色虚线词语可点击查看解释。共标记 14 处。

入口 skill：loop-me左右滑动切换语言 · 段落位置自动对齐
Run a stateful `/grilling` session whose only output is **workflow** specs. Use the grilling discipline (relentless, , a recommended answer attached to each) . Create, edit, and delete specs as the grilling resolves things.
## The loop lens
A **loop** is a recurring pattern in the user's life: their career, their week, their morning, a single repeated activity. Picturing a life as reveals how predictable its activities really are, which is what makes them worth **delegating**. Use the lens to find loops , and propose ones the user hasn't noticed.
A **workflow** is the spec of one loop, made real. You run a workflow on a loop: the loop is its running instantiation. Workflows live in `workflows/*.md` and are .
## Vocabulary
A shared language, : never a checklist. ****: a workflow needs no AI, no checkpoint, and no schedule unless the grilling shows it does.
- **Trigger**: what fires each run, an **event** (a new email, a new issue) or a **schedule** (every morning). . - **Checkpoint**: where the user is asked to verify or decide. Some workflows have none and run autonomously; some use no AI at all. - **Push right**: . Do maximal work before involving the human, so they are asked once, late, with everything prepared. - **Brief**: what a checkpoint presents, a tight, (what was produced, why, and a link down to the asset itself), . The user reads a brief, not a draft. Speed of review is imperative.
## Definition of done
A workflow spec is done when an implementer agent could build it . Grill until then; nothing is done while a question remains.
## The workspace
- `workflows/*.md`: one spec per workflow. - `NOTES.md`: raw notes on the user's world, the tools they use, the channels they process, and their own terminology for both. When it is empty or thin, interview them about their world before specifying anything. , and record them here.
Source metadata
--- name: loop-me description: Grill me about specs for the workflows I want to build, within this workspace. disable-model-invocation: true argument-hint: "A workflow to design, or nothing to go find one" ---
运行一个有状态的 `/grilling` 会话，其唯一输出是**工作流（workflow）**规格。采用 grilling 的纪律（坚持不懈、每次提出一轮问题、每个问题都附带推荐答案），并将其对准下文的词汇与目标。随着 grilling 消除歧义，创建、编辑和删除规格。
## Loop 视角
**Loop** 是用户生活中反复出现的模式：可能贯穿职业、每周、早晨，也可能只是某个重复活动。把人生想象成层层嵌套的 loop，会揭示其中的活动究竟有多可预测；正因如此，它们才值得被**委派（delegating）**。用这副视角寻找值得规格化的 loop，并提出用户自己尚未注意到的候选项。
**工作流（workflow）**是某个 loop 的规格，并把它变为现实。你在一个 loop 上运行 workflow：loop 是 workflow 正在执行的实例。工作流存放在 `workflows/*.md` 中，并且是权威来源（source of truth）。
## 词汇
这是一套共享语言，只在某个 workflow 确实需要时才取用，绝不是检查清单。**不强制任何结构**：除非 grilling 证明有必要，否则 workflow 不需要 AI、不需要 checkpoint，也不需要 schedule。
- **Trigger（触发器）**：每次运行由什么启动，可以是**事件（event）**（新邮件、新 issue），也可以是**日程（schedule）**（每天早晨）。事件触发通常更高效。 - **Checkpoint（检查点）**：需要用户核验或决策的人在回路（human-in-the-loop）节点。有些 workflow 完全没有 checkpoint，可以自主运行；有些甚至完全不用 AI。 - **Push right（向右推）**：把 checkpoint 尽可能后移。在让人介入之前先完成最大量的工作，使其只需在较晚阶段被询问一次，而且所需材料均已备妥。 - **Brief（简报）**：checkpoint 所呈现的紧凑、可直接决策的摘要（产出了什么、为什么，以及下钻到资产本身的链接），绝不是原始输出。用户阅读的是 brief，而不是草稿。审阅速度至关重要。
## 完成定义
当实现者 agent 无需提出任何一个问题就能构建 workflow 时，这份规格才算完成。持续 grilling 直到达到这一点；只要还有问题未决，就不能算完成。
## 工作区
- `workflows/*.md`：每个 workflow 一份规格。 - `NOTES.md`：记录用户世界的原始笔记，包括他们使用的工具、处理的渠道，以及他们对这两者采用的本地术语。当它为空或内容单薄时，先采访用户、了解他们的世界，再开始制定任何规格。模糊术语一出现，就把它们收敛成标准术语，并记录在这里。
Source metadata
--- name: loop-me description: 针对我想在此工作区构建的工作流规格持续追问。 disable-model-invocation: true argument-hint: "一个要设计的工作流；若留空，就去寻找一个" ---

Entry SHA-256: e44d1cc3e760fb86ac42964c2a5f1fcac511715db50fb375f3f7be814de1eaa7

2. Why This Skill Is Clever

一句话核心机制

把用户生活和工作中的重复模式视为“loop”，通过严格分轮追问把值得委派的 loop 收敛成实现者无需再提问即可构建的 workflows/*.md 规格。

触发与边界

信息架构 / 执行顺序

  1. 确认目标 workflow；若没有，就从用户世界中寻找重复 loop。
  2. 当 NOTES.md 内容不足时，先采访用户，补齐工具、渠道与本地术语。
  3. 使用“loop lens”判断哪些重复活动足够可预测、值得规格化与委派。
  4. 按轮追问，每个问题附推荐答案；随着歧义消失，持续创建、编辑或删除规格。
  5. 只在证据要求时使用 Trigger、Checkpoint、Push right、Brief 等词汇，不把它们变成模板清单。
  6. 以“实现者无需再问一个问题”为停止条件，将 workflows/*.md 作为权威记录。

最巧妙的设计点

1. 先给观察世界的镜头，再给结构

“Picturing a life as loops within loops”

Direct source： skill 不从字段模板开始，而是先教模型发现跨日、周、职业乃至单次活动中的重复模式。这样能找到用户尚未命名、但已经稳定存在的候选流程。

2. 词汇是按需工具，不是合规清单

“never a checklist”

Direct source： Trigger、Checkpoint、Brief 等词汇只在具体 workflow 需要时使用，且明确要求 Mandate nothing structural。这阻止模型因为见过一个完整模板，就给每个流程硬加 AI、日程和人工审批。

3. 把人工注意力当作昂贵资源

“asked once, late, with everything prepared”

Direct source： Push right 不等于删除人工控制，而是让自动化先完成最大限度的安全准备，再把一个决策就绪的 brief 交给人。这同时保留控制权并减少上下文切换。

4. 完成条件以接手者为中心

“without asking a single question”

Direct source： Definition of done 不是“写了一份文档”，而是“另一位实现者是否还能发现未决问题”。这个可操作的删除歧义测试，比页数或字段齐全更接近真实可实施性。

5. 规格是可变资产，不是会话副产品

“Create, edit, and delete specs”

Direct source： 追问过程中允许删除错误方向，而最终以 workflows/*.md 为 source of truth。会话负责探索，文件负责持久化，二者职责清楚。

防失败机制与 trade-off

可迁移原则

  1. 先定义发现问题的 lens，再定义输出 schema。
  2. 把领域词汇设计成按需工具箱，而不是所有项目都必须填满的模板。
  3. 人工检查点尽量后移，但必须停在不可逆或高风险动作之前。
  4. 用接手者能否直接实施来验收规格，而不是用文档长度验收。
  5. 把探索记录与权威资产分离，并明确发生冲突时以谁为准。

今日实践题

选一个你每周都会重复的活动：它的真实 Trigger 是什么？如果把 Checkpoint 尽量 push right，系统最多可以提前准备到哪一步，又必须在哪个不可逆动作前停下？

Evidence note

本文的流程、术语、边界与引用均来自选中的 loop-me/SKILL.md；agents/openai.yaml 仅用于佐证显式调用边界，没有混入双语原文。所有关于可移植性、隐私和访谈时长的判断都标记为 Interpretation。

Source & provenance
Repository path
skills/in-progress/loop-me/SKILL.md
Generated
2026-08-28 15:42 Asia/Shanghai
Upstream commit
6654f6b60cd9d5be8b54c6fafe44346dabeb3b76
Source
View on GitHub

Source: mattpocock/skills · Original content remains under its upstream license. Translation and commentary are for personal learning.