（4079期）Competitive Agent Loop – 多 Agent 竞争式代码生成引擎

多 Agent 竞争式代码生成引擎 基于分离式四角色架构的自动化软件开发流程，通过多方案竞争、量化评分与质量门迭代，在 RTX 4090 显存约束下实现高可靠代码生成与审查。 使用说明 核心用法 Competitive Agent Loop 是一套分离式多 Agent 自动化软件开发工作流，专为复杂编程任务设计。系统包含四个独立角色：Planner（规划） 负责任务分解与全局调度，Coder（编码） 生成多方案实现，Checker（审查） 执行量化评估与质量验证，Memowriter（记录） 产出项目文档。 任务进入后，Planner 首先进行复杂度评估（基于文件数、测试需求、架构变更等变量计算得分），按低/中/高复杂度分流处理。中高风险任务触发四阶段冲刺循环：阶段 A（冲刺契约）要求 Planner 与 Coder 经多轮谈判锁定契约终稿；阶段 B（多方案竞争）由 Coder 生成 2-3 个独立方案，Checker 按 0-10 分制量化打分；阶段 C（质量门迭代）依据评分执行 PASS/RETRY/BLOCKED 决策，支持每冲刺最多 3 次返工；阶段 D（归档）完成文档产出与任务推送。 执行层采用双节点架构：CPU 节点（NAS，qwen3.5:4b）专职调度，GPU 节点（RTX 4090）运行编码与审查模型。通过 sessions_send 派发至各 Agent 的 QQ 主会话，确保执行全程可见可审计；Workboard 卡片系统实现任务持久化追踪，状态流转严格受控。 显著优点 质量保障机制扎实：多方案竞争（≥2 个）+ Checker 独立量化评分（8 维度 0-10 分制）+ 质量门迭代（RETRY 循环），显著降低单点失败风险。契约驱动开发（阶段 A）强制对齐需求边界，避免实现偏离。 显存约束下资源优化：针对 RTX 4090 24GB 设计串行执行策略，编码（~20GB）与审查（~6GB）代理互斥运行，通过 Workboard 状态机精确控制加载时序。兜底链策略（四级降级）应对 VRAM 溢出、Provider 超时等异常。 可审计与可追溯：所有跨代理通信强制走 Workboard 评论留痕，禁用文件系统/内存直接共享状态。QQ 主会话全程可见，sessions_send 派发替代不可见的 subagent 派生。 复杂度自适应：量化评分公式（score = fileCount×2 + testRequired×3 + architectureChange×5 + unknownDependencies×4）自动分流，避免过度设计或资源浪费。 潜在缺点与局限性 执行周期较长：复杂任务可能耗时数小时至数天，无固定执行超时，依赖质量门控制进度。人工介入阈值（连续 3 轮重试无改善、BLOCKED 状态）可能延迟问题暴露。 硬件依赖严苛：RTX 4090 为设计基准，显存不足时需触发兜底链降级，可能影响生成质量。编码代理独占大模型（Qwen3.6-27B-MTP-CODER ~20GB），单卡无法并行多任务。 通信协议复杂：sessions_send timeoutSeconds 仅为等待首次确认时间（建议 300s），实际产出需轮询 Workboard，理解成本较高。四角色协作涉及 10+ API 调用（claim/complete/comment/heartbeat 等），上手门槛不低。 模型生态锁定：深度依赖 Ollama 本地部署（Qwen3.6-MTP/UD 系列、Qwythos），云端 API 仅作兜底（deepseek-v4-flash、ctyun/glm-5）。私有模型权重未公开，迁移成本未知。 适合的目标群体 独立开发者/小团队：拥有 RTX 4090 级显卡，需自动化处理中等复杂度以上编程任务（多文件修改、需测试验证）。 代码质量敏感型项目：对正确性、性能、健壮性、可读性有量化要求的工程场景，如 API 服务、工具库开发。 AI Agent 工作流研究者：探索多 Agent 协作、竞争式生成、质量门控制等机制的实验性用户。 不适配：无本地 GPU 资源、追求极速交付（可容忍质量波动）、或任务复杂度极低（单文件 <50 行）的场景。 使用风险 性能风险：长任务 heartbeat 间隔 >15 分钟可能被标记 stale，dispatcher 误回收导致状态丢失。GPU 模型首次加载或换载耗时，高频调度场景下 CPU 4b 轮询可能延迟。 依赖项风险：Ollama 服务需常驻（keep_alive=1h），NAS/ GPU 节点网络中断将阻断执行。Workboard 插件与 OpenClaw Gateway 深度绑定，第三方平台不可直接用。 迭代失控风险：总迭代上限 5 轮（跨冲刺）+ 每冲刺重试上限 3 次，但"无改善"判定依赖评分变化，可能陷入无效循环消耗资源。 状态一致性风险：workboard_claim 原子性依赖后端实现，极端并发下（多 Planner 实例）可能出现归属冲突。阶段门禁凭证人工核验（Planner 职责），若 Planner 自身异常可能带病进入下一阶段。 原始说明 3-Agent competitive loop with Planner/Generator/Evaluator and Sprint Contract