多智能体编排模式

1. 将任务分解为带清晰交接的角色： 规划者：读规格，输出带文件目标的步骤列表。 编码者：取一步，实现，运行门禁。 审查者：将编码者输出与步骤 diff，批准或拒绝。 2. 选择编排拓扑： - 流水线：规划者 -> 编码者 -> 审查者，线性，最简单。 - 循环：编码者 -> 审查者 -> 编码者，直到审查者批准。 - 扇出：规划者拆为 N 个独立编码者运行，再合并。 3. 智能体间显式传递上下文，绝不隐式： - 规划者输出（步骤列表）是编码者输入。 - 编码者输出（diff + 门禁结果）是审查者输入。 - 将交接序列化为 JSON 文件，使每个智能体干净启动。 4. 用限定上下文运行编码者（仅该步骤的文件）： claude --scope src/api/ "实现步骤 3：POST /api/books" 5. 用审查者智能体门控，不仅是测试： "将此 diff 与步骤规格对比。若添加未要求文件、使用禁用模式、 或未通过任何验收标准则拒绝。输出 APPROVE 或 REJECT + 原因。" 6. REJECT 时循环：将审查者原因作为下一提示词喂回编码者。 循环上限 3 次；超过则升级给人工。 7. 合并已批准步骤并运行完整门禁： npm run check && npm test && npm run build 提交合并结果并附智能体运行摘要。

带 JSON 交接的流水线编排（Node.js 驱动）： // 1. 规划者 const plan = await runAgent({ role: "planner", prompt: "将 '添加 books hub' 分解为带文件目标的步骤。输出 JSON。", }); // plan = [{ step: 1, target: "src/data/books.ts", task: "添加 Books 类型 + CRUD" }, ...] // 2. 每步编码者 + 审查者循环 for (const s of plan) { let verdict = "REJECT", tries = 0; while (verdict === "REJECT" && tries < 3) { const diff = await runAgent({ role: "coder", scope: s.target, input: s }); verdict = await runAgent({ role: "reviewer", input: { s, diff } }); if (verdict.startsWith("REJECT")) s = { ...s, feedback: verdict }; tries++; } if (verdict.startsWith("REJECT")) throw new Error(`步骤 ${s.step} 审查失败`); await commit(diff); } // 3. 最终门禁 await run("npm run check && npm test && npm run build");