建立可靠的 AI 开发工作流
可靠的 AI 开发流程从清楚上下文开始，以小改动、真实运行和人工审查结束。AI 给候选方案，证据决定是否采用。
- 用同一份任务卡完成一次小功能修改，保留提示、差异、测试结果和最终判断。
- 读项目、写计划、分步实现和独立验证
- 复现建立可靠的 AI 开发工作流后，应当用同一份任务卡完成一次小功能修改，保留提示、差异、测试结果和最终判断，并保留用户任务观察、改动差异、冒烟测试和版本复盘作为可重复检查的依据。
- 完成 8.1「从真实问题定义产品」
FOUNDATION
必须理解
稳定的 AI 开发流程依赖充分上下文、小任务、版本保护和独立验证。Prompt 只是其中一个输入，确实质量来自你如何定义问题和收集证据。
本课依次讲清读项目、写计划、分步实现和独立验证、假设、决策记录和失败恢复和代码审查、测试和人工责任，最后通过“让 AI 做审查，再由你处理高风险项并写决策记录”检查学习结果。
AI 像速度极快的新同事：给清楚任务和材料时能高效完成；让它猜公司背景并直接操作生产系统，速度会放大风险。
为任务应用增加截止日期时，先读现有模型与页面，写契约和迁移计划，再分别实现数据库、API、UI，逐步测试并审查差异。
读项目、写计划、分步实现和独立验证
给 AI 的上下文包括你想做什么、项目现在怎样、有哪些限制、相关文件在哪，以及最后怎么验收。信息越准，它越不用猜；把整个项目毫无重点地塞进去也未必更好。
基础概念
可靠 AI 开发从读取现状开始，再形成可审查计划，把工作拆成小改动，并用独立证据验证。上下文提供目标、相关代码、限制和验收，不是无选择地倾倒所有文件。
进一步理解
先让 AI 复述现有数据流和不应改变的行为；计划明确改哪里、为何改、怎样测；一次实现一个可验证切片。
上下文太少会迫使猜测，太多无关内容会淹没重点。优先提供入口、类型、错误、测试和与任务直接相关的文件。
增加任务筛选前，先让 AI 读列表状态与 URL 逻辑，计划只改筛选相关文件，每一步运行现有和新增用例。
长 Prompt 不自动等于好上下文。关键是信息可验证、与决策相关，并清楚区分事实与期望。
这一小节记住：让 AI 先理解边界，再小步修改，每一步都留下可检查结果。
假设、决策记录和失败恢复
计划、实现、验证、审查可以把大任务拆成几个能停下来的小闭环。哪一步出了问题，就回到最近稳定位置，不必在错误代码上继续堆修改。
基础概念
假设是尚未验证的判断，决策记录保存选择、依据与放弃方案，失败恢复依靠版本历史和最近稳定检查点。
进一步理解
AI 应明确说出它假设的版本、数据形状和运行环境。高影响假设先通过读取或小实验验证，不能藏在实现里。
一次改动失败时回到已知状态，比较差异并缩小范围。继续在未知代码上追加提示会让因果链越来越长。
AI 假设接口返回数组，先用真实响应核对；决定保守更新后记录理由，失败时撤回单次提交而不覆盖其他用户修改。
记录决策不是把聊天全文保存。确实有用的是问题、选择、证据、后果和未来重新评估条件。
这一小节记住：显式假设减少暗中猜测，稳定检查点让失败能够安全恢复。
代码审查、测试和人工责任
AI 给的是候选答案，不是已经发生的事实。差异要你看，测试要你跑，安全和产品取舍最后也得由你负责。
基础概念
代码审查检查改动是否正确且符合意图，测试执行可重复行为，人工责任包括产品取舍、安全判断和最终发布决定。
进一步理解
AI 可以生成 diff 与测试，但同一个模型可能重复自己的错误。验证应尽量独立：编译器、测试、真实请求和人工阅读提供不同证据。
审查关注变更范围、错误路径、权限、数据和回归，不因代码风格流畅就默认正确。高风险操作需要更强证据与人工批准。
AI 写完权限过滤后，人工阅读查询条件，再以另一用户真实请求并运行集成测试，三者共同证明越权被阻止。
测试通过只覆盖已经写出的用例，审查通过也不证明生产环境安全；证据要与风险匹配并组合使用。
这一小节记住：AI 提供高速候选，人用独立证据决定它是否可以成为产品事实。
AI COLLABORATION
AI 如何参与
在建立可靠的 AI 开发工作流这一课，AI 负责根据真实材料解释读项目、写计划、分步实现和独立验证并指出遗漏，学习者负责控制范围、执行修改和核对用户任务观察、改动差异、冒烟测试和版本复盘。
推荐协作顺序
- 1
先给 AI 目标、现状、约束和验收，只让它写计划。
- 2
按计划一次授权一个小步骤，完成后查看差异。
- 3
用测试和真实页面验收，再开启一个独立审查找遗漏。
目标是为任务应用增加截止日期筛选。下面提供 Brief、相关文件、当前测试和约束。先复述理解并列修改计划，未经确认不改文件。只处理指定范围，不读取秘密，不使用破坏性命令。完成后输出 diff 摘要、运行命令、实际结果和人工检查清单。
计划能把数据、接口、界面和迁移分成可独立验证的小步，并显式列出未知假设；建立可靠的 AI 开发工作流的人工验收必须回到真实页面、请求、终端、测试或数据结果，不能用 AI 的文字说明代替。
人工检查清单
- 确认 AI 实际读取了给定代码，范围与需求一致，测试覆盖旧数据和空截止日期。
- 要求 AI 在动手前列出已确认事实、未验证假设、修改范围和验收证据。
- 用测试、构建、真实操作和人工 diff 至少两类独立方法验证，不能让 AI 自己宣布完成。
COMMON TRAPS
常见误区
下面三类问题会让任务看似完成，却经不起刷新、错误输入或真实环境检查。先看现象，再找原因和修正方法。
一句话让 AI 改完整项目
- 你会看到
- 范围漂移且难以审查
- 为什么发生
- 范围、约束和验收都不明确，模型只能自行补全大量假设。
- 怎样纠正
- 写任务卡并分成小步
只看最终页面
- 你会看到
- 隐藏的依赖和错误处理被忽略
- 为什么发生
- 界面正常可能掩盖无关改动、错误处理缺失和依赖变化。
- 怎样纠正
- 审查 diff、测试和日志
把秘密作为上下文
- 你会看到
- 凭据进入对话或输出
- 为什么发生
- 对话内容和生成结果可能被复制或保存，凭证不该成为调试材料。
- 怎样纠正
- 只提供脱敏材料与变量名
HANDS-ON
动手任务
用同一份任务卡完成一次小功能修改，保留提示、差异、测试结果和最终判断。
- 完成 8.1「从真实问题定义产品」
跟着做
- 01
选择一个小功能并写目标、非目标与验收。
- 02
收集相关文件、版本和当前测试。
- 03
让 AI 给计划与假设，不立即实现。
- 04
按步骤逐项实现，每次查看差异并运行验证。
- 05
让 AI 做审查，再由你处理高风险项并写决策记录。
用同一份任务卡完成一次小功能修改，保留提示、差异、测试结果和最终判断。
对同一改动开启一个全新对话做独立审查，比较两个 AI 结论并解释你的最终判断。
离开本课前，自问四件事
- 一次高质量上下文应包含哪些事实、限制和验收？
- 为什么要把计划、实现、验证和审查分成可停下的小阶段？
- 怎样记录一个确实有价值的假设与决策？
- 我会用哪些独立证据检查 AI 的改动，而不是让它自证？
确认完成后，会同步更新学习中心的课程学习进度。