Vibe Coding 官方文档锚定:让 AI 按仓库实际版本写代码
AI 熟悉的 API 可能属于另一版本,搜索结果也常默认展示最新版。本文从锁文件和本地包确定真实版本,再把官方文档、迁移说明与废弃项绑定到任务,避免写出“语法正确但版本不对”的补丁。
Vibe Coding、Cursor、Claude Code、Codex、Copilot
本专题收录 AI 编程 方向的文章和社区讨论,重点关注真实工程场景、工具选择、实践路径和风险边界。
页面会持续更新,适合作为学习路线、选型参考和技术复盘入口。
AI 熟悉的 API 可能属于另一版本,搜索结果也常默认展示最新版。本文从锁文件和本地包确定真实版本,再把官方文档、迁移说明与废弃项绑定到任务,避免写出“语法正确但版本不对”的补丁。
新会话只收到“继续刚才的任务”,往往会重复操作、相信旧测试或覆盖未提交改动。本文设计一份重启摘要,分开已确认事实、工作树现状、已完成步骤、未决决策与下一条安全动作。
清空旧对话或删掉最长文件,不等于得到更好的上下文。本文用改动影响图、必留证据、可再取索引与删减试验,裁掉陈旧和重复材料,同时保住权限、调用方与验证边界。
只给 AI 一张成功态截图,它会自行猜测等待、空数据、失败和无权限行为。本文用状态矩阵、优先级与转换规则,让每个关键界面都有明确文案、动作和可测试出口。
开发中一句“顺便改一下”会让旧测试继续变绿,却不再证明新的承诺。本文用规格版本、变更分类、冻结窗口、影响图和差量重验,确保范围变化经过明确接受。
“要快、要安全、体验友好”无法约束 AI 的实现选择。本文把非功能目标写成带环境、分位数、威胁边界、无障碍场景和失败动作的预算,并纳入每轮回归。
让 AI 直接“设计数据库”容易得到命名整齐却无法阻止非法状态的表。本文从身份、基数、状态转换、并发和删除规则出发,把业务不变量落实到约束与可验证事务。
只写“创建任务接口”会让 AI 自行选择字段、状态码、错误结构和重试语义。本文用 OpenAPI、成对示例、领域错误、幂等性与契约测试固定消费者真正可观察的行为。
“做一个更聪明的待办应用”会让 AI 很快产出,却无法判断是否解决了真实问题。本文用场景、现状、损失、证据与反证条件,把灵感压缩成可验证的问题陈述。
面向“所有人”并同时铺开注册、设置、搜索和管理后台,会让 AI 生成大量无法取舍的页面。本文用行为分群、角色边界和端到端主路径把首轮交付压缩到一个结果。
先生成整套页面、再补后端与测试,会留下大量无法验收的半成品。本文示范如何沿一个用户结果切穿界面、接口、数据和验证,并让每轮 AI 改动都可运行、可删除。
Agent 说“已完成”可能只表示代码已生成或某条命令变绿。本文区分验收条件、团队完成定义、发布门和非目标,并用绑定当前变更的证据阻止漏项与顺手扩张。