学习目标
留下能指导编码的简短方案:已有能力、数据流、选择理由、风险与验证办法。
适用场景
资料夹已有账号系统与文章页面,这只是本例前提,不代表所有项目都如此。收藏要归属个人并支持刷新读取,不能只在按钮上改颜色。
准备条件
- 提供已确认规格、设计状态和适用项目指引;让具备代码读取能力的 AI 访问实际仓库。
- 无法读取仓库时先给结构和相关片段,结论中保留未知,不让 AI 编造函数、接口或部署环境。
操作步骤
先让 AI 解释现状,用文件作证
要求它从相关入口追到数据读取和写入,找出相邻实现及已有检查方式。核对几处关键文件,确认“已有收藏表”等判断真实存在。只读调查和实施分开表达,避免方案未定就改了一半。
画一条从操作到结果的数据流
说清界面发起什么、服务端验证什么、数据存在哪里、成功失败怎样回到页面。涉及个人数据时,身份与数据归属应由可信端核对,不能只靠界面隐藏。把验收编号对应到这条链路,暴露缺失的环节。
假设数据流草案 · 用真实项目核对或重写文章页保存动作 → 【待核对或设计的接口】接收请求并确认当前身份 → 按【待核对或设计的数据访问规则】保存“当前用户—文章”的关系 → 返回真实保存结果 → 页面更新状态;失败时保留重试 → 刷新后通过【待核对或设计的读取路径】获取该用户的收藏 对应:A1 持久读取;A2 数据归属;A3 真实失败反馈比较最少够用的方案
先比较复用现有能力和必要新增,不凭“以后可能很大”引入一串服务。例如本例有可用后端时,解释为什么复用它能满足 A1/A2;如果只能浏览器本地保存,应明确跨设备和账号隔离等要求是否还能满足。没有关键证据时先做能回答该问题的小实验。
交给 AI 的方案任务先只读本项目及已确认规格,不修改文件。 引用真实文件说明当前入口、数据流和可复用能力。 最多比较两个可行方案:各自满足哪些验收项、改动范围、数据/权限影响、迁移与验证办法。 指出证据不足或需要实验的判断;不要为了完整而虚构接口或新增服务。 最后给出最小实现切片,以及开始编码前必须解决的问题。记录选择及代价,让后续可追溯
用几段话记下为什么选这个方案、放弃了什么、什么变化会让它失效。不要求每次都写长文档;小修复在现有任务中记录即可。依赖、接口或数据变化要能说明升级和回退条件。
带着方案和验证入口交给编码
交接规格、设计、数据流、影响面及首个实现切片。若技术事实使原流程不可行,返回产品/设计确认修改;若只是实现未知,先调查或验证,不能静默删掉需求。
常见误区
- 把文件路径列表当成技术方案。
- 补全链路、边界、选择理由及验证入口,让人知道每处改动为何必要。
- 还没看仓库就推荐新数据库、框架和队列。
- 先核对已有能力,新增机制必须对应当前真实缺口。
验收清单
- 关键现状引用真实代码或实验,未确定项没有装作事实。
- 方案覆盖必要的数据、接口及权限边界。
- 选择及代价清楚,首个切片和验证入口可执行。
- 发现的需求/设计冲突已交回确认,未通过删需求绕开。
资料与版本
本文为原创方法整理,示例与提示词需按项目调整;不代表真实用户研究或账号执行结果。