Communitygithub.com

Renn-Labs/Looptimal

Looptimal — 将目标转化为可交付的、已验证的成果:密封的验收套件、正确的循环、兵棋推演通过、领域专家执行(制造者 ≠ 检查者),以及一个独立的验证器。包含循环设计向导(原 LoopPrint)。

Looptimal 是什么?

Looptimal 是一个面向 AI 代理工作流的结果编排技能,旨在将任何目标转化为一个经过严格验证的成果。它的核心理念是“制造者 ≠ 检查者”——执行任务的代理不能自我验证结果,而是由一个独立的验证器根据一个密封的验收套件来检查最终状态。该技能通过一个 8 阶段的流水线来实现:框架化、分析、设计循环/路由、规划、模拟、执行、验证和持久化,每个阶段都设有检查点以确保质量和安全。它特别适用于需要可验证的“完成”状态、跨领域协作或具有不可逆操作的复杂任务。该技能还内置了一个快捷设计路径,用于仅生成循环蓝图而无需完整编排的场景,并支持多种工作模式,包括单次通过(验证一次)、任务(有界迭代)和可复用循环(定时触发)。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add Renn-Labs/Looptimal

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Looptimal — 结果编排器

将目标转化为可交付的、已验证的成果:密封验收标准,选择或拒绝正确的循环,兵棋推演计划,与领域专家一起执行,并通过一个独立的验证器重新运行密封的套件来检查实时状态,从而实现完成的门控——绝不依赖自我报告的 GREEN。

循环设计向导(原独立 LoopPrint)作为第 2 阶段:设计循环嵌入其中。它也可以作为 design 快捷路径运行,当你只想要一个循环蓝图而不需要完整的结果编排时。

何时使用

  • "looptimal", "/looptimal", "运行一个成果循环", "编排此目标至完成", "规划并交付此目标"。
  • 一个非平凡的客观目标,其中“完成”必须根据实时状态证明,而不是由完成工作的代理自述。
  • 需要能力清单、共识计划和制造者 ≠ 检查者(在成果层面)的跨领域工作。
  • 循环、监督、棘轮或编排模式——在设计循环确认这确实是一个循环之后。
  • 您希望在自主执行前通过模拟进行兵棋推演。
  • 一个单一、非平凡的目标,您希望一次性交付并根据实时状态进行验证。如果它需要有限迭代,则将其路由为任务/目标运行;如果一次谨慎的通过就足够,请使用单次通过模式(请参见下面的模式分叉)。

何时使用设计快捷路径

  • "设计一个循环", "构建一个循环", "新循环", "循环向导", 或一个模糊的重复性任务需要自动化。
  • 您只想要一个循环蓝图(规格 + 工件)——无需结果编排。
  • 直接跳转到第 2 阶段(决策门 → 向导 → 工件生成)并停止。

何时不使用

  • 琐碎的一次性回答、快速编辑或会话式问题 → 直接做好一次,无需工具。(一个实质性的一次性目标您仍然想验证——不是琐碎的,只是不重复——路由到任务/目标运行或下面的单次通过,而不是跳过 Looptimal 的理由。)
  • 没有交付义务的分析 → 直接回答或使用 esat。
  • 不可逆的、判断性强的操作,且没有愿意持有 GO 门控的人 → 建议人工门控流程。
  • 元循环(“运行 Looptimal 来验证 Looptimal”, “当 Looptimal 报告 GREEN 时自动合并”) → 设计循环必须拒绝。
  • 仅症状驱动,没有行为成果预言机的成功指标 → 重新框架化或拒绝。

操作规则(先阅读)

  • 这是一个技能,而不是角色或模式。以一行激活行开始,然后执行工作。
  • 检查点门控:框架化 → 分析 → 设计循环/路由 → 规划 → 模拟,每个步骤简要报告状态。执行从不开始,除非在模拟之后获得明确的人类 GO——或者,在单次通过模式下,在替代分析/设计循环/规划/模拟检查点的轻量级事前分析之后(请参见下面的模式分叉)。
  • 从不自动运行不可逆操作:生产部署、发送、支付、凭据轮换、数据删除——仅通过人工门控操作。
  • 与框架解耦:从 ./.looptimal/profile.yaml → ~/.looptimal/profile.yaml → scripts/looptimal-detect.py → 通用默认值解析绑定。合同:references/agent-foundry.md。

激活行示例:

  • 完整流水线:"Looptimal — 将此目标框架化为一个密封的成果循环。"
  • 设计快捷路径:"Looptimal — 为此循环绘制蓝图。"
  • 单次通过:"Looptimal — 对此进行一次验证通过,无循环。"
  • 直接调用(无目标) :只问一个问题——"我们完成后,哪个结果应该为真?" ——然后走下面的模式分叉。
  • 已给出目标:用一行确认,然后走下面的模式分叉。

模式分叉(在框架化之前——问一次,低成本)

Looptimal 的循环价值判断是决策门(向导的第 1 步,见下文)——但目前仅在框架化和分析运行之后、在第 2 阶段深处触发。在任何这些工作开始之前决定形状,而不是依赖该门控:

  • 措辞已经明确——跳过问题:
    • 设计快捷路径触发词(“设计一个循环”,“构建一个循环”,“蓝图”,“循环向导”) → 直接进入第 2 阶段。
    • 明确的一次性语言,也排除了有用的重试(“单次通过”,“一次谨慎通过”,“不需要重试循环”) → 直接进入单次通过模式。
    • 明确的一次性交付语言,但可能涉及验证器/重试工作(“一次性”,“只做 X 一次”,“构建/修复/交付这个一次”) → 完整流水线,以便决策门可以在任务/目标运行与单次通过之间进行选择。
    • 明确的重复性/节奏语言(“每晚”,“每个 PR”,“保持这个新鲜”,“持续”) → 直接完整流水线。
  • 否则——在触碰第 0 阶段之前,问一个结构化的、三个选项的问题:
    1. 一次性完成,已验证 — 一个单一、已验证的成果,没有有用的重试循环 → 单次通过。
    2. 运行任务或构建循环 — 要么是有界的(一个任务/目标运行,迭代直到一个门控,然后停止——错误修复、规格符合、一次性构建)要么是重复的(按计划/触发器无限期运行) → 完整流水线(第 0 阶段 → 第 1 阶段 → 第 2 阶段;决策门选择路径/原型——任务/重复/监督/持久棘轮/编排,任务/目标运行,或硬拒绝)。
    3. 只生成循环蓝图 → 设计快捷路径(仅第 2 阶段)。

这将决策门已经做出的相同循环价值判断,呈现为用户的自我判断,以低成本方式提前进行,而不是仅在分析、设计循环和规划已经花费在错误形状上之后才可到达(框架化无论选择哪种模式都会运行,因此永远不会浪费)。如果第 0/1 阶段的证据后来与选择的模式相矛盾——一个“单次通过”的目标结果明显需要重复或迭代直到门控,或者一个“重复系统”未通过决策门——直接说明并让用户重定向。永远不会无声地覆盖他们的选择;也永远不会无声地遵守证据不支持的模式。

解析绑定(第 0 阶段序言)

python3 scripts/looptimal-detect.py          # 探测标记;建议配置文件
# 或读取 ./.looptimal/profile.yaml → ~/.looptimal/profile.yaml

提供 state_dir, dispatch.maker, dispatch.checker, verifier.default, 可选 banner。通用默认值:loops/<slug>/, shell 验证器。


8 阶段流水线

阶段名称工作参考
0框架化将目标转化为一个经过哈希固定的、密封的验收套件。每个标准断言一个结果(而非症状)并绑定一个领域成果预言机。输入对制造者不可写。生成 acceptance-suite.yaml + acceptance-suite.sha256。references/pipeline.md
1分析生成能力清单和本地能力准备度清单:领域、集成图、风险、依赖项、可用的技能/插件/连接器/MCP/代理/数据。当风险较高时需要三模型压力测试时,将深度定义工作委托给 esat。references/pipeline.md
2设计循环/路由运行循环设计向导或路由目标。选择原型——任务(有界交付),重复(定期刷新),监督(在防护栏内自治),持久棘轮(每次通过严格改善结果指标),编排(多代理/多仓库),任务/目标运行,单次通过——或仅在无验证器/元循环/仅症状的硬情况下进行拒绝。references/pipeline.md
3规划构建一个共识任务图:节点、依赖项、每个任务绑定到密封套件的验收钩子、爆炸半径标签、回滚说明。references/pipeline.md
4模拟将循环向前滚动 N 步;事前分析故障模式(奖励黑客攻击、静默失败、部分完成、环境漂移);强化计划。展示发现和对密封套件的任何增量(重新哈希 + 用户确认)。references/pipeline.md
—人类 GO明确批准执行。揭示最高风险、不可逆操作、未解决的依赖项。无 GO → 无执行。references/pipeline.md
5执行根据绑定配置文件启动动态领域专家子代理。制造者 ≠ 检查者(在迭代门控处)。可恢复、幂等的步骤;针对部分失败的回滚路径。在不可逆操作上设置预操作门控。references/pipeline.md
6验证结果一个独立的检查者重新运行密封的套件,针对实时状态。忽略循环自我报告的 GREEN。使用证据包进行门控。references/pipeline.md
7持久化写入持久状态:目标哈希、套件哈希、成功/失败的原因、预言机结果、修复类别、恢复指针、下次运行的教训。references/pipeline.md

阶段转换(默认)

  • 0 → 1:密封套件存在,每个标准都有一个预言机,哈希已记录。
  • 1 → 2:能力清单覆盖所有实质性领域、集成边缘以及本地能力准备度。
  • 2 → 3:原型或任务路径已选择(或发布硬拒绝,并附有诚实的替代方案)。
  • 3 → 4:任务图无环,每个节点挂钩到一个套件标准,安全限制已设置。
  • 4 → GO:已交付模拟报告;计划已强化;不可逆操作已标记。
  • GO → 5:明确的人类批准已捕获在状态中。
  • 5 → 6:制造者声明迭代完成——仅供参考;检查者拥有真相。
  • 6 → 7:证据包为 GREEN;否则失败并附带修复类别和恢复指针。

恢复

如果 state_dir 下存在先前的运行,并且目标哈希匹配,则从最后一个未完成的阶段恢复。如果目标发生实质性变化,则重新框架化(新套件哈希)。在硬拒绝之后,未经新的设计循环/路由,绝不恢复。


第 2 阶段 — 设计循环/路由向导

向导强制执行四个原子,运行路由决策门,然后分支。可复用循环路由生成完整的 LoopPrint 工件包。任务/目标运行路由发出 route.md 加上一个任务包(第 3 阶段之后的 mission.yaml)并继续到第 3 阶段规划,而不使用可复用循环脚手架。单次通过路由发出 route.md 加上轻量级事前分析,并遵循单次通过退化路径。它驻留在完整流水线的第 2 阶段,也作为 design 快捷路径独立运行。

向导入口

  • 完整流水线(从第 2 阶段调用):目标是第 0 阶段的结果。跳转到步骤 0.5。
  • 设计快捷路径(直接调用):以一行激活行开始;如果未给出目标,则首先问一个问题。

步骤 0.5 — 解析绑定

运行 scripts/loopprint-detect.py(或读取 ./.loopprint/profile.yaml → ~/.loopprint/profile.yaml)以获取 state_dir, verifier.default, dispatch, marker_path, runner, banner。通用默认值:loops/<slug>/, verify.sh。合同:references/profiles.md。绝不硬编码框架约定。

步骤 1 — 决策门(+ 路由)

运行 references/decision-gate.md 中的第 0 层测试:4 个条件 + 30 秒检查清单。报告路由,每个条件附带一行推理。重复性仍然是可复用循环的摊销测试,而非整个编排门控:非重复但有验证器支持的工作可以路由到任务/目标运行或单次通过。当没有外部验证器/人工检查点、目标是自我引用/元循环、或成功仅凭症状而无行为锚点时,硬拒绝仍然是强制性的。

根据选定的路由立即分支:

  • 可复用循环路由: 继续执行步骤 2-6,固定循环原型/配置文件,生成 loops/<slug>/,并运行 loopprint-lint。
  • 任务/目标运行路由: 不要继续循环配置文件或工件生成。发出 route.md,包含驱动者、状态工件、验证器、停止/预算、自治级别、准备度差距以及为何不生成可复用循环蓝图;然后继续到第 3 阶段规划,它发出 mission.yaml, task-graph.yaml, execute-scope.yaml 和 looptimal-lint.txt。
  • 单次验证通过路由: 不要继续循环配置文件或工件生成。发出 route.md,包含验证器、状态工件、停止、准备度差距以及一个 3 场景轻量级事前分析;然后跟随 single-pass 退化路径,而不是第 3/4 阶段。
  • 人工门控工作流路由: 发出 route.md,包含人工检查点和外部检查者,然后仅通过匹配这些门控的监督路径继续。
  • 硬拒绝: 发出 reject.md,包含不可验证/不安全的原因以及诚实的替代方案;除非用户重新框架化目标,否则停止。

步骤 2 — 可复用循环目标细化

提出 3–5 个有针对性的问题(不超过):

  1. 精炼的目标——一句话,可测试。
  2. 重复性/频率——确认可复用循环摊销。
  3. 验证方法——什么外部信号指出一次迭代成功?
  4. 不可逆风险——什么无法撤销?(→ 人工检查点)
  5. 自治级别——完全自治、检查点门控或模拟运行?

步骤 3 — 可复用循环原语强制执行

对每个原子强制执行一个具体值。不要以任何模糊的方式继续:

  • 目标——来自步骤 2 的一句话目标。
  • 状态——来自绑定 state_dir 的持久工件路径;它记录什么:尝试日志、失败内容、当前假设、上下文。
  • 验证器——确切的外部命令或指定的审查者。如果唯一提议的检查是同一个代理自我评估,则拒绝它并找到一个真正的门控。制造者 ≠ 检查者。
  • 停止——成功标准以及一个安全限制(最大迭代次数、令牌/时间预算、明确的暂停)。没有安全限制的循环绝不发布。

步骤 4 — 可复用循环配置文件选择

固定原型的完整配置文件——工作模式(来自 references/patterns.md)以及验证器/停止形状:

  • MORTY — 特定错误;验证器 = 复现测试;完成...

相关技能