Appearance
从 Vibe Coding 到工程化 AI 编程
Vibe Coding 让想法可以很快变成一个能点、能看、能试的原型。它适合把“后台订单能不能导出”这样的问题先做出形状：页面上出现导出按钮，选择时间范围后能下载文件，产品和运营能用真实流程判断这个能力有没有价值。
但原型不是交付。订单导出一旦进入真实后台，就会牵涉权限、数据范围、文件格式、性能、审计日志、失败重试和发布回滚。只靠“看起来能用”的反馈，很难判断它是否可以承受真实用户、真实数据和真实事故。
这个专题的主线是：同一个订单导出功能，如何从快速原型逐步走到可维护、可验证、可协作的工程化交付。
各部分负责什么
Vibe Coding 负责把想法变成可观察的东西。它不追求一开始就完整，而是先验证用户是否真的需要这个能力、交互是否顺手、业务流程是否跑得通。订单导出的原型阶段可以只支持最近 7 天数据、只导出 CSV、只在测试数据上验证。
提示词工程负责把“加个导出功能”翻译成任务规格。它要说明导出入口在哪里、支持哪些筛选条件、文件格式是什么、哪些模块不能改、完成后如何验证。提示词越接近规格，模型越少依赖猜测。
上下文工程负责让模型看到真实项目。订单导出不是孤立按钮，它需要现有订单列表代码、权限判断、历史导出接口、字段含义、慢查询日志和构建命令。上下文太少会让模型补错细节，上下文太乱会让它抓错重点。
工具与 Agent 工程负责把建议变成行动闭环。Agent 可以读文件、改代码、补测试、跑构建、根据错误继续修复，最后用 diff、测试结果和风险说明证明工作是否完成。
Harness 工程负责给 Agent 的行动加上规则和护栏。订单导出如果可能导出隐私字段，Harness 就要用测试、静态扫描、CI、权限白名单和人工确认点阻止错误进入主干。
组织流程工程负责把一次项目经验沉淀成团队常识。导出字段清单、权限策略、审计要求、性能阈值和常见 review 意见，应该进入规格库、Checklist、风险库或 Skill，而不是散落在聊天记录里。
Spec-Driven 是贯穿所有层次的方法。它把判断标准从“感觉可以”变成“规格满足”：导出什么、不能导出什么、失败时怎样提示、哪些命令必须通过，都要能被检查。
订单导出的演进路径
| 阶段 | 主要问题 | 订单导出里的表现 | 详细说明 |
|---|---|---|---|
| Vibe Coding | 这个能力是否值得做 | 做出导出按钮、筛选项和下载反馈 | 原型快速验证 |
| 提示词工程 | 任务是否说清楚 | 明确字段、格式、权限、禁区和验收标准 | 清晰的任务规格 |
| 上下文工程 | 模型是否看到真实项目 | 提供订单模块、权限规则、接口文档和日志 | 上下文资料包 |
| 工具与 Agent 工程 | 能否执行并验证 | 改代码、补测试、跑构建、根据失败修复 | 可验证的行动闭环 |
| Harness 工程 | 行动是否被规则约束 | CI、字段白名单、审计日志、人工确认点 | 规格的强制执行体系 |
| 组织流程工程 | 经验能否复用 | 沉淀导出规格模板、风险清单和 Skill | 团队常识 |
| Spec-Driven | 什么时候算完成 | 以规格、测试和验收结果判断完成度 | 从感觉到规格 |
| 项目实战 | 如何端到端落地 | 从需求、Spec、Agent、Harness、CI/CD、Review 到部署 | 交付闭环 |
这条路径不是要求每个小任务都套完整流程。它更像一组逐级加严的工程能力：风险越高、生命周期越长、参与者越多，就越需要把规格、上下文、验证和组织规则补齐。
从原型到交付的边界
订单导出原型可以接受很多简化：只导出少量测试数据，字段先写死，错误提示比较粗糙，甚至可以暂时不接真实权限。原型的目标是发现方向问题，例如运营是否需要按支付状态筛选，文件名是否要包含时间范围，下载是否应该异步生成。
进入工程化后，边界会发生变化。导出文件可能包含收货人、手机号、金额和优惠信息，权限错误就是数据泄露；导出范围过大可能拖慢数据库；失败后没有审计日志会让排查失去线索。此时“能下载文件”只是最低要求，真正的交付标准是权限正确、字段可控、性能可接受、失败可恢复、行为可追踪。
可以用下面的判断决定是否进入下一层：
| 信号 | 说明 |
|---|---|
| 真实用户会使用 | 需要从 Vibe 进入提示词和上下文工程 |
| 涉及真实数据 | 需要补权限、字段白名单和审计规格 |
| 需要长期维护 | 需要测试、构建和清晰目录边界 |
| 多人参与开发 | 需要共享规格和上下文包 |
| 改动影响核心链路 | 需要 Harness、人工确认和回滚方案 |
阅读路径
第一次接触这个专题，可以按从前到后的顺序阅读。先看 Vibe Coding 理解原型阶段的价值和边界，再看 提示词工程 与 上下文工程 理解为什么任务说明和项目资料会决定输出质量。
已经在使用 Agent 改代码，可以重点阅读 工具与 Agent 工程 和 Harness 工程。前者讲执行闭环，后者讲如何限制错误行动。
团队准备规模化使用 AI 编程时，应补充阅读 组织流程工程 和 Spec-Driven。它们回答的是同一个问题：团队如何把判断标准从个人经验变成可复用的系统规则。
需要把这些内容落到客户项目时，可以直接阅读 项目实战。它按需求、Spec Driven、AI Agent、Harness、CI/CD、PR Review 和部署串起完整交付链路。
总结
Vibe Coding 的价值是缩短反馈距离，让想法尽快进入真实观察。工程化 AI 编程的价值是把这种速度放进可靠边界中，让快速迭代不会变成快速返工。
订单导出这个例子说明：AI 编程不是少做工程，而是更早暴露工程问题。越早把规格、上下文、工具验证和组织规则补齐，后续维护越少依赖运气。