designing-loops

name	designing-loops
description	当需要设计、审查或加固反复运行的 Agent 工作流、/loop 命令、自动化、cron、CI 修复循环、PR review 循环、triage 循环或多 Agent 系统时使用。

设计 Loops

概述

使用本 skill，把人类一轮轮提示 Agent 的过程，替换成一个可控系统：它能发现工作、分派任务、验证结果、记录状态，并决定下一步。Loop 可以理解成一个递归目标：先定义目的，再让系统持续迭代，直到完成条件成立或停止规则触发。

必需子 skill： 设计 loop contract 前，先使用 defining-goals。目标弱，loop 越高效越危险。

设计 loop 之前，先确认目标已经通过对话或当前上下文搜索澄清。如果完成标准、边界或证据来源仍然模糊，先暂停 loop 设计，回到目标定义。

Loop 骨架

按顺序设计这些部分：

1. 目标契约

   • 定义结果、完成标准、边界、资源、降级方案和状态。
   • 拒绝无法独立验证的目标。
   • 带上 defining-goals 里的待确认问题和已检查证据；未解决的高风险问题要变成停止规则，而不是隐藏假设。

2. 心跳

   • 选择 loop 如何启动：手动 /goal、定时 /loop、自动化、cron、hook、CI、issue 事件、PR 事件或外部调度器。
   • 定义频率、运行窗口、token/时间预算，以及什么情况下安静退出。

3. 发现和分流

   • 指定 loop 扫描什么：失败的 CI、新 review 评论、open issues、日志、告警、过期文档、支持工单。
   • 定义优先级和去重规则，避免 loop 永远重复昨天失败过的尝试。

4. 隔离

   • 给每个独立任务使用单独 worktree、分支、workspace 或 sandbox。
   • 定义 merge/rebase 规则和清理规则。
   • 除非任务只读，不要让并行 Agent 写同一个 checkout。

5. 知识体系

   • 加载项目 skills、AGENTS/CLAUDE 文档、runbook、memory 和相关 references。
   • 这些知识源要短、当前有效，并按任务路由。过期知识会让无人值守 loop 更快失败。

6. 连接器

   • 只加入 loop 真正需要的工具：GitHub、Linear、Slack、数据库、观测系统、staging API、文件存储。
   • 分开定义读权限和写权限。发现阶段优先只读。

7. 子 Agent 和评审者

   • 把执行者和检查者分开。
   • 使用专门子 Agent 做探索、实现、安全、性能、产品评审或 spec compliance。
   • 做出改动的 Agent 不能成为唯一完成判断者。

8. 状态

   • 把发现了什么、尝试了什么、改了什么、验证了什么、跳过了什么、阻塞了什么，记录到对话之外。
   • 可以使用 Markdown、issue、Linear、数据库或其他持久系统。
   • 状态要足够让下一轮不用重新发现同一批事实。

控制流

除非任务需要别的结构，否则使用这个默认 loop：

触发 -> 加载状态 -> 发现工作 -> 分流 -> 选择任务
-> 创建隔离工作区 -> 执行 -> 独立验证
-> 记录状态 -> 通知或升级 -> 决定下一个任务或停止

小范围会话内任务，可以用 /goal 风格迭代，并设置很窄的停止条件。反复运行的工作，要用自动化或调度，加上持久状态。

停止规则

出现以下情况时，loop 必须停止、暂停或升级：

• 完成标准已经通过
• 检查了可用对话、代码、文档、状态或连接器后，目标仍然模糊
• token、时间或预算达到上限
• 同一个失败重复出现两次
• 缺少必需权限或上下文
• 验证需要人类判断
• loop 必须削弱测试、删除检查或扩大范围才能通过
• 改动影响高风险区域，但没有可信评审者

风险检查

• 验证债：检查是否足够强，能支撑无人值守改动？
• 理解债：人类是否仍然理解 loop 改了什么、为什么改？
• 认知投降：loop 是在保留判断，还是在用“自动化”替代判断？
• 成本漂移：loop 是否可能无限消耗 token 或启动过多 helper？
• 状态腐烂：过期 docs 或 memory 是否会误导下一轮？
• 权限膨胀：loop 是否能写入本来只该读取的系统？

只要风险真实存在，就补约束、预算、评审门或更窄权限。

输出格式

按这个结构输出 loop 设计：

## Loop 目的
[一句话说明。]

## 目标契约
[引用 defining-goals 产出的目标，包括已检查证据和待确认问题。]

## 触发方式
[手动、定时、hook、自动化、事件或 CI。]

## 输入
[Repos、issues、日志、API、文档、状态文件。]

## 执行模型
[worktree/sandbox、子 Agent、连接器权限、预算。]

## 验证
[独立检查和执行/检查分离。]

## 状态
[进度和决策记录在哪里。]

## 停止和升级规则
[完成、预算、重复失败、缺少权限、人类评审。]

## 风险和护栏
[Goodhart、理解、成本、权限、过期知识。]