name: loop-me description: "在这个工作区内,围绕我想构建的工作流规格盘问我。" disable-model-invocation: true argument-hint: "要设计的工作流;也可留空,让我寻找"
把重复生活模式整理成工作流规格
这是实验性技能。它从你反复做的事中寻找可描述的循环,输出工作流规格,不负责自动运行它们。
还不清楚 Skill、Agent、安装和调用?先读 从零开始的6节入门课。
作者将它放在 in-progress,未作为稳定插件内容推广。先理解原理,实际使用前核实版本和依赖。
先把必要的概念讲清楚
本课把生活中反复发生的活动转成明确工作流。先理解触发、执行、反馈和人的决定,再判断哪些部分适合 AI;不能见到重复活动就一律自动化。
下面是老师补充的入门说明;原作者的要求保留在中英对照正文中。所有例子均为帮助理解而构造的教学情境。
state machine|状态与允许的转换
列出对象可能处于哪些状态,以及什么事件允许它从一个状态变为另一个。例如工单从待澄清到可执行,再到实施中,最后验收完成。不能仅因为“写完代码”就跨过验收。状态机让进度含义明确,而不仅是漂亮的标签。
acceptance criteria|验收条件
明确规定结果满足什么才算完成,应尽量可观察、可检验。例如“收藏后刷新页面仍可见,重复点击只保留一条”。“体验很好”“代码完善”没有明确边界,难以判断。验收条件关注结果,不是把实现步骤换个标题列出来。
context|Agent 当前可用的上下文
模型这一轮实际能使用的请求、对话、指令和已读文件内容。它不是电脑上所有资料,也不是永久记忆。文件存在但没被读到,就不一定参与推理。交接文档应指明当前目标、进度、关键证据位置和下一步,让新会话能够恢复必要背景。
读原文,理解每一步为什么这样做
左右内容按小节对应;窄屏先中文、后英文。两种语言均完整展示,对应讲解紧接在小节之后。译文传达原文要求;老师讲解补充概念、原因、例子与适用边界。
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 讨论,唯一产出是工作流规格。持续深入追问,一次一轮,每个问题附推荐答案。围绕下面的概念和目标提问,并随认识明确而创建、修改或删除规格。
Run a stateful /grilling session whose only output is workflow specs. Use the grilling discipline (relentless, a round of questions at a time, a recommended answer attached to each) aimed at the vocabulary and goal below. Create, edit, and delete specs as the grilling resolves things.
从重复活动看工作流
loop 是用户生活里反复出现的活动模式,可以是一周安排、每天早晨,或者一项重复小事。把生活看作嵌套循环,可以发现活动的规律;有可预测规律的工作,才值得进一步考虑委托。
用这个角度寻找值得写明的循环,也提出用户尚未注意到的候选。
workflow 是一个循环的具体规格;按它实际运行,就产生这个循环的一次实例。工作流保存到 workflows/*.md,作为如何执行的正式依据。
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 loops within loops reveals how predictable its activities really are, which is what makes them worth delegating. Use the lens to find loops worth specifying, 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 the source of truth.
循环是实际重复,工作流是对它的描述
每天收集课程材料、整理待复习问题、每周回顾理解变化,都是不同尺度的循环。工作流规格写明一次运行何时开始、做什么、得到什么。
例如“每天复习”太模糊;“每天晚间读取未掌握记录,选三道相关情境题,用户回答后记录误解”更接近可实现工作流。是否自动定时,需要结合你真正的习惯。
作者明确不强制每个工作流都用 AI、都有人工检查点或时间表。固定规则的简单整理,有时普通脚本已经足够。
共同词汇
只在具体工作流需要时使用这些词,不把它们当成每项都必须具备的清单。不要强制结构:除非追问说明需要,否则工作流不一定有 AI、人工检查或时间表。
- 触发条件 Trigger:什么事情启动一次运行,可以是新邮件、新工单等事件,也可以是每天早晨等定时安排。作者认为事件触发通常更有效率。
- 人工检查点 Checkpoint:在哪里请用户核实或决定。有的流程可以自主运行,没有此环节;有的甚至不用 AI。
- 尽量延后人工介入 Push right:在可行范围内,先尽量完成准备,再请用户集中处理一次。让他介入时已有足够材料。
- 决策简报 Brief:向用户提供简明、可供判断的说明,包括生成了什么、为什么以及完整成果链接。不要只扔出原始产物。用户先读简报,审阅速度很重要。
Vocabulary
A shared language, reached for only when a workflow calls for it: never a checklist. Mandate nothing structural: 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). Event-triggering is usually the more efficient.
- Checkpoint: a human-in-the-loop point where the user is asked to verify or decide. Some workflows have none and run autonomously; some use no AI at all.
- Push right: defer the checkpoint as far as it will go. Do maximal work before involving the human, so they are asked once, late, with everything prepared.
- Brief: what a checkpoint presents, a tight, decision-ready summary (what was produced, why, and a link down to the asset itself), never the raw output. The user reads a brief, not a draft. Speed of review is imperative.
把人工检查放在材料已经准备充分的位置
Trigger 可以是事件或时间;Checkpoint 是需要你确认或决定的时点;Brief 是给你快速判断的简报。Push right 指在条件允许时尽量晚一点请你介入,先完成可自主准备的工作。
例如发布学习文章前,AI 可以先整理素材、形成草稿、核对引用和列出不确定处,再一次性交给你审阅。每写一个段落就问“是否继续”,会把你变成进度按钮。
但不能把需要你定目标的决定拖到大量实现之后,也不能因为想减少打扰就绕过权限。推迟的是不必要的提前打断,不是必须的人类判断。
以每周发布学习记录为例,理解工作流的几个环节
你每周整理笔记、选主题、形成文章并审阅,这是重复活动。把输入、步骤、判断和产物写清楚,就形成工作流规格;下周执行一次,是这份规格的一次运行。
触发可以是每周五,也可以是你将某份笔记标为可写作。人工检查点可以是你判断文章是否代表自己的观点。若素材已充分,AI 可以先完成草稿和待确认事项,再集中请你看。
简报例如:“文章讨论清空上下文,保留一个亲身案例,有一处项目名称待确认,全文在此。”它帮助你知道该判断什么,并不禁止你阅读全文。
原文“无需再问一个问题”是充分说明的目标。实际出现新事实时仍应提出,不能为了符合完成标准假装没有未知。
完成标准
当实现 Agent 能依据规格构建流程,不必再提问时,规格才算完成。继续追问,直到剩余问题都解决。
Definition of done
A workflow spec is done when an implementer agent could build it without asking a single question. Grill until then; nothing is done while a question remains.
无须再问问题,是规格充分性的目标
作者把完成标准设为实现者可以直接构建。你可以用输入、触发、行为、异常、输出和人工决定逐项检查是否仍有空白。
例如来源抓取失败时是否继续、没有待复习题时显示什么、用户不作答时如何处理,都是会影响执行的边界。不是所有细节都要由你选,但应有明确默认或授权范围。
NOTES.md 记录你的真实习惯和术语,workflows 文件记录确认的工作流。不要把今天一时的尝试直接当成长久执行规则。
工作区文件
workflows/*.md:每个工作流一份规格。NOTES.md:记录用户真实工作、工具、信息渠道及其叫法。内容不足时,先了解用户生活,再拟定工作流。遇到含糊名称,澄清成统一术语并记录。
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. Sharpen fuzzy terms into canonical ones as they surface, and record them here.
先作答,再看参考思路
用自己的话说明:它解决什么问题,完成后会留下什么?
请各用一句话回答。若它只做规划或解释,不要把“已开发”“已部署”写成产物。
为什么“每个工作流都要有 AI”违背这份技能?
我已思考,查看参考思路
它要求按活动需要选择结构。有些任务可由确定性程序完成,强加 AI 会增加成本和不确定性。
原文中哪条要求在你的环境下可能不成立?
说出具体一句及其前提,例如工具不可用、资料缺失、已有项目约定冲突,或它只是作者偏好。把你的答案带回课堂,我们据此继续讨论。
把方法放进一个具体情境
教学案例:每周整理学习记录,可以先由 AI 汇集候选与证据,再由你决定哪项值得写文章。不是每个循环都需要定时发送公众号;发布可以保持人工。
边界与容易误读的地方
规格里写了“每天执行”不会自动创建调度任务。验收应区分流程设计完成与调度真正启用。
讨论后再实践:先判断上述情境是否适用,再选择真实任务。现在无需安装、运行命令或修改现有项目。