用途
Timeboxed Iterating 用于在用户指定的时长内,通过分派子智能体迭代推进一个目标。它的核心结构是:编排者(orchestrator)是一个线性的、受时钟约束的驱动者,一轮只处理一次迭代,始终检查时钟;但每一轮迭代是一个批次——把独立的工作单元并行展开给多个子智能体,这些子智能体还可以继续向下分派。编排者从不亲自撰写任何内容,共享知识以磁盘文件形式累积,使后续批次不必重新学习前面已发现的东西。
主要能力
编排者的职责(仅做五件事):
- 管理时钟:每批之前执行
date +%s,截止时间即刹车。 - 管理磁盘共享状态:摘要、速查表、角色提示词文件(由 scaffold 命令一次性产生);在测量门禁通过后负责有限清单的完成状态转换。
- 规划每轮迭代:读取摘要尾部,选择独立单元,划分并行与串行,为每个单元选择模型规模。
- 分派批次:给每个子智能体一个角色提示词路径加上简短单元增量,并行展开,然后读取它们极小的结构化状态。
- 执行停止机制:只依据合法理由停止,绝不凭感觉。
纯分派原则:编排者从不把大型内容读入自己的上下文,因为编排者的上下文是长时间运行中最稀缺的资源。子智能体把结果持久化到磁盘(它们的单元文件、摘要、速查表),只返回极小的结构化状态(例如“unit X: done, commit <hash>”或“measure X: PASS — 一行”)。编排者只读紧凑的摘要尾部加上这些一行状态。
四条铁律:
- 时钟(或用户)决定开放式运行何时停止。
- 有限清单决定有限运行何时停止;清单耗尽即停止,提前完成是正确的,不是失败。
- 编排者从不撰写。
- 每轮迭代向外展开;独立工作并行执行,串行分派独立单元是被禁止的主要损失。
不可妥协的关键点:线性驱动 + 并行展开(C1);共享状态按引用传递而非内联(C2);速查表自我填充(B2/D1);易变值单一事实来源(B4);先确立真实成功标准——数值或文本(B5);只前置真正的使能项(B8/D1);模型规模匹配单元且不超过编排者自身层级(C3);不制造工作、不空闲(B4/B6);感知并发上限;提示词只写一次到磁盘并按路径引用(E1/E4/D3/C2);编排者纯分派(E3)。
使用方式
输入:目标(做什么,如“把一组固定源文档提炼成笔记”“修复所有 lint 错误”“提升测试覆盖率”“加固 API”)与时长(如“4 小时”“隔夜”即 8 小时、“90 分钟”)。若时长含糊,把“隔夜”理解为 8 小时;若目标确实含糊,只问一个问题,否则自行选择并继续。
流程(按阶段):
- Phase 0:分类目标为 FINITE 还是 OPEN-ENDED,运行 scaffold 生成工作区。scaffold 命令通过少量变量生成完整工作区,并创建并变量替换 progress.md(状态摘要)、run-card.md(静态运行卡)、cheatsheet.md(速查表)、prompts/(角色提示词文件:initialiser.md、builder.md、sub-subagent.md、measurement.md)、units/<unit-id>.md(每单元一个文件)。
bash <skill-dir>/scaffold/init.sh \
--slug <slug> --goal "<goal>" --mode <finite|open-ended> [--duration <e.g. 4h|90m>]
- Phase 1:设置并前置加载。角色提示词已在磁盘上,按路径引用;前置加载仅包括真实使能项:真实成功标准试点、使能基础设施、范围/有效性标准(若存在)。
- Phase 2a:规划迭代(读摘要,选独立单元,划分并行/串行,为每个单元定模型规模,批次限制在并发上限内)。
- Phase 2b:并行分派批次(每个子智能体给角色提示词路径 + 单元文件路径 + 缺口行)。
- Phase 2c:读取极小状态(绝不读完整产物),通过 git log 抽查每次提交。
- Phase 2d:以最小足迹整合;子智能体已追加到摘要与速查表;仅当成功门禁通过后才翻转有限清单的完成状态。
- Phase 3:停止,输出最终摘要。
每条路径都回到刹车检查;done 只能从刹车检查到达,图中不存在基于质量或“感觉完成”的退出。
分类细节:FINITE 指目标为精确/详尽规格或有限的、可枚举的条目清单,应在设置时把清单显式枚举进摘要,清单是完成权威。OPEN-ENDED 指目标没有固定终点,时钟是唯一完成权威,应使用完整时长。若一个目标在某一维度有限、另一维度开放,把可枚举维度当作清单,把深度当作每项内开放:运行在清单被覆盖到既定深度或时钟触发时结束,以先到者为准。
适用场景
适合任务可拆分为独立单元、能够并行分派、且适合在明确时长内长时间迭代推进的场景——例如把固定列表的源文档提炼成笔记、修复全部 lint 错误、提升测试覆盖率、加固 API,以及“审查这 10 个文件的 bug”这类可枚举文件清单加每文件开放深度的工作。
限制
编排者不进行任何撰写和分析:不做代码编辑、不查数据库、不创建 PR、不生成 HTML/报告、不做“快速修复”、不为弄清某事而读代码库;每个生产性动作都发生在子智能体内部。必须遵守并发上限,超过上限的分派会静默失败。成功门禁适用于有可陈述成功标准的目标:每个针对可陈述成功标准产出的单元,必须由独立的测量子智能体应用该真实标准(而非代理)通过后才标记完成;若目标完全没有可陈述的成功标准,该门禁不适用。本页未提供该技能的具体安装步骤、支持的平台清单、费用、价格和其他未提及的细节,暂未提供。