Vibe Coding 配置与环境矩阵:找清变量从哪里来、在哪一刻生效
在本地能读到环境变量,不代表构建、测试和生产使用同一来源。本文建立配置矩阵,逐项标出定义、注入、读取、默认值、优先级、敏感性与生效阶段,防止 AI 用硬编码修复环境差异。
Articles
沉淀 AI、Web、云原生和独立开发经验。
在本地能读到环境变量,不代表构建、测试和生产使用同一来源。本文建立配置矩阵,逐项标出定义、注入、读取、默认值、优先级、敏感性与生效阶段,防止 AI 用硬编码修复环境差异。
只给 AI 一句需求,会迫使它自行猜测仓库状态和验收口径。本文定义一份轻量任务上下文包,把目标、非目标、代码基线、允许范围、验证命令与未知项组合成可复查的开工输入。
给 AI 一个“照着写”的文件,常会连同偶然实现和旧缺陷一起复制。本文说明如何成对准备正例、反例、判定理由与适用边界,让示例成为需求证据而不是隐含模板。
AI 熟悉的 API 可能属于另一版本,搜索结果也常默认展示最新版。本文从锁文件和本地包确定真实版本,再把官方文档、迁移说明与废弃项绑定到任务,避免写出“语法正确但版本不对”的补丁。
新会话只收到“继续刚才的任务”,往往会重复操作、相信旧测试或覆盖未提交改动。本文设计一份重启摘要,分开已确认事实、工作树现状、已完成步骤、未决决策与下一条安全动作。
清空旧对话或删掉最长文件,不等于得到更好的上下文。本文用改动影响图、必留证据、可再取索引与删减试验,裁掉陈旧和重复材料,同时保住权限、调用方与验证边界。
只给 AI 一张成功态截图,它会自行猜测等待、空数据、失败和无权限行为。本文用状态矩阵、优先级与转换规则,让每个关键界面都有明确文案、动作和可测试出口。
开发中一句“顺便改一下”会让旧测试继续变绿,却不再证明新的承诺。本文用规格版本、变更分类、冻结窗口、影响图和差量重验,确保范围变化经过明确接受。
“要快、要安全、体验友好”无法约束 AI 的实现选择。本文把非功能目标写成带环境、分位数、威胁边界、无障碍场景和失败动作的预算,并纳入每轮回归。
让 AI 直接“设计数据库”容易得到命名整齐却无法阻止非法状态的表。本文从身份、基数、状态转换、并发和删除规则出发,把业务不变量落实到约束与可验证事务。
只写“创建任务接口”会让 AI 自行选择字段、状态码、错误结构和重试语义。本文用 OpenAPI、成对示例、领域错误、幂等性与契约测试固定消费者真正可观察的行为。
“做一个更聪明的待办应用”会让 AI 很快产出,却无法判断是否解决了真实问题。本文用场景、现状、损失、证据与反证条件,把灵感压缩成可验证的问题陈述。