把背景、目标、范围、验收标准和风险交代清楚，AI 才能稳定产出。
- 学习结果
- 得到一份可交给 AI 或开发者执行的任务说明书。
- 时长
- 2-3 小时
- 难度
- 经验分享
- 核验
- 尚未进入本轮核验
正文
需求从用户要完成的任务开始。项目详情抽屉不是“做一个漂亮弹窗”，而是“读者不离开列表即可查看来源并打开官网”。先写当前阻碍、目标角色与完成结果，界面形态作为实现选项，而非替代业务目标。
上下文描述实际已有能力。列出页面、组件、数据字段和接口返回样例，说明哪些可以复用。若数据中没有评分，不应让模型为了填满界面编造评分；若来源待核验，应保留状态而不是自动加上当天日期。缺信息需要查证或明确展示未知。
范围包含做什么与不做什么。详情展示、关闭和官网链接属于任务；新增账号、改审核流程和抓取新数据不属于任务。约束必须准确，不能一面要求保留API一面让模型把接口改成另一种结构。相关契约的冲突应先解决再开始实现。
验收标准使用可观察行为。点击卡片打开正确项目，按Escape关闭，焦点回到触发卡片，手机上正文不溢出，缺图与空来源有明确状态。这些比“交互丝滑”更能指导实现；同时给出正常、异常与权限边界样例。
实现前区分事实与假设。可以先请AI列出需要读的文件、影响范围和不确定问题，再依据当前源码补齐。模型推测的库版本、字段或浏览器行为不能直接进入正式需求。示例数据只是说明格式，不应混入正式项目记录。
任务说明随决定更新。需求确定后形成一份简洁的执行记录，包括目标、文件范围、数据契约、状态和验收方法。改动目标时同步调整验收，而不是让实现者靠多轮聊天猜最终版本。例如详情从抽屉改为独立页，需要重新确认返回位置、路由与键盘行为，不能沿用旧容器的验收条件。
学习步骤
- 先写业务目标，不要直接写“做个页面”。
- 补充用户是谁、当前痛点、已有代码和不能改的范围。
- 明确页面状态、交互、数据字段和验收命令。
- 要求 AI 先列计划和风险。
- 每次只推进一个明确任务。
场景拆解
编写项目详情抽屉需求
模拟任务：目录已有项目title、description、sourceLinks和websiteUrl。读者希望查看资料后返回列表原位置，不能为抽屉新增虚构评分、账号或数据库。
- 列出用户打开、阅读、访问原站和关闭的路径。
- 写明正常、缺图、空来源、长正文与键盘状态。
- 核对字段和组件后提交任务，验收使用实际行为而非审美形容词。
说明书应让不同开发者实现相同核心结果。抽屉样式可以讨论，但焦点、滚动、缺失数据和保留路由是明确行为契约，不能留给模型自行猜测。
补充材料
思维导图、练习、清单和参考资料可按需展开。
01 思维导图和离线文件
适合读完后下载到自己的知识库里继续整理。
把想法拆成可开发任务
- 背景：谁遇到什么问题
- 目标：用户完成什么行为
- 范围：本次做与不做什么
- 验收：输入、输出与状态
- 风险：依赖、权限与失败情况
任务说明的必要上下文
- 业务目标与用户路径
- 相关文件与现有数据结构
- 具体示例与边界情况
- 可检查的交付结果
需求清晰度的判断
- 形容词不能代替行为标准
- 实现方案不能代替业务目标
- 缺少不做范围容易扩张任务
- 无法检查的验收条件仍需细化
02 实践练习
根据文章内容记录自己的判断与依据。
编写项目详情抽屉需求
为项目详情抽屉编写数据、交互与异常状态契约，覆盖键盘、焦点和长正文，使完成标准不依赖主观形容词。
练习场景
模拟任务：目录已有项目title、description、sourceLinks和websiteUrl。读者希望查看资料后返回列表原位置，不能为抽屉新增虚构评分、账号或数据库。
准备材料
- 读取实际字段和现有详情组件。
- 准备长正文、缺图和空来源样例。
检查点
- 这份需求有哪些内容是事实，哪些仍是你猜的？
练习步骤
01 / 写用户结果
时间： 20-30 分钟
目标： 避免用界面名替代业务任务
操作：
- 描述读者进入和离开详情的行为。
- 明确保持列表筛选与位置。
参考结果： 关闭详情后仍在原分类列表。
预期产出： 用户路径与目标。
检查： 目标不只是一句“做个弹窗”。
02 / 定义状态
时间： 20-30 分钟
目标： 让异常与键盘行为可验收
操作：
- 列正常、缺图和空来源状态。
- 写Escape与焦点恢复规则。
参考结果： 空来源显示待补，不自动造链接。
预期产出： 状态与数据样例。
检查： 所有字段都来自实际契约。
03 / 交付说明
时间： 20-30 分钟
目标： 消除冲突和模糊形容词
操作：
- 核对范围与现有API不冲突。
- 将审美描述改为可检查条件。
参考结果： 手机正文完整换行而非“视觉高级”。
预期产出： 完整Brief与验收单。
检查： 不同实现者可按同一条件判断完成。
完成检查
- 目标不只是一句“做个弹窗”。
- 所有字段都来自实际契约。
- 不同实现者可按同一条件判断完成。
03 清单、模板和关键词
用于项目记录和自查。
项目记录
背景：____目标用户：____范围：____验收标准：____相关文件：____测试命令：____不要改的地方：____
详情任务Brief
目标：列表内查看项目详情；字段：title、description、sourceLinks、websiteUrl；范围：详情容器与触发卡片；保留：列表筛选、路由、数据；状态：打开、关闭、缺图、空来源；禁止：虚构评分、新增账号；验收：键盘与手机均可完成。
行为验收表
触发动作：点击项目A；预期：展示A资料；Escape：关闭；焦点：回到触发卡片；背景：不误滚动；长正文：内部可读；官网：打开正确目标；空来源：明确待补；异常：不展示上一项目内容；测试记录：。
关键概念
- 背景
- 目标用户
- 范围
- 验收标准
- 相关文件
- 测试命令
- 不要改的地方
容易误判
- 编造缺失字段和评分
- 只定义正常界面不定义键盘状态
- 任务范围与API保留约束冲突