loop-three-elements

Source Metadata

Original cangjie-skill frontmatter from the distillation run:

name: loop-three-elements
description: |
  设计或审计任何循环系统的起点: 将循环拆解为 Trigger(触发器)、Action(动作)、Stop Condition(停止条件) 三要素。
  当用户需要设计一个新循环、诊断一个失效循环、或向他人解释"什么是 Loop"时使用。
  不适用于: 单次任务执行、非循环的自动化脚本、或已经稳定运行无需重新设计的系统。
  关键 trigger: "设计一个 loop"、"这个循环为什么不停止"、"什么是 loop 的最小结构"。
source_book: "Loop Engineering 视频合集 (Gillock/Cherny/Steinberger/Idoos Money/小木头)"
source_chapter: 视频1/3/4
tags: [loop-design, core-concept, trigger, action, stop-condition]
related_skills: [loop-worthiness-test, goal-verification, loop-build-path]

Loop 三要素 — 任何循环的最小可工作结构

R — Reading (原文)

"A loop is three things: a trigger, an action, and a stop condition." — Adam Gillock (视频1)

"第一块心跳,它用来自动触发... 第二块工作树... 第三块skill... 第四块连接器... 第五块子智能体... 最后就是那根脊柱——记忆。" — 小木头 (视频3)

I — Interpretation (自述)

任何循环系统,无论多复杂,都可以拆解为三个基本要素:

1. Trigger (触发器): 什么条件下启动循环? 可以是定时 (cron)、事件 (新邮件到达)、或状态变化 (CI 失败)。
2. Action (动作): 循环启动后执行什么操作? 这是循环的主体逻辑。
3. Stop Condition (停止条件): 何时判定任务完成并退出循环? 可以是目标达成 (凑够 5 条)、次数上限 (最多 8 轮)、或状态判断 (无新任务)。

三要素缺一不可: 没有 trigger 的循环不知道何时开始; 没有 action 的循环是空壳; 没有 stop condition 的循环会无限运行直到资源耗尽。

A1 — Past Application (书中案例)

案例1: Boris Cherny 的 Support Loop (视频2)

• Trigger: 每 30 分钟定时启动
• Action: 读取新 support ticket → AI 分类+回复 → 记录摩擦/想法到 signals 文件夹
• Stop Condition: 无新 ticket 或达到最大处理数

案例2: 小木头的选题 Loop (视频3)

• Trigger: 每天早上 8 点 (cron)
• Action: 拉取过去 24h AI 资讯 → 用 topic-score 子智能体评级 → 追加到 inbox.md
• Stop Condition: 无新资讯或 inbox 达到上限

A2 — Future Trigger (未来触发)

用户会在以下情境下需要这个 skill:

1. 设计新循环时: "我想让 AI 每天自动做 X" → 先问: trigger 是什么? action 是什么? 何时停止?
2. 诊断失效循环时: "我的 loop 跑了 3 天还没停" → 检查 stop condition 是否缺失或过主观
3. 向团队解释 Loop 时: 用三要素作为教学框架,让非技术人员理解循环系统的结构
4. 比较不同 Loop 实现时: 用三要素作为分析框架,对比不同方案的触发策略和停止逻辑

语言信号: "设计一个 loop"、"这个循环怎么停"、"什么是 loop 的最小结构"、"帮我看看这个 loop 缺什么"

与相邻 skill 的区别:

• loop-worthiness-test: 判断"要不要做 loop" (本 skill 假设已决定要做,关注"怎么做")
• goal-verification: 关注 stop condition 的设计 (本 skill 是三要素的整体框架)
• loop-build-path: 关注构建步骤 (本 skill 是静态结构分析)