Loop Engineering 瘦循环模式(Thin Loop):用 GitHub Actions 快照替代 STATE.md 的 L1 报告回路

发布时间:2026/9/24 13:46:14

Loop Engineering 瘦循环模式(Thin Loop):用 GitHub Actions 快照替代 STATE.md 的 L1 报告回路 人工智能AI AgentAgent 工作流CLI研发协作AI 技能MCP 服务【免费下载链接】loop-engineeringPractical patterns, starters CLI tools for loop engineering with AI coding agents. Design systems that prompt and orchestrate agents (inspired by Addy Osmani and Boris Cherny). Includes loop-audit, loop-init, loop-cost.项目地址https://gitcode.com/gh_mirrors/lo/loop-engineering点击查看免费下载本文基于 loop-engineering 仓库的 patterns/thin-loop.md 模式文档结合 starters/thin-loop 起步模板与 tools/loop-init 脚手架源码讲解如何用几乎零额外文件的方式在 GitHub Actions 上搭建一个仅报告report-only的自动化循环。读完你将掌握什么时候该用瘦循环、如何 10 分钟内部署一个绿色工作流、底层 workflow 每个步骤的写法与权限含义以及何时应当升级到带STATE.md的成熟模式。一、什么是 Thin Loop把问题跟踪器当作状态本身瘦循环Thin Loop是 loop-engineering 模式注册表中的一类低风险模式patterns/registry.yaml 中id: thin-loop。它的核心主张只有一句话问题跟踪器和 Actions 的 Job Summary 就是状态state不需要额外的STATE.md。模式文档开篇给出了它的设计动机现实中大多数 AI 编码 Agent 循环其实已经长这样——仓库里提交了触发器cron 定时任务或pull_request工作流却几乎从不提交STATE.md。瘦循环是有意顺应这种现实形态而不是强行要求一套完整的方法论安装。在模式注册表中瘦循环的定位非常明确patterns/registry.yaml目标report-only 的 GitHub Action 快照问题跟踪器即状态节奏1d事件触发 每日定时风险low低阶段snapshot→summarize→optional-comment快照 → 汇总 → 可选评论人机门禁all-writes所有写操作都留给人类第一周模式L1仅报告。与之配套仓库在 patterns/README.md 的模式索引表中将 Thin Loop 标注为event 1d、Low 风险的模式并链接到本文档。二、适用场景与反模式什么时候该瘦什么时候别瘦适用场景When to use模式文档明确给出三个典型信号本周就要一个循环而不是安装一套方法论——追求的是尽快让循环转起来工作内容就是 PR 审查或 Issue 快照——没有需要持久化、而 GitHub 本身又没有存储的数据后续如果需要再补STATE.md——当发现某个发现需要跨运行存活例如积压任务、尝试次数、预算再升级。不适用场景Do NOT start here文档明确划出红线如果你需要以下能力不要从这里开始而应改用 Daily Triage 或 PR Babysitter尝试次数上限attempt capsmaker/checker 分离即执行者与检查者分离的职责划分Token 熔断开关token kill switch。原因很直接这些能力都依赖跨运行的持久化状态而瘦循环刻意不维护状态。三、调度策略与 L1 定位模式文档给出瘦循环的调度表面表面Surface触发器TriggerGitHub Actionsissues/pull_requestopened 工作日 cron见起步模板Claude / Grok / Codex可选稍后/loop 1d读取上一次 job summary第一周定位为L1工作流只向$GITHUB_STEP_SUMMARY写入快照只有当触发的 issue/PR 线程上**还没有瘦循环标记marker**时才评论一次。起步模板的 LOOP.md 把这一定位浓缩为一页Pattern: thin-loopLevel: L1 report-onlyCadence:issues/pull_requestopened 工作日 08:00 UTCState: 无。GitHub issues 和 PR 就是积压队列Actions job summary 就是报告Writes: job summary每个线程至多一条评论!-- thin-loop --Denylist: 不编辑代码、不打标签、不关闭、不推送Kill switch: 禁用.github/workflows/thin-loop.yml或取消工作流这里的Denylist拒绝清单是瘦循环安全性的关键循环本身被明确禁止做任何有副作用的写操作这与所有写操作留给人类的human_gates: [all-writes]注册表配置patterns/registry.yaml完全对应。四、10 分钟部署安装方式与脚手架方式一使用 loop-init 脚手架起步模板 starters/thin-loop/README.md 给出的标准安装命令npx cobusgreyling/loop-init . --pattern thin-loop --tool claude从 tools/loop-init/src/cli.ts 源码可以看到thin-loop被显式列入模式白名单Pattern联合类型与thin-loop: thin-loop映射见 tools/loop-init/src/cli.ts并且是TOOL_AGNOSTIC工具无关集合的成员tools/loop-init/src/cli.ts——这正是模式文档所说tool suffix is ignored; you still get the workflow工具后缀会被忽略你仍然得到工作流的源码依据。值得注意的一个实现细节脚手架在pattern ! thin-loop且非 dry-run 时才要求目标目录存在AGENTS.mdtools/loop-init/src/cli.ts。也就是说瘦循环特意不要求任何 Agent 配置文件这与无技能、无预算文件、无 STATE.md的极简哲学一脉相承。CLI 帮助信息也印证了这一点thin-loop (GitHub Action snapshot — no STATE.md)tools/loop-init/src/cli.ts。同样loopCLI 的交互式向导tools/loop/src/wizard.ts将瘦循环选项描述为 Just a GitHub Action, no extra files仅一个 GitHub Action无额外文件并从loop-init侧给出了对应的操作指引tools/loop-init/src/cli.ts。方式二手动复制mkdir -p .github/workflows cp starters/thin-loop/.github/workflows/thin-loop.yml .github/workflows/然后合并到main打开一个 issue 或等待工作日 cron读取 Actions summary 即可。你会得到什么 / 刻意不给你什么文件用途.github/workflows/thin-loop.yml事件 工作日快照LOOP.md一页说明节奏与门禁起步模板明确列出了刻意不给的三样东西starters/thin-loop/README.mdSTATE.md——当发现需要跨运行持久化时再加升级方向见 minimal-loop-claudeAgent 调用——之后如需模型入环可接入 tools/loop-action高 Loop Ready 评分——文件落盘数量不是这里的目标。五、工作流解剖一份完整可运行的 thin-loop.yml瘦循环的全部实现都集中在一个文件里starters/thin-loop/.github/workflows/thin-loop.yml。下面是它的四个关键组成部分。1. 触发条件onon: issues: types: [opened] pull_request: types: [opened, ready_for_review] schedule: - cron: 0 8 * * 1-5 workflow_dispatch:issues: opened——新 issue 打开时触发pull_request: opened, ready_for_review——新 PR 打开、或 PR 从 draft 转为 ready 时触发schedule: 0 8 * * 1-5——工作日周一至周五08:00 UTC 定时快照对应 LOOP.md 中weekdays 08:00 UTC的节奏workflow_dispatch——支持手动触发便于调试。2. 权限声明permissionspermissions: contents: read issues: write pull-requests: write这是最小权限集contents: read用于actions/checkoutissues: write与pull-requests: write用于发布评论。模式文档的失败模式表中特别强调空快照问题往往就是gh鉴权问题工作流必须带issues: write/pull-requests: write——缺了写权限gh命令会失败。3. 快照步骤Snapshot open work- uses: actions/checkoutv4 - name: Snapshot open work id: snap env: GH_TOKEN: ${{ github.token }} run: | { echo # Thin loop snapshot $(date -u %Y-%m-%dT%H:%M:%SZ) echo echo L1 report-only. No code edits, labels, or closes. echo echo ## Open pull requests gh pr list --state open --limit 20 --json number,title,updatedAt \ --jq .[] | - #\(.number) \(.title) (updated \(.updatedAt)) \ || echo _none_ echo echo ## Open issues gh issue list --state open --limit 20 --json number,title,updatedAt \ --jq .[] | - #\(.number) \(.title) (updated \(.updatedAt)) \ || echo _none_ } | tee $GITHUB_STEP_SUMMARY /tmp/thin-loop-summary.md要点解析使用github.token作为GH_TOKEN不需要单独创建 PATgh pr list/gh issue list各取最近 20 条 open 项通过--jq输出为- #编号 标题 (updated 时间)格式|| echo _none_兜底——即使查询失败也保证 summary 非空tee $GITHUB_STEP_SUMMARY /tmp/thin-loop-summary.md把内容同时写入 Job Summary 和临时文件供后续步骤引用。4. 一次性评论步骤Comment once- name: Comment once on the triggering item if: github.event_name issues || github.event_name pull_request env: GH_TOKEN: ${{ github.token }} EVENT_NAME: ${{ github.event_name }} ISSUE_NUMBER: ${{ github.event.issue.number }} PR_NUMBER: ${{ github.event.pull_request.number }} run: | set -euo pipefail MARKER!-- thin-loop -- ...核心逻辑是标记防重从事件环境变量中取出 issue/PR 编号用gh api repos/${{ github.repository }}/issues/${NUMBER}/comments拉取该线程全部评论用grep -q thin-loop检查是否已存在标记!-- thin-loop --存在则直接跳过防止评论轰炸对应模式文档失败模式表中的Comment spam一行不存在则写入一条 L1 评论内容包含标记、快照链接指向本次 Actions run以及本运行不打标签、不关闭、不编辑代码的声明按 kind 分别调用gh issue comment或gh pr comment。需要留意一个细节步骤只对事件驱动的触发issue/PR 打开评论而 cron 定时快照只写 summary不评论——避免每天 08:00 给所有历史线程重复刷评论。六、典型循环周期Typical cycle模式文档给出了 5 步标准周期事件或工作日 cron 触发工作流用gh列出所有 open 的 PR 和 issue快照写入 Job Summary如果事件来自某个 issue/PR则在其线程上发布一次简短 L1 评论仅一次人类阅读 summary 或评论。循环不编辑代码、不自动合并。对应到注册表的阶段定义patterns/registry.yamlsnapshot → summarize → optional-comment其中 optional可选正是指评论只在事件触发且无标记时才发生。七、所需技能与工具说明技能Required Skills模式文档的关键结论L1 阶段不要求任何技能工作流只用gh。loop-triage——可选仅当你之后要通过 loop-action 把 Agent 接入 Action 时才需要loop-verifier——可选但在任何写操作之前是必须的一旦存在实现者implementermaker/checker 分离依然适用。需要强调的是验证器技能模板见 templates/SKILL.md.verifier其核心思想是maker/checker而不是同一会话给自己作业打分。状态文件与成本画像State file不需要。GitHub issues/PR 承载积压可选地一行loop-run-log.md记录可作为 Loop Ready 活动评分的证明。成本画像来自 patterns/registry.yamltoken_cost: low空操作 1000 tokens、报告 5000 tokens、动作 1000 tokens稳定性比例 0.9即 90% 的运行几乎不消耗 token建议日上限 20000 tokens且要求尽早退出early_exit_required: true。从 tools/loop-init/src/cli.ts 还可以看到thin-loop的每日运行上限为 24 次、maxSpawnsL1: 0L1 阶段零衍生任务印证了它极低的开销定位。运行时选择GitHub Actions 是原生运行时起步模板见 starters/thin-loop其他工具可统一用npx cobusgreyling/loop-init . --pattern thin-loop --tool claude脚手架生成工具后缀会被忽略你得到的仍是同一个工作流文件。八、验证策略Verification Strategy瘦循环没有实现者implementer因此也没有验证者verifier。模式的验证是纯机械检查gh命令执行成功且 summary 非空。这正是|| echo _none_兜底与tee双写设计的用意——保证 summary 永远非空、可被人类阅读。文档同时给出升级路径如果之后接入 Agent必须在任何写操作前添加 loop-verifier坚持 maker/checker 分离而不是同一会话自我评分。九、人工交接Human hand-off模式文档对人工交接的定义非常干脆一切都是交接。循环不关闭 issue、不打标签、不推送提交。这正是所有写操作都留给人类human_gates: [all-writes]的落地形态快照和一次性评论是循环与人类之间的交接物而决策与动作关闭、打标签、合并、改代码永远发生在循环之外。起步模板第一周指引starters/thin-loop/README.md也明确要求阅读 summary但不要让循环打标签、关闭或推送。十、失败模式速查表模式文档给出三张最常见的失败场景与对策失败对策评论轰炸Comment spam标记!-- thin-loop --会跳过重复评论空快照Empty snapshotgh鉴权问题——工作流需要issues: write/pull-requests: write人们期待高 Loop Ready 评分瘦循环在出现带日期的运行日志或STATE.mdLast run 之前保持低分这是设计使然前两行已经在上文的工作流解剖中给出源码级对应标记防重逻辑与permissions声明第三行则提醒团队管理预期低评分不是缺陷而是刻意取舍。十一、成功指标Success Metrics模式文档给出三条可量化的成功标准合并后 10 分钟内出现首个绿色工作流运行已有标记的线程上不再出现新评论循环本身对main的零文件编辑。这三条分别验证了部署速度、防重复机制和只读纪律——三者共同构成瘦循环按预期运转的完整证据。十二、升级路径什么时候该长胖瘦循环刻意保持薄但模式文档和模板都给出了明确的毕业方向当积压需要跨运行存活尝试次数、预算、观察清单时升级到 Daily Triage 并添加STATE.md对应起步模板 README 中的指引 starters/minimal-loop-claude当需要模型入环时通过 tools/loop-action 接入 Agent并在任何写操作前引入 loop-verifier当需要尝试次数上限、maker/checker 分离或 token 熔断时参考 PR Babysitter。用 LOOP.md 的话说当队列必须跨运行存活时升级到 Daily Triage 并添加STATE.md。瘦循环不是终点而是让循环以最低成本转起来、并以真实需求驱动演进的起点。相关资源索引模式文档patterns/thin-loop.md起步模板starters/thin-loop含 LOOP.md、README.md、thin-loop.yml模式注册表条目patterns/registry.yaml脚手架实现tools/loop-init/src/cli.tsthin-loop工具无关、免AGENTS.md的逻辑见 L21-L99、L1076-L1083交互式向导tools/loop/src/wizard.ts相关模式Daily Triage、PR Babysitter、loop-verifier 模板、loop-action赞分享人工智能AI AgentAgent 工作流CLI研发协作AI 技能MCP 服务【免费下载链接】loop-engineeringPractical patterns, starters CLI tools for loop engineering with AI coding agents. Design systems that prompt and orchestrate agents (inspired by Addy Osmani and Boris Cherny). Includes loop-audit, loop-init, loop-cost.项目地址https://gitcode.com/gh_mirrors/lo/loop-engineering点击查看免费下载相关推荐gs-quant 量化金融回测实战一段脚本跑通均值回归策略看懂 5 个核心指标gs quant 量化金融回测实战一段脚本跑通均值回归策略看懂 5 个核心指标 gs quant 是 Python 量化金融工具包内置回测引擎、触发器与绩人工智能AI AgentAgent 工作流CLI研发协作AI 技能MCP 服务用单个 GitHub Action 搭建 L1 只读循环loop-engineering Thin Loop 模式实战用单个 GitHub Action 搭建 L1 只读循环loop engineering Thin Loop 模式实战 Thin Loop 是 loop en人工智能AI AgentAgent 工作流CLI研发协作AI 技能MCP 服务MLX JACCLThunderbolt 5 RDMA 分布式通信实战指南MLX JACCLThunderbolt 5 RDMA 分布式通信实战指南 JACCLJack and Angelos Collective Commun人工智能AI AgentAgent 工作流CLI研发协作AI 技能MCP 服务创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/9/24 13:46:14

8款实用一键生成论文工具横向实测,本硕博避坑全流程指南

前言:AI 写论文乱象频发,实测 8 款工具理清适配边界 每到毕业季,本科生、硕博生都会集中寻找 AI 论文辅助工具,市面各类写作软件层出不穷。但普遍存在几类硬伤:虚假参考文献、无法匹配本校格式、不支持公式代码生成、A…

2026/9/24 13:41:14

阅读笔记GB/T 22239-2019信息安全技术网络安全等级保护基本要求》

云计算:通过网络访问可扩展的、灵活的物理或虚拟共享资源,并按需自助获取和管理资源的模式。(资源:服务器、操作系统、网络、软件、应用和存储设备等)虚拟机监视器hypervisor:运行在基础服务器和操作系统之…

2026/9/24 14:41:23

shadcn-vue Dropdown Menu 组件完整指南:安装、API 与实战示例

UI组件前端 【免费下载链接】shadcn-vue Vue port of shadcn-ui 项目地址: https://gitcode.com/gh_mirrors/sh/shadcn-vue 点击查看 免费下载 本指南围绕 shadcn-vue 中的 Dropdown Menu(下拉菜单)组件展开,它是通过按钮等触发器…

2026/9/24 14:41:23

《AI Agent 场景应用 - MobileOpenClaw》第5-4节:初步通过智能体操作手机设备,从意图分析到安卓指令执行的端到端串联

文档教程后端 【免费下载链接】CodeGuide :books: 本代码库是作者小傅哥多年从事一线互联网 Java 开发的学习历程技术汇总,旨在为大家提供一个清晰详细的学习教程,侧重点更倾向编写Java核心内容。如果本仓库能为您提供帮助,请给予支持(关注、…

2026/9/24 14:36:22

【单片机毕设案例分享】基于 STM32 或 51 单片机 SU-03T 语音识别智能窗设计与实现 基于 STM32 或 51 单片机多传感器融合智能遮阳控制系统设计(025608)

博主介绍:✌️码农一枚 ,专注于大学生项目实战开发、讲解和毕业🚢文撰写修改等。全栈领域优质创作者,博客之星、掘金/华为云/阿里云/InfoQ等平台优质作者、专注于单片机,STM32单片机,51单片机,J…

2026/9/23 12:07:00

GAMP 5 基于风险的计算机化系统验证:软件分类与审计追踪实践

简介:《A Risk-Based Approach to Compliant GxP Computerized Systems》即业内熟知的GAMP 5指南,面向制药企业质量与IT合规人员、验证工程师及计算机化系统管理者,用于解决GxP法规环境下系统合规性难以科学落地的问题。文档以风险管理为主线…

2026/9/23 12:06:55

安全托管MSSP实战:从静态防御到人机协同的攻防运营与应急响应

简介:这份PPT围绕互联网业务安全托管服务展开,面向企业安全负责人、IT运维人员及关注MSSP/MSS选型的读者,重点回应传统安全过度依赖人工、碎片化静态防御难以对抗产业化攻击等痛点。资源共1个pptx文件,包体约30.63MB,以…

2026/9/24 0:00:21

基于YOLOv8的渔船作业监控系统:从环境搭建到边缘部署全流程

简介:这是一套面向计算机、人工智能、自动化等专业学生与教师的毕业设计级项目资源,围绕YOLOv8实现渔船作业监控系统,可用于毕设、课程设计、大作业或项目立项演示。压缩包共97个文件,约24.21MB,以70个Python源码文件为…

2026/9/24 0:00:21

单细胞注释实战:基于Scanpy的标记基因与参考映射流程解析

简介:一份基于单细胞RNA测序数据的细胞类型注释算法研究Python毕业设计源码,针对计算机相关专业正在做毕设或需要项目实战的学习者,可用于课程设计与期末大作业。项目代码完整、经导师指导评审通过,可直接运行,覆盖数据…

2026/9/24 0:00:21

C#源生成器实战:用增量生成器替代反射,告别AOT崩溃

第一次在项目里被反射卡住,是在一个老旧的WinForms模块里:几十个类依赖PropertyChanged通知,运行时反射读属性、发通知,每次启动慢半拍不说,一上.NET Native/AOT裁剪模式几乎全面崩盘。后来我把这段逻辑全部改成C#源生…

2026/9/22 16:34:32

USB Type-C PCB布局分区设计:电源、高速信号与PD协议全攻略

做硬件这行,Type-C接口算是典型的“看着简单,做起来全坑”的东西。光引脚就24个,高低速信号、电源、控制线全部塞在一个小小的连接器里,如果PCB布局不做规划,打样回来基本就是“插上没反应”、“高速掉线”、“静电一打…

2026/9/22 20:01:30

系统编程学习原型如何补齐稳定性边界

系统编程学习原型如何补齐稳定性边界预算有限时&#xff0c;我先优化明显多余的复制&#xff0c;而不是猜测性地换容器。用借用传递只读数据通常就能减少分配&#xff1a; fn parse(line: &str) -> Result<Item, Error> { /* ... */ }用基准确认热点确实在分配&am…

2026/9/22 13:25:41

雨花区哪家财务公司代理记账比较好?

在雨花区&#xff0c;企业处理财税事务常常面临诸多挑战&#xff0c;选择一家靠谱的财务公司至关重要。湖南巨勤财务管理咨询有限公司就是本地正规实体财税服务机构&#xff0c;深耕本地工商财税行业多年&#xff0c;熟悉当地工商局、税务局最新政策与申报流程。主营公司注册、…

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
咨询二维码