阶段切换：进入 AI Vibe Coding 路线。
本章目标：先搭工作流，不先卷提示词；把“AI 帮忙写点代码”升级为“稳定可交付的协同生产系统”。
学习目标
完成本章后，你应该能做到：
- 为 AI 协同开发定义清晰的人机分工。
- 建立任务契约（输入、输出、边界、验收）避免返工。
- 用上下文切片降低“上下文污染”和幻觉风险。
- 把 AI 产出纳入现有工程门禁（测试、性能、发布）。
为什么 Vibe Coding 会翻车
团队常见误区：
- 把 AI 当“全自动程序员”，需求还没收敛就开始生成。
- 提示词只描述目标，不描述约束和验收标准。
- AI 产出直接合并，缺少回归验证。
- 上下文过载，导致输出风格和架构漂移。
本质问题不是模型能力，而是工作流缺失。
协同模型：人机双工位
建议固定两个工位角色：
Planner（人主导）：问题拆分、约束定义、验收标准。Builder（AI执行）：实现、重构、测试补齐、文档草稿。
人类负责方向和质量边界，AI 负责高密度执行。
任务契约模板
每个 AI 任务必须包含 5 要素：
- 目标：要解决什么问题。
- 范围：允许改哪些文件，不许动哪些模块。
- 约束：性能、兼容、风格、依赖限制。
- 验收：可执行的通过标准。
- 回滚点：失败时如何安全撤回。
示例
目标：为关卡结算页新增“升级路径回顾”模块
范围：仅改 UI 层和结算聚合器；不改战斗逻辑
约束：WebGL 内存增加 < 5MB；不新增第三方依赖
验收：3个场景快照一致；构建通过；回放结果一致
回滚点：保留旧结算面板路由开关，可一键回退上下文切片策略
不要把整个仓库丢给 AI。按任务分 3 层：
Core Context：必须读取的 3~8 个关键文件。Policy Context：规范文件（命名、架构、门禁）。Optional Context：可能有帮助但非必要的资料。
优先给最小上下文，减少错误扩散。
Vibe Coding 工作流（推荐）
- 定义任务契约（人）
- 最小上下文注入（人）
- AI 产出第一版变更（AI）
- 自动化门禁验证（CI/本地）
- 人工评审“方向正确性”（人）
- 合并/回滚（人）
重点：AI 负责“快”，人负责“对”。
风险分级与处理
低风险（可放权）
- 文档更新
- 测试补齐
- 小型重构
中风险（半放权）
- 多文件改动
- 配置结构调整
- 性能敏感逻辑
高风险（强审查）
- 经济与奖励逻辑
- 排行榜与安全相关路径
- 发布与回滚链路
高风险任务必须双重验收：自动化 + 人工走读。
输出规范（让 AI 稳定）
要求 AI 每次交付都包含：
- 改动文件列表
- 风险点说明
- 测试执行结果
- 未覆盖风险
这能显著降低“看似完成、实则漏项”。
与现有工程体系对齐
将 AI 流程接入你已有体系：
- 配置门禁：AI 改配置也必须过校验器。
- 性能门禁：AI 改动触发压测阈值检查。
- 发布门禁：AI 改动不能绕过灰度流程。
- 埋点对比：AI 方案上线后看真实指标，不看主观感受。
度量指标
首月建议跟踪 6 个指标：
- AI 任务一次通过率
- 平均交付时长
- 回归缺陷率
- 代码评审驳回率
- 人工返工时长
- 版本发布成功率
常见坑
坑 1：只优化“生成速度”
没有验收闭环，速度越快问题越多。
坑 2：任务边界不清
AI 会跨模块改动，造成隐性风险。
坑 3：把评审变成形式化
必须评审“架构方向”和“风险暴露”，不只是看能否编译。
本月作业
搭建你的第一版 AI 协同流水线：
- 选 3 类低风险任务做 AI 执行。
- 强制使用任务契约模板。
- 记录一周指标并复盘哪些环节最耗时。
下一章：AI Vibe Coding 02《提示词不是咒语：任务分解、约束注入与可验证输出设计》。