Vibe Guide形成需求与用户故事
需求文档记录填什么、做什么、应该得到什么结果。
为什么要有这一节点？
把已经说好的功能写下来，开发时就能照着检查。
开始操作共 2 个步骤 · 按顺序完成
0102把约定留成看得懂的说明待核对展开这一步收起这一步
01开始前准备什么，做完后留下什么？
已经确认的第一版功能清单。
下一步可以依据这份文件写使用过程。
这一步要让 AI 读取和保存哪些文件？
在所选工具的项目对话中，让它先打开下面的文件。找不到时，点击下方链接回到创建文件的步骤。
先让 AI 读取这些材料：idea.md · docs/requirements.md
让 AI 将结果保存到：docs/requirements.md
02这一步要帮你解决什么问题？
把已经说好的功能写下来，开发时就能照着检查。
弄懂原理，再试着自己判断
这个概念是什么意思？
需求文档记录填什么、做什么、应该得到什么结果。
换个情况，你会怎样判断？
如果只写“好用”，别人知道要做哪些操作、看到什么结果才算通过吗？
查看参考答案
不能。“好用”没有统一观察方法；应改成具体操作和结果，例如重复报名不重复占位。
试着用自己的话回答；拿不准时先对照上面的解释，再用自己的项目举例核对。
03这一步具体怎么做？
展开收起
项目中的 docs/requirements.md
每次只发送当前这一项的提示词：选中框内文字复制（Mac 按 ⌘C，Windows 按 Ctrl+C），切到所选工具的项目对话，粘贴后把【】替换成自己的内容，再点发送。等工具回复并核对“完成后应该看到”的结果，再做下一项。
把每项功能写成“填什么、点什么、看到什么”。展开收起
建议提示词：
请读 docs/requirements.md，把每个必做功能写清输入内容、操作、正常结果和失败时的提示。给每项编号，先让我确认。
完成后应该看到：每个功能都有实际操作和能看到的结果。
对照自己的想法检查，再保存确认后的版本。展开收起
建议提示词：
请把我确认的内容更新到 docs/requirements.md，保留每项怎样测试才算做好，不增加未提出的功能。
完成后应该看到：下一步可以依据这份文件写使用过程。
跟练：个人学习记录（前端 + 后端 + 数据库）
选择这个示例时，沿用同一个 learning-journal 项目逐步完成。已有自己的项目时，对照检查相关要求即可，不必另建项目。
逐项核对标题 1–80 字、内容 1–2000 字；前后空格不算有效内容。保存成功后才清空输入。
- 做完这一步，应该看到什么？
- 服务不可用时原输入保留；后端独立拒绝空白和超长内容。
- 做不下去时，先怎么办？
- 若只写“按钮可点”，追问存错、断开和空白分别显示什么，不让学员猜。
04不会具体操作？逐项跟着做
展开收起
把每项功能写成“填什么、点什么、看到什么”。
- 操作后应该看到什么？
- 每个功能都有实际操作和能看到的结果。
- 没有看到这个结果时，怎么办？
- 出现“体验良好”等空泛词时，要求换成具体画面或行为。
对照自己的想法检查，再保存确认后的版本。
- 操作后应该看到什么？
- 下一步可以依据这份文件写使用过程。
- 没有看到这个结果时，怎么办？
- 如果某项自己也看不懂，先要求解释，不直接确认。
06遇到问题时，应该怎么处理？
展开收起
说明太长，不知道该确认哪句
- 先检查哪里，确认问题的原因？
- 找到与第一条使用流程有关的段落。
- 按下面的方法处理问题
- 让 AI 先列出三到五条必须本人决定的事项，逐条给生活化例子。其余资料留在文件里按需查。
- 恢复后应该看到
- 能亲自确认范围和结果，未确认项明确保留。
先在模板中补充实际材料，确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”，示例可以自行替换。
已确认 · 以下是本次专属内容，可一键复制
我停在“把约定留成看得懂的说明”。预期结果：每个主要操作都有预期结果和异常回应。。实际画面/报错：[在这里补充]。请先根据已有文件检查原因，一次只给一个可逆的处理动作，说明在哪里操作、恢复后应看到什么。不要重建项目，不要删除已有成果。07本步材料（填写或复制）
展开收起
上面已经逐项发送并完成的，不必再发下面整段模板。需要整理本步材料时再使用；替换【】后确认，再复制到项目对话。
先在模板中补充实际材料，确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”，示例可以自行替换。
已确认 · 以下是本次专属内容，可一键复制
先检查能否读取idea.md、docs/requirements.md。缺失或无访问能力时，明确缺项与需本人操作的入口，停止本步执行，不编造文件或前序结论。
读取 idea.md 和 docs/requirements.md 的已确认范围。只完善需求文档：每个功能的输入、操作、结果、适用的异常情况和通过条件。保留未知项，不擅自加入保存、登录或云服务。保存并读回 docs/requirements.md，报告本次修改和待确认项。本次不写用户故事、技术方案或代码。跟练个人学习记录：本步怎么填写／补充提示词
仅当你选择本页全栈跟练时使用：使用下面已合并本步要求的提示词，填好空白后复制发送；不必重复发送上方通用模板。它不授权跳到后续步骤。
先在模板中补充实际材料，确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”，示例可以自行替换。
已确认 · 以下是本次专属内容，可一键复制
先检查能否读取idea.md、docs/requirements.md。缺失或无访问能力时，明确缺项与需本人操作的入口，停止本步执行，不编造文件或前序结论。
读取 idea.md 和 docs/requirements.md 的已确认范围。只完善需求文档：每个功能的输入、操作、结果、适用的异常情况和通过条件。保留未知项，不擅自加入保存、登录或云服务。保存并读回 docs/requirements.md，报告本次修改和待确认项。本次不写用户故事、技术方案或代码。
本次已选择个人学习记录全栈跟练。
补充已确认 R1–R3 的具体输入限制、提交中禁用按钮、失败保留输入、成功重新读取列表。只写需求，不开发。08看到这个结果才算完成
每个主要操作都有预期结果和异常回应。
09没有看到预期结果，接下来怎么办？
展开收起
出现“体验良好”等空泛词时，要求换成具体画面或行为。
看结果对照（教学示意，不是你的项目结果）
不合格：报名好用。合格：R01容量20，报名成功余量减1；同一人重复请求不重复占位；已满显示无法报名。
0202把用户怎样使用写清楚待核对展开这一步收起这一步
01开始前准备什么，做完后留下什么？
项目中已经保存的需求文档。
使用过程前后接得上，文件能打开。
这一步要让 AI 读取和保存哪些文件？
在所选工具的项目对话中，让它先打开下面的文件。找不到时，点击下方链接回到创建文件的步骤。
先让 AI 读取这些材料：idea.md · docs/requirements.md
让 AI 将结果保存到：docs/stories.md
02这一步要帮你解决什么问题？
把用户从打开作品到完成任务的过程写清楚，容易发现漏掉的步骤。
弄懂原理，再试着自己判断
这个概念是什么意思？
用户故事说的是谁要完成什么；操作过程说明他先做什么、再做什么。
换个情况，你会怎样判断？
“支持保存”和“保存后重新打开仍能找到原文”，哪一句更容易亲手检查？
查看参考答案
后一句更容易检查，因为给出了保存后的操作和可观察结果。还应注明同一设备还是跨设备，避免误解。
试着用自己的话回答；拿不准时先对照上面的解释，再用自己的项目举例核对。
03这一步具体怎么做？
展开收起
项目对话与 docs/requirements.md
每次只发送当前这一项的提示词：选中框内文字复制（Mac 按 ⌘C，Windows 按 Ctrl+C），切到所选工具的项目对话，粘贴后把【】替换成自己的内容，再点发送。等工具回复并核对“完成后应该看到”的结果，再做下一项。
让工具把使用过程像讲故事一样写出来：谁打开哪里，先做什么，接着做什么。展开收起
建议提示词：
请读 idea.md 和 docs/requirements.md，写出每种用户从打开项目到完成任务的一次完整过程。一步写一个动作，也写出出错后怎样继续。先不要开发。
完成后应该看到：能按文字想象一个人实际使用的顺序。
按自己会使用的方式读一遍，指出缺少的步骤，再保存。展开收起
建议提示词：
请把我确认的使用过程保存到 docs/stories.md，并保留对应的需求编号。
完成后应该看到：使用过程前后接得上，文件能打开。
跟练：个人学习记录（前端 + 后端 + 数据库）
选择这个示例时，沿用同一个 learning-journal 项目逐步完成。已有自己的项目时，对照检查相关要求即可，不必另建项目。
用一句完整场景串起来：晚上打开网页，写今天学到的事，保存，第二天再次打开查到。
- 做完这一步，应该看到什么？
- docs/stories.md 同时覆盖正常保存与保存失败后重试。
- 做不下去时，先怎么办？
- 不要把“数据库插入成功”当用户操作；学员实际要点击和查看的是网页。
04不会具体操作？逐项跟着做
展开收起
让工具把使用过程像讲故事一样写出来：谁打开哪里，先做什么，接着做什么。
- 操作后应该看到什么？
- 能按文字想象一个人实际使用的顺序。
- 没有看到这个结果时，怎么办？
- 突然出现尚未说明的账号或页面时，先补它的来源和进入方法。
按自己会使用的方式读一遍，指出缺少的步骤，再保存。
- 操作后应该看到什么？
- 使用过程前后接得上，文件能打开。
- 没有看到这个结果时，怎么办？
- 例如写了“付款成功”却没说在哪里付款，就先补上操作。
06遇到问题时，应该怎么处理？
展开收起
AI 只列功能名，没有使用过程
- 先检查哪里，确认问题的原因？
- 找出一个故事是否包含开始条件、操作和结果。
- 按下面的方法处理问题
- 回复：“请把第一个功能改写成一个人的实际操作过程，写出正常和失败时分别看到什么；不增加新功能。”
- 恢复后应该看到
- 重新执行原操作，得到本页要求的实际结果；未执行的检查仍标为未验证。
先在模板中补充实际材料，确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”，示例可以自行替换。
已确认 · 以下是本次专属内容，可一键复制
我停在“把用户怎样使用写清楚”。预期结果：每个第一版功能都能对应到一个用户操作和通过条件。。实际画面/报错：[在这里补充]。请先根据已有文件检查原因，一次只给一个可逆的处理动作，说明在哪里操作、恢复后应看到什么。不要重建项目，不要删除已有成果。07本步材料（填写或复制）
展开收起
上面已经逐项发送并完成的，不必再发下面整段模板。需要整理本步材料时再使用；替换【】后确认，再复制到项目对话。
先在模板中补充实际材料，确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”，示例可以自行替换。
已确认 · 以下是本次专属内容，可一键复制
先检查能否读取idea.md、docs/requirements.md。缺失或无访问能力时，明确缺项与需本人操作的入口，停止本步执行，不编造文件或前序结论。
读取 idea.md 和 docs/requirements.md。只整理已确认范围：按“什么用户，在什么情况下，希望完成什么，为什么”写用户故事；每个故事写开始条件、操作、正常结果、失败提示和通过条件。把用户故事保存为独立文档 docs/stories.md（不要并入 docs/requirements.md）。未知项标待确认，不增加功能。保存后读回并报告文件位置。本次不写业务代码。跟练个人学习记录：本步怎么填写／补充提示词
仅当你选择本页全栈跟练时使用：使用下面已合并本步要求的提示词，填好空白后复制发送；不必重复发送上方通用模板。它不授权跳到后续步骤。
先在模板中补充实际材料，确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”，示例可以自行替换。
已确认 · 以下是本次专属内容，可一键复制
先检查能否读取idea.md、docs/requirements.md。缺失或无访问能力时，明确缺项与需本人操作的入口，停止本步执行，不编造文件或前序结论。
读取 idea.md 和 docs/requirements.md。只整理已确认范围：按“什么用户，在什么情况下，希望完成什么，为什么”写用户故事；每个故事写开始条件、操作、正常结果、失败提示和通过条件。把用户故事保存为独立文档 docs/stories.md（不要并入 docs/requirements.md）。未知项标待确认，不增加功能。保存后读回并报告文件位置。本次不写业务代码。
本次已选择个人学习记录全栈跟练。
在 docs/stories.md 写新增、读回、空白拒绝和服务停止后重试场景，对应 R1–R3。08看到这个结果才算完成
每个第一版功能都能对应到一个用户操作和通过条件。
09没有看到预期结果，接下来怎么办？
展开收起
突然出现尚未说明的账号或页面时，先补它的来源和进入方法。
看结果对照（教学示意，不是你的项目结果）
S01关联R01：成员打开活动→看到余位→提交→收到确认；已满时停在活动页并解释原因。
本节点出现的词按出现顺序排列，点开可查完整解释
更多问题与排障资料
遇到卡点，从现象开始查
2 种情况以下路径整理自官方文档与公开求助，不代表发生频率。先按现象检查，再核对处理结果。
“好看、好用”无法验收
看到的现象：AI 和本人对完成的理解完全不同。
- 先检查哪些地方？
为每个功能写触发动作、输入和应出现的结果。
- 接着处理
把抽象要求改成可操作检查；比如“必填项空着提交时显示字段错误，并保留已填内容”。例子须替换成实际业务。
- 这样才算解决
另一人只读需求就能照步骤判断通过或失败。
先在模板中补充实际材料，确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”，示例可以自行替换。
已确认 · 以下是本次专属内容，可一键复制
我在【“好看、好用”无法验收】这一步遇到问题。
项目与工具：[填写名称、版本和项目路径]
实际现象：[填写操作步骤、报错原文或附截图；隐去密钥和个人数据]
期望结果：[填写实际目标]
请先检查：为每个功能写触发动作、输入和应出现的结果。
处理方向：把抽象要求改成可操作检查；比如“必填项空着提交时显示字段错误，并保留已填内容”。例子须替换成实际业务。
请先说明证据和原因，再执行最小范围修复；保留已有改动，不扩展功能。需要我操作时，一次给出一个位置明确的动作，并说明应当看到什么。
验证标准：另一人只读需求就能照步骤判断通过或失败。
最后列出实际验证结果、未验证项和下一步。只写成功情况，异常时卡死
看到的现象：没数据、断网、重复提交都没有约定。
- 先检查哪些地方？
逐项询问空内容、非法输入、等待、失败、重复操作时应如何显示。
- 接着处理
给每项功能补一个正常和一个异常场景；说明错误后是否保留输入、重试或返回。
- 这样才算解决
需求包含成功与失败出口，不依赖 AI 临场猜测。
先在模板中补充实际材料，确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”，示例可以自行替换。
已确认 · 以下是本次专属内容，可一键复制
我在【只写成功情况，异常时卡死】这一步遇到问题。
项目与工具：[填写名称、版本和项目路径]
实际现象：[填写操作步骤、报错原文或附截图；隐去密钥和个人数据]
期望结果：[填写实际目标]
请先检查：逐项询问空内容、非法输入、等待、失败、重复操作时应如何显示。
处理方向：给每项功能补一个正常和一个异常场景；说明错误后是否保留输入、重试或返回。
请先说明证据和原因，再执行最小范围修复；保留已有改动，不扩展功能。需要我操作时，一次给出一个位置明确的动作，并说明应当看到什么。
验证标准：需求包含成功与失败出口，不依赖 AI 临场猜测。
最后列出实际验证结果、未验证项和下一步。我的项目材料与备份
材料只存于这台设备的当前浏览器；不是项目文件，也不会自动发给 AI。中英文模板分别保存，项目选择和学习进度共用。不要在这里填写密码或 API Key。
包括想法、进度、各步模板、人工核对记录及选型条件；不包含你的真实项目代码。恢复会建立一个新草稿，不覆盖已有项目。
下载或导入不工作？复制备份文本恢复
草稿与进度只保存在当前浏览器。
按顺序完成本页操作，遇到问题时展开对应的检查和处理方法。