核心目标：学会把 AI 生成的原型图需求，改成可直接让 AI 生成代码的精准提示词，低返工、易上手

一、课前基础认知（必看）

1. 核心原则（记住 3 句话）

1. 手动修改 > 全 AI 修改：全靠 AI 改需求，后续返工成本极高，手动微调最省心

1. 提示词要动态描述：不说 “用户能管理内容”，要说 “用户能对内容做新建 / 编辑 / 删除”

1. 精简 TOKEN：删掉所有对 AI 无用的格式、重复内容，避免 AI 理解混乱

2. 整体流程（4 步走）

原型图需求 → 手动优化需求文档 → 补充技术 / API / 视觉信息 → 投喂 AI 生成代码

二、第一步：从原型图到产品需求（补齐核心信息）

上节课生成的原型图需求，只解决了「页面长什么样」，还缺产品功能逻辑，必须补齐以下 5 类信息：

1. 功能逻辑：用户每一步操作会发生什么

1. 数据结构：内容 / 碎片 / 笔记怎么存储、流转

1. 状态转换：提交→加载→完成→失败的触发条件

1. 约束条件：最多选 10 条碎片、文件大小限 10M

1. 错误处理：链接抓取失败、图片过大的提示文案

三、第二步：手动优化 AI 生成的需求文档（逐字改）

这是最关键步骤，照着改就能用，不用懂专业产品知识

1. 第一步：删无用信息（一键清理）

• 删掉纯人工阅读的加粗格式：AI 看不懂加粗，只会浪费 TOKEN

• 删掉重复描述：AI 写的同一段功能，前后重复的直接删

• 删掉AI 瞎加的无用功能：比如自动打标签、复杂温度参数（无实际价值）

• 删掉复杂数据模型：碎片 / 选题的详细模型，让 AI 自己生成，不用手动写

• 删掉冗余配置项：分类偏好、导出偏好等系统默认能实现的

2. 第二步：改功能描述（静态→动态）

❌ 错误（静态描述）：用户可以管理碎片
✅ 正确（动态操作）：用户可对自建碎片执行新建 / 编辑 / 归类 / 删除，删除后可归档，归档后可找回

通用模板：用户 + 可执行操作 + 操作后结果 + 找回 / 处理方式

3. 第三步：改页面逻辑（修正 AI 错误）

AI 会画错布局、写错交互，零基础按以下要点改：

1. 页面出口：导出 Markdown不跳转页面，保留在当前写作台

1. 页面布局：写作台从三栏改为两栏（1/4 素材栏 + 3/4 编辑区）

1. 操作按钮：写作台必须加生成撰写按钮，AI 漏写的补上

1. 默认选项：所有功能加默认值（如素材默认选「完整内容」）

1. 层级规范：设置页关闭叫「返回应用」，不叫「返回上一页」

4. 第四步：补状态信息（3 种状态必加）

所有页面必须写清：

• 空状态：无碎片时显示引导画面

• 加载状态：抓取链接时显示骨架屏、加载动画

• 错误状态：链接抓取失败、图片过大的 Toast 提示

四、第三步：给 AI 补充关键信息（让 AI 能写代码）

优化完需求，必须加 3 类信息，AI 才知道「用什么技术、怎么调用接口、长什么样」

1. 技术约束

• 存储：本地 Sqlite，无云端、无登录

• 文件：图片存本地，单文件≤10M

• 接口：遵循 OpenAI SDK 规范

2. 大模型 API（核心）

• 文本大模型：直接给调用示例代码，不用写完整文档

• 图像理解模型：支持本地图片上传 / Base64 码，未配置则仅保存图片不萃取

• 链接处理：抓取超时 30 秒，失败标记 failed 并提示

3. 视觉规范

不用写「简洁 / 高级」，直接给参考模板：

UI 视觉参考 Spacex 设计规范，简约科技风

五、第四步：最终检查清单（照着勾）

改完后逐行核对，缺一项就补，保证 AI 生成代码不跑偏：

1. ✅ 产品一句话概述（目标用户 + 核心价值）

1. ✅ 完整页面清单 + 页面跳转关系

1. ✅ 每个页面的布局、尺寸、组件

1. ✅ 关键交互流程（灵感捕捉 / 写作 / 选题）

1. ✅ 空 / 加载 / 错误 3 种状态

1. ✅ 业务规则（权限、数量、大小限制）

1. ✅ 技术栈、存储、接口规范

1. ✅ 大模型 + 图像理解 API 示例

1. ✅ 视觉参考规范

五、零基础避坑指南（绝对不要做）

1. ❌ 不要先画 AI 原型→再给 AI 开发：纯画蛇添足，增加无用上下文

1. ❌ 不要用模糊词：「优化视觉」「变好看」AI 无法理解

1. ❌ 不要超长上下文：对话超过 3 轮就新开，避免 AI 逻辑混乱

1. ❌ 不要全依赖 AI：必须手动改 1 次，返工率降低 80%

六、专属捷径

1. 新手模板：产品概述→页面清单→交互流程→API→视觉，按这个框架填

1. 少即是多：越精简的提示词，AI 生成的代码越准确

七、总结

AI 辅助开发的核心不是让 AI 替你做完所有事，而是你用手动修改，把需求讲清楚，再让 AI 精准执行。只要按「删无用→改描述→补信息→查清单」4 步走，就能写出能用的提示词，让 AI 直接生成代码。