把 AI 当成协作工程师,而不是一次性问答工具。

- 学习结果
- 掌握需求拆解、上下文提供、验收标准、代码审查和迭代式提示的工作流。
- 时长
- 60 分钟
- 难度
- 效率提升
- 核验
- 尚未进入本轮核验
正文
协作先建立可交付边界。把“改好网站”拆为一条用户路径,例如让读者按分类筛选项目并打开详情。说明现有行为、目标行为与不能改变的路由、数据和API;模型需要知道约束,才能避免把局部改动扩大成整个系统重写。
上下文应能追溯到当前源码。提供相关目录、已有组件、数据样例和复现步骤,不粘贴整个项目或带密钥的配置。先让模型阅读被影响位置,再讨论方案;旧截图、旧日志和过去的成功构建都不能证明当前版本正确。
任务拆分以可独立验收为准。一次改筛选交互,一次改接口,一次修布局,比一次同时重写页面、认证和数据库容易审查。有关联的文件要一起完成,不能为了任务小把行为链条截断;范围控制不是留下未接通的按钮或假数据。
权限和工具执行分层控制。阅读与计划不等于授权发布、真实付款或删除内容。工具有访问范围时按最小必要权限配置,运行来自网页或第三方文件的指令前先判断其来源。把外部材料当证据而不是让它覆盖自己的任务要求。
验收依靠运行证据。代码差异说明改了什么,测试检查逻辑,浏览器检查界面与交互,构建检查发布产物;它们互相补充而不互相替代。模型说“已修复”不是证据,应列出实际执行的检查、结果与未覆盖状态,失败要保留原始信息。
复盘更新协作材料而不是积累空话。若模型误改路由,下次补充路由约束;若测试缺少空数据,补上该样例。保留小而具体的工作说明与已验证行为,删除过时计划。最终决定仍由维护者根据用户目标和真实约束作出。



学习步骤
- 先交代背景、目标用户、当前代码结构和限制条件。
- 让 AI 先输出计划和风险,再进入实现。
- 每次只交付一个明确任务:页面、接口、测试、重构或文档。
- 给出验收标准:页面要有哪些状态、接口返回什么、测试如何通过。
- 让 AI 自检:边界情况、错误处理、性能、安全和可维护性。
场景拆解
与AI完成分类筛选改动
模拟内容站已有分类字段与详情路由。任务只改筛选行为,保留数据、原站链接和空结果状态;不发布、不引入登录,也不改写全部卡片。
- 提供筛选组件、数据样例、路由限制和三种验收输入。
- 审阅计划与差异,确认改动只覆盖筛选路径。
- 实际点击分类与空结果,记录构建或测试结果及未覆盖范围。
成功协作应交付完整筛选行为与可核对证据;模型对代码的解释可以辅助理解,但不能替代点击结果。任何发布或删除动作仍需单独授权。
补充材料
思维导图、练习、清单和参考资料可按需展开。
01 思维导图和离线文件
适合读完后下载到自己的知识库里继续整理。
AI 协作的完整工作流
- 背景:用户、业务与当前代码
- 任务:一个明确交付目标
- 边界:文件范围与限制
- 实现:可审查的改动
- 验收:测试与实际运行结果
上下文与验收资料
- 相关文件与数据结构
- 示例输入、输出与页面状态
- 不能改动的范围
- 测试命令、截图与审查结果
模型解释与验收证据
- 模糊需求会放大范围偏差
- 缺少上下文会产生错误假设
- 一次跨多个模块难以审查
- 解释不是构建、测试或运行证据

02 实践练习
根据文章内容记录自己的判断与依据。
与AI完成分类筛选改动
把分类筛选作为一个完整协作任务,明确代码与授权边界,审阅差异,再用真实交互和命令记录交付证据。
练习场景
模拟内容站已有分类字段与详情路由。任务只改筛选行为,保留数据、原站链接和空结果状态;不发布、不引入登录,也不改写全部卡片。
准备材料
- 准备当前组件、样例数据和项目命令。
- 剔除配置中的秘密与用户个人信息。
检查点
- 你是否能仅靠证据解释这次改动,而不依赖模型的自述?
练习步骤
01 / 限定任务
时间: 20-30 分钟
目标: 把用户目标变成明确行为
操作:
- 写当前与目标交互。
- 列出必须保留的路由和字段。
参考结果: 分类筛选不应改变详情slug。
预期产出: 有边界的任务说明。
检查: 说明覆盖完整用户路径而非单个视觉部件。
02 / 审阅实现
时间: 20-30 分钟
目标: 核对改动与授权范围
操作:
- 对照计划查看文件差异。
- 检查外部材料是否被当作执行指令。
参考结果: 读取文档不授权发布网站。
预期产出: 差异与范围记录。
检查: 没有未经授权的外部副作用。
03 / 交付证据
时间: 20-30 分钟
目标: 区分解释和检查
操作:
- 点击全部、单类和空分类。
- 记录实际命令输出和未覆盖项。
参考结果: 空结果显示原因与清除筛选入口。
预期产出: 检查记录与交接说明。
检查: 没有把未执行检查写成已通过。
完成检查
- 说明覆盖完整用户路径而非单个视觉部件。
- 没有未经授权的外部副作用。
- 没有把未执行检查写成已通过。
03 清单、模板和关键词
用于项目记录和自查。
项目记录
背景:____目标:____上下文:____限制:____验收标准:____示例输入输出:____测试命令:____
AI任务说明
背景:已有项目目录;目标:按分类筛选;范围:筛选组件与相关状态;保留:slug、来源、详情链接;输入样例:两类项目和空分类;验收:全部、单类、无结果;禁止动作:发布、删除、真实付款;检查命令:项目实际脚本。
协作交接单
改动文件:;行为差异:;保留契约:;实际运行检查与结果:;未执行检查:;边界样例:;风险:;人工审阅结论:。把“预计通过”与“实际通过”分开,不复制上一轮的成功记录。
关键概念
- 背景
- 目标
- 上下文
- 限制
- 验收标准
- 示例输入输出
- 测试命令
容易误判
- 只说“帮我做一个网站”
- 不给代码上下文
- 不检查输出
- 一次让 AI 改太多模块
- 把 AI 的解释当成验证
04 工具和参考资料
本篇涉及的工具和参考链接。
可参考工具
- Codex
- ChatGPT
- Claude
- Cursor
- GitHub Copilot