文章目录开篇本文不会讨论什么一、为什么第一周结束后要做一次复盘二、这一周的 7 条 AI 编程原则原则 1让 AI 参与开发但不要把判断交出去原则 2项目上下文比角色设定更重要原则 3需求不清时先让 AI 补问题不要让它补代码原则 4复杂任务先要方案再要代码原则 5把 AI 输出当作草稿必须回到代码和测试中验证原则 6工具应该服务于工作流而不是反过来改变工作目标原则 7把一次有效协作沉淀成下一次可以复用的资产三、把 7 条原则压缩成一张检查卡四、第一周复盘哪些方法值得继续保留五、下一周的实践方向六、总结✍创作者全栈弄潮儿²⁰²⁶ 个人主页全栈弄潮儿²⁰²⁶ 专栏地址AI 编程进阶实战开篇这是《AI 编程进阶实战》的第 7 篇也是第一周的复盘文章。过去 6 篇我们没有急着比较工具也没有直接讨论如何让 AI 一次生成完整项目而是沿着一条研发主线逐步展开认识 AI 编程的边界 ↓ 识别常见使用陷阱 ↓ 盘点自己的开发工作流 ↓ 搭建 AI 编程工作台 ↓ 写出更完整的编程 Prompt ↓ 把模糊需求拆成开发任务如果只看单篇文章你可能会记住几个 Prompt、几个流程或几个案例。但真正值得保存的是这些内容背后的原则。因为工具会变化模型会变化项目也会变化。而好的原则可以帮助你在换工具、换团队、换技术栈之后仍然保持稳定的判断方式。这一篇不再展开新的工具和案例。我们只做一件事把这一周最值得长期保存的 7 条 AI 编程原则提炼出来。本文不会讨论什么为了让复盘真正有价值本文不会重新复述前 6 篇的全部内容。给出所谓“最强模型”或“万能工具”的结论。把 AI 编程原则写成必须机械执行的流程。用生成代码数量衡量这一周的效率。把 AI 的建议包装成不需要验证的答案。复盘的重点不是证明我们已经掌握了多少工具而是确认哪些方法已经可以变成下一周继续使用的工作习惯一、为什么第一周结束后要做一次复盘AI 编程很容易带来即时反馈。一段代码很快生成一个报错很快得到解释一份需求很快变成任务列表。但即时反馈不等于长期能力。如果没有复盘你可能只会留下这些模糊印象这次 AI 好像帮了不少忙。某个 Prompt 看起来挺好用。某个工具的体验不错。下次遇到类似问题再试试。这些印象很快会消失。一次有效的复盘至少要回答三个问题AI 具体在哪个环节帮到了我哪些地方的输出需要我重新判断和验证下次遇到类似任务我能复用什么可以把复盘结果分成三类资产资产类型具体内容判断原则什么时候应该问问题什么时候可以让 AI 写代码工作模板Prompt、任务卡、测试清单和复盘表验证习惯如何检查代码、日志、测试和改动范围本周的 7 条原则正是从这三类资产中提炼出来的。二、这一周的 7 条 AI 编程原则原则 1让 AI 参与开发但不要把判断交出去AI 可以参与需求分析、代码阅读、方案设计、代码生成、测试和排障。但它不能替开发者承担最终判断需求是否真的理解正确。方案是否适合当前系统。代码是否符合团队规范。异常、权限和安全边界是否完整。这个改动是否值得进入生产环境。第一周最重要的定位是AI 是工程协作伙伴不是最终决策者。可以用下面这条边界提醒自己AI 提供候选答案 ↓ 开发者确认事实和规则 ↓ 代码与测试验证结果 ↓ 开发者承担最终交付责任如果一次任务结束后你无法解释为什么接受这段代码、为什么采用这个方案那么这次协作还没有真正完成。原则 2项目上下文比角色设定更重要“你是一名资深工程师”可以帮助 AI 进入某种回答风格。但它不能代替真实项目上下文。决定代码能否落地的通常是这些信息当前使用什么技术栈。相关模块如何分层。已有接口和数据结构是什么。项目如何处理异常、日志和权限。测试和验证命令是什么。本次修改范围和禁止修改范围是什么。因此一条高质量 Prompt 不应该只写你是一名资深后端工程师请帮我实现这个功能。更应该写项目使用什么技术栈 当前代码位于什么模块 哪些规则已经确认 哪些文件允许修改 如何判断实现完成。没有上下文的“资深角色”只能产生更流畅的猜测。原则 3需求不清时先让 AI 补问题不要让它补代码当需求只有一句话时最危险的动作是直接要求 AI 生成完整实现。因为代码一旦生成很多未经确认的假设就会被藏进实现细节里。更稳妥的顺序是原始需求 ↓ 待确认问题 ↓ 业务规则 ↓ 接口和数据约束 ↓ 开发任务 ↓ 代码实现可以让 AI 先回答请先不要写代码。 请从业务规则、权限、数据、接口、异常、并发和验收标准几个方面 列出这条需求中仍然需要确认的问题。 请区分 1. 已知事实。 2. 可以暂时假设的内容。 3. 必须由产品或开发者确认的内容。AI 在这里的价值不是替你决定业务而是帮助你发现那些原本容易被忽略的问题。原则 4复杂任务先要方案再要代码涉及以下内容时不建议第一轮就要求完整代码状态流转。权限和角色。金额和库存。数据库事务。并发和幂等。跨模块或跨服务调用。可能影响已有功能的重构。更可靠的协作方式是分轮次进行第一轮复述需求、列出假设和风险 第二轮比较方案、确认模块边界和测试点 第三轮生成最小实现 第四轮补充测试并审查改动这并不会降低 AI 的效率。相反它能避免 AI 在错误的前提下生成大量代码减少后续返工。原则 5把 AI 输出当作草稿必须回到代码和测试中验证AI 的输出可能很完整也可能很有说服力。但“完整”和“正确”是两回事。至少要检查[ ] 是否符合项目现有分层和规范 [ ] 是否修改了不应该修改的文件 [ ] 是否处理了空值、异常和边界输入 [ ] 是否遗漏权限、数据安全或并发问题 [ ] 是否补充了正常、边界和异常测试 [ ] 是否实际运行过测试、静态检查或接口验证对于代码改动还应查看差异查看修改文件 ↓ 查看具体 diff ↓ 运行格式化和静态检查 ↓ 运行单元测试 ↓ 验证关键业务场景没有验证的 AI 输出只能叫建议不能叫交付。原则 6工具应该服务于工作流而不是反过来改变工作目标第一周我们把 AI 工作台拆成了几层工作层更适合做什么对话层需求澄清、方案比较、排障假设IDE 层阅读当前代码、小范围修改和即时反馈终端层执行命令、运行测试、批量处理和验证模型层根据任务复杂度选择快速、主力或深度模型上下文层保存项目结构、规范、测试和安全边界工具选择应该从工作流出发我现在处于哪个研发环节 ↓ 这个环节需要什么输入和输出 ↓ 结果如何验证 ↓ 哪个工具最适合完成这一步不要因为某个工具有自动修改功能就把不适合自动化的任务交给它。也不要因为某个模型很强就用它处理所有简单问题。原则 7把一次有效协作沉淀成下一次可以复用的资产如果每次使用 AI 都从空白对话开始你会不断重复说明相同的项目背景和工作要求。建议至少保存下面 4 类内容有效 Prompt。已确认业务规则。测试和验收清单。AI 遗漏问题与人工修正记录。可以把每次任务结束后的复盘写成这样本次任务 [填写] AI 参与的环节 [需求 / 代码阅读 / 方案 / 实现 / 测试 / 排障] 最有效的上下文 [填写] AI 漏掉的问题 [填写] 最终验证方式 [测试 / 日志 / 联调 / 代码审查] 下次可以复用 [Prompt / 清单 / 模板 / 代码片段]真正属于你的 AI 编程能力不是记住某一句 Prompt而是不断积累这些经过验证的资产。三、把 7 条原则压缩成一张检查卡如果不想每次阅读完整文章可以保存下面这张检查卡AI 编程 7 条原则 1. AI 参与开发但不替我做最终判断。 2. 项目上下文比角色设定更重要。 3. 需求不清时先补问题不补代码。 4. 复杂任务先要方案再要实现。 5. AI 输出只是草稿必须回到代码和测试中验证。 6. 工具服务于工作流不让工具牵着任务走。 7. 把有效协作沉淀成 Prompt、规则和检查清单。这张卡可以放进你的项目文档、个人知识库或工作台配置中。四、第一周复盘哪些方法值得继续保留建议在周末用 10 分钟回答下面的问题1. 本周哪个任务使用 AI 后真正减少了返工 2. AI 在哪个环节最容易产生错误假设 3. 我是否提供了足够的项目上下文 4. 我是否在生成代码前确认了需求和规则 5. 我是否实际检查了 AI 修改的文件和测试结果 6. 哪一条 Prompt 可以沉淀为模板 7. 下周准备把 AI 引入哪个新的研发环节也可以用表格记录复盘项目本周记录最有效的 AI 使用场景需求澄清、代码阅读、测试或其他最大的错误假设AI 漏掉了什么最值得保存的 Prompt粘贴或链接最需要补充的项目上下文目录、规范、接口或测试下周实验目标只选一个具体环节复盘时不要只统计“生成了多少代码”。更值得关注的是是否减少了重复沟通。是否更早发现了边界问题。是否更快理解了陌生代码。是否提高了测试和验证的完整度。是否留下了下一次可以复用的资产。五、下一周的实践方向第一周我们主要建立了方法和工作台。接下来可以进入更贴近真实项目的代码理解与开发场景用 AI 快速读懂陌生项目。让 AI 梳理目录、入口和调用链。让 AI 协助定位一个真实 Bug。用 AI 生成测试矩阵并补齐边界。让 AI 参与代码审查和重构评估。下一阶段仍然不追求“让 AI 自动完成所有工作”。我们更关注如何让 AI 在真实代码库中工作同时让开发者保持对上下文、改动和风险的控制。六、总结这一周最值得保存的 7 条 AI 编程原则是让 AI 参与开发但不要把判断交出去。项目上下文比角色设定更重要。需求不清时先让 AI 补全问题而不是瞎写代码。复杂任务先要方案再要代码。把 AI 输出当作草稿必须回到代码和测试中验证。工具应该服务于工作流而不是反过来改变工作目标。把一次有效协作沉淀成下一次可以复用的工程资产。如果只能记住一句话可以记住AI 编程的核心不是让 AI 写更多代码而是让每一次输出都经过上下文、约束和验证。下一篇文章我们用一个真实场景实践本周的方法用 AI 拆一个真实需求从模糊描述到开发任务清单。如果这篇文章对你有帮助欢迎点赞、收藏、关注专栏。也欢迎在评论区留言这 7 条原则中你最想先实践哪一条✍坚持原创求关注点赞收藏
