企业官网建设流程全解析

如果你用过 Claude Code 或 Codex，大概率遇到过这样的场景：你让 AI 加一个功能，它二话不说直接开写，结果产出的 400 行代码和你的代码库格格不入。vibecode-pro-max-kit用一套"协调者编排架构"解决了这个问题：主 Agent（协调者）从不做实际代码修改，它只负责路由、委派和监控；所有研究、写计划、写代码的工作都交给 15 个专职子代理完成。本文带你读懂这套多 Agent 协调机制的设计原理，以及它为什么能让 AI 开发更靠谱。

一句话核心：主 Agent 是"项目经理"，不是"码农"

在 vibecode-pro-max-kit 中，你的主会话被明确定义为coordinator（协调者），而不是 worker（干活的）。它只干四件事：

规则写得很直白——完整定义见 AGENTS.md 的Orchestrator Role章节：

"You are the orchestrator, not the worker."（你是编排者，不是执行者。）

主 Agent 被明确禁止：自己做 RESEARCH、自己头脑风暴 INNOVATE、自己写 PLAN、自己 EXECUTE 写代码。

为什么不让主 Agent 亲自下场？三个设计动机

动机一：权限是硬约束，不是"君子协定"

很多提示词工程只会"建议"AI 先规划再写码，但模型在长会话里总有找到捷径的动机。vibecode-pro-max-kit 的做法是从工具层面剥夺能力：

• vc-research-agent只有 Read/Grep/Glob——物理上无法修改文件
• vc-innovate-agent连 Bash 都没有——只能讨论方案
• vc-plan-agent只能写process/目录下的计划文件
• 只有vc-execute-agent拥有完整读写权限，且必须在你明确说 "ENTER EXECUTE MODE" 后才能启动

这套"按阶段锁定工具"的设计（Step-Locked Tool Restrictions）让流程在结构上诚实：想写代码，唯一的路径就是走完研究、规划、验证。

动机二：上下文隔离，避免"上下文腐化"

主 Agent 的对话上下文会随着任务越滚越大。如果所有工作都在主会话里做，长任务进行到一半就会上下文溢出、开始"幻觉"。

协调者模式把每份工作放进独立的上下文窗口：子代理只收到任务摘要、要读/改的文件清单、验收标准，而不是一整段聊天历史。规则详见 orchestration.md 的Context Isolation章节。附带的好处是省钱——各子代理各用各的 token 预算，规划类工作还能自动分配给更便宜的模型，只有真正写代码的子代理才用最贵的模型。

动机三：可验证的"无隐藏执行"

协议里有一条机械规则：只要存在带验证契约的计划文件，"ENTER EXECUTE MODE"永远意味着派生vc-execute-agent，哪怕只是改一行代码；跑测试也永远由独立的vc-tester子代理执行。主 Agent 在自己的 shell 里编辑源码或跑门禁命令，会被视为协议违规——即使最终结果全绿也算违规。

一次请求的完整旅程：从你输入到代码落盘

以一个典型的功能请求为例，协调者的完整动作链如下（RIPER-5 七阶段，每步都有质量门禁）：

1. 技能发现：扫描技能目录，比如你说"加 webhook 支持"，vc-security、vc-scenario会被自动附上
2. 意图评分：4 个二元信号打分（0–4 分）——模糊的请求会先问几个选择题，清晰的请求直接静默路由
3. RESEARCH→ 派生vc-research-agent（只读）
4. SPEC→vc-spec-agent产出需求文档，等你确认"造的是不是你要的东西"
5. INNOVATE → PLAN→ 探索 2–3 种方案，再写成详细计划
6. VALIDATE→vc-validate-agent跑 V1–V7 检查点，给出 PASS / CONDITIONAL / BLOCKED 裁决
7. EXECUTE→vc-execute-agent严格按计划实现
8. EVL 独立复测→ 即使执行代理说"全绿"，协调者也必须派生vc-tester独立重跑门禁测试

每个阶段结束时，协调者还会调用vc-agent-strategy-compare技能，为下一阶段选择最优执行策略：顺序执行、并行子代理、工作流，还是带共享任务列表的agent team（4 种策略各有成本估算，详见 README.md 的Strategy Compare一节）。

状态码协议：子代理之间"说什么"

协调者与子代理之间用一套极简但严谨的通信协议，每个子代理结束时必须返回 4 种状态码之一：

配套纪律同样明确：同一个被阻塞的方案最多重试一次就不再重复，绝不死磕。子代理是"发射后即弃"（fire-and-forget）的——它们汇报完就终止，只有协调者有权重新派生代理。这意味着修复循环（PVL/EVL）的"方向盘"始终握在协调者手里，没有任何子代理能自我续命或越级开工。

这套编排架构给普通用户带来什么

如果你不写代码、只是用 AI 做产品，这套设计直接翻译成三个好处：

• ✅可审查：规划先落成 Markdown 文件（process/general-plans/active/），你和产品经理能在写码前审同一份书面计划
• ✅不跑偏：SPEC 需求文档像"尺子"一样，之后每个阶段都会回头对照"造的是不是你要的"
• ✅可恢复：进度、报告、学到的经验全部落盘，会话重置后协调者重读磁盘状态就能从断点继续

关键文件导航：想深入看源码从这里入手

小结

vibecode-pro-max-kit 的协调者编排架构，本质上是把"人类团队的分工原则"搬进了 AI 开发：决策者不亲手写代码，执行者只对契约负责，沟通用标准化状态码，质量靠独立复测。主 Agent 从不碰代码，不是功能缺失，而是一个刻意的架构决策——让"走完整流程"成为写代码的唯一通道。这正是它能同时驾驭新手和工程师、在任何技术栈上稳定交付的原因。