用途:在公开的 policy/checkpoint 契约下运行单智能体修正循环。它与 agent-debate 不同:plan-act-reflect 针对证据修订单一候选,debate 则比较真正有分量的备选方案。
适用场景:具有可运行或确定性验收契约的任务;可能需要多于一轮证据产出循环的候选;有界的优化、重构或草稿修正。不适用于开放式构思、无界“直到完美”的请求,或属于人类的语义验收。
前置条件:需要一个具体目标、验收标准、可读的 policy_ref、有效的 checkpoint_ref,以及已识别的 critique source。策略是循环、重试、上下文与子级限制的唯一来源,本技能不定义回退数值限制。若 agent-collab-harness 不可用,最多执行当前授权的一次动作并交回人类,不得用复制的限制模拟自主循环。
循环:校验策略与检查点;在任何委派执行器或评审者生成前评估策略;规划能增加验收证据的最小动作;在声明范围内执行;运行 critique source;向检查点添加证据引用与观测指标;分类进展(验收满足则 PASS 停止;同一失败则增加 same_failure_retries;无新工件、测试、来源、决策或阻塞则增加 no_evidence_cycles;有新证据则重置相关无进展计数器);循环后运行 agent-collab policy evaluate,并遵守 PolicyDecision:continue 用新证据修订计划;checkpoint 保存可恢复状态,v2 scope=slice 且 auto_continue 时用 agent-collab checkpoint advance 继续同一授权目标,普通合格切片转换无需人工覆盖,v2 action checkpoint 需上下文压缩时在更小的链接包中保留证据与授权、记录实测活跃大小、执行前重新评估,维护不是人工审批门;stop 遵守其范围,action stop 禁止重复该动作,主智能体可只读诊断或准备有证据支持的修正,goal stop 保留硬限制或人工门。v1 决策在显式迁移前保留原检查点/停止语义,不得静默重新解释旧记录。基础设施错误是错误证据,不是重试许可;重试需下一次策略评估允许。
状态:写入 .coord/par_.yml(含 schema_version、goal、policy_ref、checkpoint_ref、acceptance_criteria、critique_source、cycles、final_status)与 .coord/par__final.md(最终状态、最后 PolicyDecision、验收证据、未成功尝试、未解决风险、所需人工决策)。两文件默认是草稿,仅显式发布或验收证据才提升。
记忆:绝不直接写规范记忆,在 .coord/memory-proposals/ 下创建带证据引用的提案;应用需记录人工批准并追加新事件,绝不编辑旧事件。
不变量:每轮循环后及每次生成前评估;跨切片、会话与执行器保留累计用量与失败历史,未知 token/成本保持未知而非零,显式目标限制与平台原生限制保持硬性,缺失限制不得臆造;使用基于操作、目标、相关输入与错误类的稳定失败标识,重命名任务或切换执行器不算修正;等待外部服务不是失败重试,仅在具备新证据、安全下一步与所需验收检查时继续;升级前诊断可恢复动作失败并做安全上下文维护,不要要求用户续期未变授权;实际人工干预与自动恢复或等待分开计数,更少暂停绝不构成绕过真实门或声称未测量成功的理由;智能体自我批判不是独立验收;人类语义门不能被聚合智能体评分替代;PASS 需引用验收证据,而非“看起来不错”。