Vibe GuideBETA

亲自测试完整使用过程

验收就是你按照先前约定的方法试用,再决定是否达到了目标。

做完这一节点,你会得到什么?
docs/acceptance.md 中保存了本人实际操作和结论。
为什么要有这一节点?

回到最初的想法,亲自看看作品有没有解决自己的问题。

开始操作共 3 个步骤 · 按顺序完成

0103试试空白和连续点击待核对展开这一步收起这一步
正常填写
空白尝试
检查页面怎样提示空白或错误输入
操作示意 · 非工具截图

01开始前准备什么,做完后留下什么?

开始前需要准备什么?

已经正常走完的使用过程,以及只用于测试的内容。

做完后要留下什么?

失败和未测项没有被改成通过。

这一步要让 AI 读取和保存哪些文件?

在所选工具的项目对话中,让它先打开下面的文件。找不到时,点击下方链接回到创建文件的步骤。

先让 AI 读取这些材料:docs/requirements.md · docs/checks.md

让 AI 将结果保存到:docs/checks.md

缺少这些材料?回到创建它们的步骤 →

02这一步要帮你解决什么问题?

试试填错、重复点击或服务停止时,作品能不能清楚提示并保留资料。

弄懂原理,再试着自己判断

这个概念是什么意思?

异常测试就是故意试一试不顺利的情况,看看作品会怎样处理。

换个情况,你会怎样判断?

除了正常输入,最可能发生哪种误操作?

查看参考答案

按本项目行为选择,如重复点击、空输入、取消、断网或无权限,并写预期处理;不是给所有项目增加相同功能。

试着用自己的话回答;拿不准时先对照上面的解释,再用自己的项目举例核对。

03这一步具体怎么做?

展开收起

只含测试资料的项目页面

每次只发送当前这一项的提示词:选中框内文字复制(Mac 按 ⌘C,Windows 按 Ctrl+C),切到所选工具的项目对话,粘贴后把【】替换成自己的内容,再点发送。等工具回复并核对“完成后应该看到”的结果,再做下一项。

  1. 先测试错误输入。在作品里不填必填项就点提交,再试过长内容。展开收起

    完成后应该看到:页面解释哪里不对,也没有保存无效记录。

  2. 检查重复点击和服务中断时会发生什么。先让工具给出只影响本项目测试环境的办法。展开收起

    建议提示词:

    请列出本项目测试重复点击和服务暂时停止的操作。一次只测一项,说明怎样停止本项目服务和恢复。不要停止其他项目。只测试,先不修代码。

    完成后应该看到:有明确的测试和恢复方法。

  3. 按说明试一次服务停止后的保存,再恢复服务。展开收起

    完成后应该看到:没有假成功,未提交内容保留;恢复后先查列表再决定是否重试。

  4. 把结果给工具记下来。展开收起

    建议提示词:

    请把刚才各项异常测试的预期、实际和未测试原因写入 docs/checks.md。失败保持失败,留给反馈与修复步骤处理。

    完成后应该看到:失败和未测项没有被改成通过。

跟练:个人学习记录(前端 + 后端 + 数据库)

选择这个示例时,沿用同一个 learning-journal 项目逐步完成。已有自己的项目时,对照检查相关要求即可,不必另建项目。

分别试空白、全空格、超长、连续点击;再由 Codex 停止本练习服务后试保存,确认原文还在。

做完这一步,应该看到什么?
无效内容不入库;服务停了不能提示成功;连点同一次提交只新增一条。
做不下去时,先怎么办?
自动检查通过但画面不对仍记失败;不要关闭所有 Python 进程,只停止本项目进程。
参考项目实测截图:服务停止后输入保留,页面没有显示保存成功。
参考项目的实际运行截图。用于对照现象,不是你的项目验收结果。点击可放大。

04不会具体操作?逐项跟着做

展开收起
  1. 先测试错误输入。在作品里不填必填项就点提交,再试过长内容。

    操作后应该看到什么?
    页面解释哪里不对,也没有保存无效记录。
    没有看到这个结果时,怎么办?
    只有页面拦截还不够,让工具检查后端是否同样拒绝。
  2. 检查重复点击和服务中断时会发生什么。先让工具给出只影响本项目测试环境的办法。

    操作后应该看到什么?
    有明确的测试和恢复方法。
    没有看到这个结果时,怎么办?
    不知道进程属于谁时先不停止,要求工具确认项目和端口。
  3. 按说明试一次服务停止后的保存,再恢复服务。

    操作后应该看到什么?
    没有假成功,未提交内容保留;恢复后先查列表再决定是否重试。
    没有看到这个结果时,怎么办?
    已保存但返回失败时不要重复提交,先请工具按内容和编号核对。
  4. 把结果给工具记下来。

    操作后应该看到什么?
    失败和未测项没有被改成通过。
    没有看到这个结果时,怎么办?
    没有相应功能就注明不适用及原因,不为测试临时增加功能。

05这一步出现的词

展开收起

回归测试 ↗

修改后检查已有能力是否被破坏。

修完厨房灯,再看其他灯是否仍正常。

并发 ↗

多个任务在重叠时间段内推进。

厨师交替照看多口锅。

06遇到问题时,应该怎么处理?

展开收起

出现空记录或重复记录

先检查哪里,确认问题的原因?
记下点击次数和生成的记录数,不急着删除证据。
按下面的方法处理问题
只收集当前现象、操作、版本与报错原文,必要时只读排查;本步不修代码。失败记录到反馈,按“先确定怎么修、怎样算修好”确认计划后再修复。
恢复后应该看到
有可核对的实际记录,未执行仍标未测试,失败仍标失败。

问题不在列表里?请 AI 排查

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

07本步材料(填写或复制)

展开收起

上面已经逐项发送并完成的,不必再发下面整段模板。需要整理本步材料时再使用;替换【】后确认,再复制到项目对话。

这一步的提示词模板

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

跟练个人学习记录:本步怎么填写/补充提示词

仅当你选择本页全栈跟练时使用:使用下面已合并本步要求的提示词,填好空白后复制发送;不必重复发送上方通用模板。它不授权跳到后续步骤。

全栈跟练:本步提示词

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

08看到这个结果才算完成

适用的异常检查有真实记录,失败和未执行项保持原状态。

09没有看到预期结果,接下来怎么办?

展开收起

只有页面拦截还不够,让工具检查后端是否同样拒绝。

看结果对照(教学示意,不是你的项目结果)
重复报名:通过;断网:失败;iPhone真机:未测试。不能把这份报告写成“全部通过”。
记录本次核对结论与版本

这是本人的记录,不是网站自动检测。改动项目后旧结论不能证明新版本通过;未测试或失败时先补测/反馈。

0203关掉以后,还能重新打开待核对展开这一步收起这一步
按说明停止
重新启动
检查原有内容是否还能找到
操作示意 · 非工具截图

01开始前准备什么,做完后留下什么?

开始前需要准备什么?

项目的启动说明,以及一条已保存的测试记录。

做完后要留下什么?

重开后能继续使用,记录按需求保留。

这一步要让 AI 读取和保存哪些文件?

在所选工具的项目对话中,让它先打开下面的文件。找不到时,点击下方链接回到创建文件的步骤。

先让 AI 读取这些材料:README.md

让 AI 将结果保存到:docs/checks.md

缺少这些材料?回到创建它们的步骤 →

02这一步要帮你解决什么问题?

确认今天关掉以后,明天照着说明还能打开并继续用。

弄懂原理,再试着自己判断

这个概念是什么意思?

浏览器页面与后端服务不是同一个东西;关浏览器后服务可能还在运行。

换个情况,你会怎样判断?

明天看不到这段聊天时,你还能按项目里的说明重新打开它吗?

查看参考答案

应能只靠README找到项目、运行命令或安装入口及结果;否则先补真实启动说明,再验证一次。

试着用自己的话回答;拿不准时先对照上面的解释,再用自己的项目举例核对。

03这一步具体怎么做?

展开收起

README.md 的启动说明和原项目

每次只发送当前这一项的提示词:选中框内文字复制(Mac 按 ⌘C,Windows 按 Ctrl+C),切到所选工具的项目对话,粘贴后把【】替换成自己的内容,再点发送。等工具回复并核对“完成后应该看到”的结果,再做下一项。

  1. 先记下一条已保存记录,再找到 README.md 里的停止和启动方法。展开收起

    完成后应该看到:知道待会儿要找回哪条记录。

  2. 停止并重新启动本项目。仅关掉浏览器还不算停止后端。展开收起

    建议提示词:

    请按 README.md 停止并重新启动本项目服务,保留数据库。告诉我实际打开哪个网址;不要新建项目或重置数据。

    完成后应该看到:服务重新运行,能打开作品。

  3. 打开新启动的网址,找刚才那条记录,再做一次主要操作。展开收起

    建议提示词:

    我的重开结果是:【填写】。请把实际启动方法和结果更新到 README.md 与 docs/checks.md。

    完成后应该看到:重开后能继续使用,记录按需求保留。

跟练:个人学习记录(前端 + 后端 + 数据库)

选择这个示例时,沿用同一个 learning-journal 项目逐步完成。已有自己的项目时,对照检查相关要求即可,不必另建项目。

记下练习记录编号,按 README 停止服务,再从原文件夹重启并打开网址。

做完这一步,应该看到什么?
同一编号仍可读取;重启没有重新创建空库。
做不下去时,先怎么办?
记录消失先核对数据库绝对路径是否变了,保留原文件;不要重新初始化清空。
对照具体报错,找到下一步

重启后列表突然为空

先检查哪些地方?
让 Codex 对比重启前后的数据库绝对路径和数量,先别新增记录。
按下面的方法处理问题
如果打开了另一份空库,保留两份文件并修正固定路径;只读确认旧记录,再启动。
问题解决后,应该看到什么?
原来的编号和内容重新出现。

浏览器提示 ERR_UNSAFE_PORT

先检查哪些地方?
服务可能在运行,但所选端口被浏览器禁止访问;这不等于数据库坏了。
按下面的方法处理问题
保留报错与网址,请工具为本项目选择浏览器允许且空闲的端口,再按新启动输出打开;不要关闭浏览器安全保护。
问题解决后,应该看到什么?
新地址可访问,仍连接原来的数据库和记录。

04不会具体操作?逐项跟着做

展开收起
  1. 先记下一条已保存记录,再找到 README.md 里的停止和启动方法。

    操作后应该看到什么?
    知道待会儿要找回哪条记录。
    没有看到这个结果时,怎么办?
    方法没写清时,请工具补具体目录、命令和网址。
  2. 停止并重新启动本项目。仅关掉浏览器还不算停止后端。

    操作后应该看到什么?
    服务重新运行,能打开作品。
    没有看到这个结果时,怎么办?
    端口占用先查归属;浏览器禁止某端口时换允许的空闲端口,不关闭安全保护。
  3. 打开新启动的网址,找刚才那条记录,再做一次主要操作。

    操作后应该看到什么?
    重开后能继续使用,记录按需求保留。
    没有看到这个结果时,怎么办?
    丢记录时先核对项目路径和数据库位置,不清库重来。

05这一步出现的词

展开收起

统一资源定位符 ↗

描述网络资源位置及访问方式的地址。

完整地址可能包括楼名、房号与查询条件。

数据库 ↗

按规则保存、查找和更新数据的系统。

能按条件查找的账房。

06遇到问题时,应该怎么处理?

展开收起

第二天地址打不开

先检查哪里,确认问题的原因?
昨天的预览服务是否已经停止?
按下面的方法处理问题
打开原项目,让 AI 按 README 重新启动并报告实际地址。不要新建替代项目;原数据位置保持不变。
恢复后应该看到
原项目能打开,记录恢复情况已核对。

问题不在列表里?请 AI 排查

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

07本步材料(填写或复制)

展开收起

上面已经逐项发送并完成的,不必再发下面整段模板。需要整理本步材料时再使用;替换【】后确认,再复制到项目对话。

这一步的提示词模板

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

跟练个人学习记录:本步怎么填写/补充提示词

仅当你选择本页全栈跟练时使用:使用下面已合并本步要求的提示词,填好空白后复制发送;不必重复发送上方通用模板。它不授权跳到后续步骤。

全栈跟练:本步提示词

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

08看到这个结果才算完成

能够按说明重新打开原项目,核心操作可用;数据保留按实际需求检查。

09没有看到预期结果,接下来怎么办?

展开收起

方法没写清时,请工具补具体目录、命令和网址。

看结果对照(教学示意,不是你的项目结果)
静态介绍页:重开能浏览即可。记事工具:还必须找回原记录。
记录本次核对结论与版本

这是本人的记录,不是网站自动检测。改动项目后旧结论不能证明新版本通过;未测试或失败时先补测/反馈。

0303对照最初想法,确认真的能用待核对展开这一步收起这一步
选择用户实际要完成的一件事
从打开项目到完成任务,亲手做一遍
记下实际看到的结果
操作示意 · 非工具截图

01开始前准备什么,做完后留下什么?

开始前需要准备什么?

最初的需求文档和你实际试用后的记录。

做完后要留下什么?

docs/acceptance.md 中保存了本人实际操作和结论。

这一步要让 AI 读取和保存哪些文件?

在所选工具的项目对话中,让它先打开下面的文件。找不到时,点击下方链接回到创建文件的步骤。

先让 AI 读取这些材料:当前已确认材料与项目位置

让 AI 将结果保存到:docs/acceptance.md

缺少这些材料?回到创建它们的步骤 →

02这一步要帮你解决什么问题?

回到最初的想法,亲自看看作品有没有解决自己的问题。

弄懂原理,再试着自己判断

这个概念是什么意思?

验收就是你按照先前约定的方法试用,再决定是否达到了目标。

换个情况,你会怎样判断?

是否还有不能接受的问题或未试过的关键步骤?

查看参考答案

有关键步骤未测试就记未测试;有不可接受问题就记录反馈。本人实际核对通过后再进入交付,不由AI代填。

试着用自己的话回答;拿不准时先对照上面的解释,再用自己的项目举例核对。

03这一步具体怎么做?

展开收起

想法草稿、需求文件与实际作品

  1. 重新读最初的项目描述,选出当时说“做完应该能做到”的事情。展开收起

    完成后应该看到:手里有自己的目标和对应试用方法。

  2. 像实际使用者一样操作作品,不借助工具临时改数据来完成流程。展开收起

    完成后应该看到:知道作品有没有解决最初的问题。

  3. 填写下方试用记录并确认,再展开“把本步已确认记录交给 AI 保存”,生成保存话术,复制到项目对话。展开收起

    完成后应该看到:docs/acceptance.md 中保存了本人实际操作和结论。

跟练:个人学习记录(前端 + 后端 + 数据库)

选择这个示例时,沿用同一个 learning-journal 项目逐步完成。已有自己的项目时,对照检查相关要求即可,不必另建项目。

按原需求亲手做一轮新记录、重新读取、失败后重试和重启检查,再填写自己的实际结果。

做完这一步,应该看到什么?
验收记录对应当前版本,明确前端、后端、数据库各有什么证据。
做不下去时,先怎么办?
没做的写未测试;示例成功记录不能复制成自己的通过结论。

04不会具体操作?逐项跟着做

展开收起
  1. 重新读最初的项目描述,选出当时说“做完应该能做到”的事情。

    操作后应该看到什么?
    手里有自己的目标和对应试用方法。
    没有看到这个结果时,怎么办?
    目标发生变化时先写清变化,不能临时降低标准把失败算通过。
  2. 像实际使用者一样操作作品,不借助工具临时改数据来完成流程。

    操作后应该看到什么?
    知道作品有没有解决最初的问题。
    没有看到这个结果时,怎么办?
    没有条件亲自试就填未测试,不照抄 AI 的通过结论。
  3. 填写下方试用记录并确认,再展开“把本步已确认记录交给 AI 保存”,生成保存话术,复制到项目对话。

    操作后应该看到什么?
    docs/acceptance.md 中保存了本人实际操作和结论。
    没有看到这个结果时,怎么办?
    有问题选“记录反馈”,达到目标再选择交付方式。

05这一步出现的词

展开收起

验收标准 ↗

可以据此判断需求是否完成的条件。

不是“出餐快”,而是“付款后能看到取餐号”。

依赖版本 ↗

标识所用软件包某次发布的编号。

同款零件不同批次可能接口不同。

06遇到问题时,应该怎么处理?

展开收起

AI 说全部完成,但我仍不会用

先检查哪里,确认问题的原因?
能否不看聊天记录,独自完成最重要的操作?
按下面的方法处理问题
指出第一个需要解释的位置,要求修改界面或补启动说明,再亲手重做,不把困惑归咎于自己。
恢复后应该看到
主流程无需作者额外解释也能完成。

问题不在列表里?请 AI 排查

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

07本步材料(填写或复制)

展开收起

先在下面填写自己的材料,点击确认后核对生成内容;什么时候交给工具,按上面的具体操作来。重新打开本页若只看到编辑框,核对后再点确认即可重新复制。

这一步的填写模板

直接编辑下方模板,确认后生成可复制草稿;按当前步骤说明使用,不必立即发给 AI。

跟练个人学习记录:本步怎么填写/补充提示词

这是填写方向,请把上方模板中的空白换成自己的真实信息。验收、费用、路径和测试结果不能照抄示例。

本人实际试用:版本、入口、记录编号、正常保存、空白拒绝、服务停止后输入保留、重新启动读回。逐项填通过/失败/未测试及实际现象。

08看到这个结果才算完成

留下本人的试用结果;可以决定先自用,不必马上发布。

09没有看到预期结果,接下来怎么办?

展开收起

目标发生变化时先写清变化,不能临时降低标准把失败算通过。

看结果对照(教学示意,不是你的项目结果)
版本abc:报名通过;取消未测试 → 结论未测试,不能写第一版全部通过。
把本步已确认记录交给 AI 保存

先在本页模板填写、确认,再点击下方按钮。AI 将记录保存到 docs/acceptance.md,请在项目文件区亲手打开核对。

记录本次核对结论与版本

这是本人的记录,不是网站自动检测。改动项目后旧结论不能证明新版本通过;未测试或失败时先补测/反馈。

没通过?沿这条路修好再继续测试或上线评估发现问题时,按这三步修好,再回到上面的节点。

0103把试用结果记录成反馈待核对展开这一步收起这一步
写下从哪里开始、做了什么
写下应该看到什么、实际看到了什么
把问题记录保存到项目文件中
操作示意 · 非工具截图

01开始前准备什么,做完后留下什么?

开始前需要准备什么?

出现问题时的操作顺序、画面或报错。

做完后要留下什么?

反馈文件有问题编号、重现步骤和证据。

这一步要让 AI 读取和保存哪些文件?

在所选工具的项目对话中,让它先打开下面的文件。找不到时,点击下方链接回到创建文件的步骤。

先让 AI 读取这些材料:当前已确认材料与项目位置

让 AI 将结果保存到:docs/feedback.md

缺少这些材料?回到创建它们的步骤 →

02这一步要帮你解决什么问题?

把哪里出错写具体,工具才能找到同一个问题。

弄懂原理,再试着自己判断

这个概念是什么意思?

反馈先写你做了什么、看到了什么,不需要自己猜代码哪里错了。

换个情况,你会怎样判断?

“按钮没反应”和“数据库坏了”,哪一个是观察,哪一个需要证据?

查看参考答案

“按钮没反应”是观察;“数据库坏了”是原因判断,需要日志或检查支持。先写动作、预期和实际结果。

试着用自己的话回答;拿不准时先对照上面的解释,再用自己的项目举例核对。

03这一步具体怎么做?

展开收起

实际作品、本页模板与项目对话

每次只发送当前这一项的提示词:选中框内文字复制(Mac 按 ⌘C,Windows 按 Ctrl+C),切到所选工具的项目对话,粘贴后把【】替换成自己的内容,再点发送。等工具回复并核对“完成后应该看到”的结果,再做下一项。

  1. 选一个问题,写下从哪里开始、输入什么、点哪里、出现什么。展开收起

    完成后应该看到:别人能照着描述走到同一问题。

  2. 把操作记录和报错填进下方模板,确认后复制给工具。展开收起

    建议提示词:

    请把以下问题整理到 docs/feedback.md,给每项编号,写清预期与实际:【粘贴记录】。先记录和检查原因,不修改代码;还没查明的原因不要写成事实。

    完成后应该看到:反馈文件有问题编号、重现步骤和证据。

跟练:个人学习记录(前端 + 后端 + 数据库)

选择这个示例时,沿用同一个 learning-journal 项目逐步完成。已有自己的项目时,对照检查相关要求即可,不必另建项目。

把失败时输入的测试内容、点击顺序、时间、页面提示和报错放在一起;截图不要含私人资料。

做完这一步,应该看到什么?
别人能照记录复现,不只有“保存坏了”。
做不下去时,先怎么办?
不知道什么是日志时,让 Codex 指出本项目服务输出的位置并只提取对应时间的错误。

04不会具体操作?逐项跟着做

展开收起
  1. 选一个问题,写下从哪里开始、输入什么、点哪里、出现什么。

    操作后应该看到什么?
    别人能照着描述走到同一问题。
    没有看到这个结果时,怎么办?
    不要只写“不能用”;不懂原因没关系,记录现象即可。
  2. 把操作记录和报错填进下方模板,确认后复制给工具。

    操作后应该看到什么?
    反馈文件有问题编号、重现步骤和证据。
    没有看到这个结果时,怎么办?
    截图含密码或个人信息时先遮住再发送。

05这一步出现的词

展开收起

程序缺陷 ↗

导致行为不符合预期的程序问题。

按电灯开关却启动风扇。

日志 ↗

程序运行时记录的事件信息。

值班记录写下时间与发生的事。

06遇到问题时,应该怎么处理?

展开收起

问题偶尔出现,不能稳定重现

先检查哪里,确认问题的原因?
记录出现次数、设备、版本和最近一次完整操作。
按下面的方法处理问题
只收集当前现象、操作、版本与报错原文,必要时只读排查;本步不修代码。失败记录到反馈,按“先确定怎么修、怎样算修好”确认计划后再修复。
恢复后应该看到
有可核对的实际记录,未执行仍标未测试,失败仍标失败。

问题不在列表里?请 AI 排查

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

07本步材料(填写或复制)

展开收起

上面已经逐项发送并完成的,不必再发下面整段模板。需要整理本步材料时再使用;替换【】后确认,再复制到项目对话。

这一步的提示词模板

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

跟练个人学习记录:本步怎么填写/补充提示词

仅当你选择本页全栈跟练时使用:使用下面已合并本步要求的提示词,填好空白后复制发送;不必重复发送上方通用模板。它不授权跳到后续步骤。

全栈跟练:本步提示词

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

08看到这个结果才算完成

有能让别人重复操作的反馈记录,事实、猜测和新增需求分开。

09没有看到预期结果,接下来怎么办?

展开收起

不要只写“不能用”;不懂原因没关系,记录现象即可。

看结果对照(教学示意,不是你的项目结果)
F01 / 取消后刷新 / 预期余位+1 / 实际未变 / 版本abc / 两次均复现。
0203先确定怎么修、怎样算修好待核对展开这一步收起这一步
按记录再做一次,确认问题会出现
明确这次只修哪些问题
写清修好后怎样检查
操作示意 · 非工具截图

01开始前准备什么,做完后留下什么?

开始前需要准备什么?

刚才保存的问题反馈记录。

做完后要留下什么?

修复计划有具体改动和检查方法。

这一步要让 AI 读取和保存哪些文件?

在所选工具的项目对话中,让它先打开下面的文件。找不到时,点击下方链接回到创建文件的步骤。

先让 AI 读取这些材料:docs/feedback.md · docs/requirements.md

让 AI 将结果保存到:docs/repair-plan.md

缺少这些材料?回到创建它们的步骤 →

02这一步要帮你解决什么问题?

先看懂工具准备怎么修,再让它动手。

弄懂原理,再试着自己判断

这个概念是什么意思?

修复计划说明改哪里、会影响什么,以及怎样再次检查。

换个情况,你会怎样判断?

修好了保存按钮,为什么还需要试一下读取历史记录?

查看参考答案

保存与读取可能共用数据结构或接口,修一个可能影响另一个。原问题复测与相关正常功能回归都要做。

试着用自己的话回答;拿不准时先对照上面的解释,再用自己的项目举例核对。

03这一步具体怎么做?

展开收起

项目对话与 docs/repair-plan.md

每次只发送当前这一项的提示词:选中框内文字复制(Mac 按 ⌘C,Windows 按 Ctrl+C),切到所选工具的项目对话,粘贴后把【】替换成自己的内容,再点发送。等工具回复并核对“完成后应该看到”的结果,再做下一项。

  1. 先让工具解释为什么出问题。展开收起

    建议提示词:

    请读 docs/feedback.md 和需求,先检查问题原因,不改代码。把已查明的事实和还要验证的猜测分开,告诉我下一项最小检查。

    完成后应该看到:得到能对应实际问题的解释。

  2. 让工具写清准备改哪里、怎么确认改好了,然后自己读一遍。展开收起

    建议提示词:

    请保存 docs/repair-plan.md:每个问题改哪些文件、会影响哪些原功能、怎样重走失败步骤、修好应该看到什么。涉及数据库先写备份和恢复方法,等我确认再执行。

    完成后应该看到:修复计划有具体改动和检查方法。

跟练:个人学习记录(前端 + 后端 + 数据库)

选择这个示例时,沿用同一个 learning-journal 项目逐步完成。已有自己的项目时,对照检查相关要求即可,不必另建项目。

让 Codex 先复现,再说明只改哪一层,改完重跑哪条失败操作。

做完这一步,应该看到什么?
修复计划包括数据保护及原本正常保存的回归检查。
做不下去时,先怎么办?
建议删库时先停止,要求备份和非破坏性方案;缺证据就先补诊断。

04不会具体操作?逐项跟着做

展开收起
  1. 先让工具解释为什么出问题。

    操作后应该看到什么?
    得到能对应实际问题的解释。
    没有看到这个结果时,怎么办?
    原因不明就继续小范围检查,不默认重装或删库。
  2. 让工具写清准备改哪里、怎么确认改好了,然后自己读一遍。

    操作后应该看到什么?
    修复计划有具体改动和检查方法。
    没有看到这个结果时,怎么办?
    只有“优化一下”就要求写具体,不直接批准。

05这一步出现的词

展开收起

根因 ↗

导致问题的基础原因而非表面现象。

灯不亮可能是线路断了,不只是灯泡坏。

回归测试 ↗

修改后检查已有能力是否被破坏。

修完厨房灯,再看其他灯是否仍正常。

06遇到问题时,应该怎么处理?

展开收起

AI 没给计划就开始修改

先检查哪里,确认问题的原因?
检查当前改动与反馈编号是否对应。
按下面的方法处理问题
暂停后续修改,先让 AI 汇报已经改过什么、保存当前状态,再补修复范围和通过条件。不为回到计划阶段强行丢弃现有改动。
恢复后应该看到
重新执行原操作,得到本页要求的实际结果;未执行的检查仍标为未验证。

问题不在列表里?请 AI 排查

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

07本步材料(填写或复制)

展开收起

上面已经逐项发送并完成的,不必再发下面整段模板。需要整理本步材料时再使用;替换【】后确认,再复制到项目对话。

这一步的提示词模板

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

跟练个人学习记录:本步怎么填写/补充提示词

仅当你选择本页全栈跟练时使用:使用下面已合并本步要求的提示词,填好空白后复制发送;不必重复发送上方通用模板。它不授权跳到后续步骤。

全栈跟练:本步提示词

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

08看到这个结果才算完成

每项修复对应反馈编号和可重复的通过条件。

09没有看到预期结果,接下来怎么办?

展开收起

原因不明就继续小范围检查,不默认重装或删库。

看结果对照(教学示意,不是你的项目结果)
F01:修正取消释放名额;复测原步骤;回归报名和重复取消;不改页面样式。
0303按计划修复,再交给本人复测待核对展开这一步收起这一步
执行修复
检查原本能用的相关功能有没有被改坏
亲手重复出错时的操作
操作示意 · 非工具截图

01开始前准备什么,做完后留下什么?

开始前需要准备什么?

你已确认的修复计划,以及原来失败的操作。

做完后要留下什么?

问题状态与本人实际结果一致。

这一步要让 AI 读取和保存哪些文件?

在所选工具的项目对话中,让它先打开下面的文件。找不到时,点击下方链接回到创建文件的步骤。

先让 AI 读取这些材料:docs/repair-plan.md · docs/feedback.md

让 AI 将结果保存到:docs/checks.md · docs/feedback.md

缺少这些材料?回到创建它们的步骤 →

02这一步要帮你解决什么问题?

让工具修好已确认的问题,然后自己重做原来失败的操作。

弄懂原理,再试着自己判断

这个概念是什么意思?

复测是重新试原问题;再检查原本正常的功能,可以发现有没有顺带改坏别的地方。

换个情况,你会怎样判断?

如果 AI 自测通过,但同样的操作仍失败,下一步应该记录哪个事实?

查看参考答案

记录同一版本、相同步骤下本人仍失败的实际结果,沿用问题编号追加证据,不能以AI自测覆盖它。

试着用自己的话回答;拿不准时先对照上面的解释,再用自己的项目举例核对。

03这一步具体怎么做?

展开收起

当前项目对话及实际预览

每次只发送当前这一项的提示词:选中框内文字复制(Mac 按 ⌘C,Windows 按 Ctrl+C),切到所选工具的项目对话,粘贴后把【】替换成自己的内容,再点发送。等工具回复并核对“完成后应该看到”的结果,再做下一项。

  1. 确认修复计划后,让工具只改这一项问题。展开收起

    建议提示词:

    请按已确认的 docs/repair-plan.md 修复【问题编号】。保护已有数据,只改必要文件,完成后报告实际检查结果和我该怎样复测。

    完成后应该看到:工具说明改了哪里和怎样再试。

  2. 亲自重走原来失败的那组操作,再试原本正常的功能。展开收起

    完成后应该看到:原问题解决,原来的保存和读取仍正常。

  3. 把自己的复测结果交给工具保存。展开收起

    建议提示词:

    我的复测结果:【填写】。请更新 docs/checks.md 和 docs/feedback.md;只有我实际验证通过的问题才关闭,未测项保留。

    完成后应该看到:问题状态与本人实际结果一致。

跟练:个人学习记录(前端 + 后端 + 数据库)

选择这个示例时,沿用同一个 learning-journal 项目逐步完成。已有自己的项目时,对照检查相关要求即可,不必另建项目。

执行确认过的一项修复,自己重做原失败操作,再确认旧记录还在。

做完这一步,应该看到什么?
原问题通过,正常新增/读取及已有数据也通过。
做不下去时,先怎么办?
测试状态被 AI 全改成通过时,恢复真实未测项;要求区分它的测试与本人试用。

04不会具体操作?逐项跟着做

展开收起
  1. 确认修复计划后,让工具只改这一项问题。

    操作后应该看到什么?
    工具说明改了哪里和怎样再试。
    没有看到这个结果时,怎么办?
    范围扩大或要求清库时先停,回修复计划说明原因。
  2. 亲自重走原来失败的那组操作,再试原本正常的功能。

    操作后应该看到什么?
    原问题解决,原来的保存和读取仍正常。
    没有看到这个结果时,怎么办?
    仍失败就保留同一问题编号,补新证据,不重新编一个“已解决”的问题。
  3. 把自己的复测结果交给工具保存。

    操作后应该看到什么?
    问题状态与本人实际结果一致。
    没有看到这个结果时,怎么办?
    工具与本人结论不一致时,以实际复测为依据继续检查。

05这一步出现的词

展开收起

回归测试 ↗

修改后检查已有能力是否被破坏。

修完厨房灯,再看其他灯是否仍正常。

回滚 ↗

恢复软件或配置到较早版本。

换回旧设备不自动恢复被修改的账本。

06遇到问题时,应该怎么处理?

展开收起

AI 说修好了,同样的操作仍失败

先检查哪里,确认问题的原因?
核对正在打开的是新版本,并保留原失败操作。
按下面的方法处理问题
点击“复测仍有问题”,补充当前版本和实际结果。请 AI 用相同步骤复现并更新修复计划,不重新生成整个项目。
恢复后应该看到
重新执行原操作,得到本页要求的实际结果;未执行的检查仍标为未验证。

问题不在列表里?请 AI 排查

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

07本步材料(填写或复制)

展开收起

上面已经逐项发送并完成的,不必再发下面整段模板。需要整理本步材料时再使用;替换【】后确认,再复制到项目对话。

这一步的提示词模板

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

跟练个人学习记录:本步怎么填写/补充提示词

仅当你选择本页全栈跟练时使用:使用下面已合并本步要求的提示词,填好空白后复制发送;不必重复发送上方通用模板。它不授权跳到后续步骤。

全栈跟练:本步提示词

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

08看到这个结果才算完成

AI 检查与本人复测分别记录;仍失败就继续反馈,不能自动进入发布。

09没有看到预期结果,接下来怎么办?

展开收起

范围扩大或要求清库时先停,回修复计划说明原因。

看结果对照(教学示意,不是你的项目结果)
F01 / 修复版本def / 原步骤通过 / 报名回归通过 / 本人已复测 → 可以关闭F01。
记录本次核对结论与版本

这是本人的记录,不是网站自动检测。改动项目后旧结论不能证明新版本通过;未测试或失败时先补测/反馈。

本节点出现的词按出现顺序排列,点开可查完整解释

更多问题与排障资料

遇到卡点,从现象开始查

2 种情况

以下路径整理自官方文档与公开求助,不代表发生频率。先按现象检查,再核对处理结果。

页面能打开就认为测试通过

看到的现象:没有实际提交、刷新、登录或权限检查。

  1. 先检查哪些地方?

    把检查项对照需求,而不是对照截图。

  2. 接着处理

    实际走一次主流程,再检查空输入、错误输入、失败和第二个测试账号;逐项记录预期、实际及证据。

  3. 这样才算解决

    记录区分通过、失败、未执行,页面截图不替代操作结果。

把这段发给 AI 协助处理

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

查证依据Playwright · Testing best practices ↗

只发“不能用”,AI 无法复现

看到的现象:修复反复猜测,双方看到的结果不同。

  1. 先检查哪些地方?

    记录设备、页面地址、操作顺序、实际结果与期望结果。

  2. 接着处理

    从干净测试状态重试,附完整报错或截图,隐去私人数据;一次报告一个问题,注明是否每次出现。

  3. 这样才算解决

    AI 或另一人能按记录复现同一现象。

把这段发给 AI 协助处理

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

查证依据Lovable · Project chat and debugging ↗

遇到卡点,从现象开始查

2 种情况

以下路径整理自官方文档与公开求助,不代表发生频率。先按现象检查,再核对处理结果。

AI 说完成,本人仍不会用

看到的现象:所有检查变绿,但实际任务依然完成不了。

  1. 先检查哪些地方?

    选一个真实使用任务,由本人不看代码直接操作。

  2. 接着处理

    按需求从入口做到结果;记录停顿、误解和绕路,优先修阻塞,不以测试数量代替验收。

  3. 这样才算解决

    本人独立完成主任务,并明确列出尚未满足的需求。

把这段发给 AI 协助处理

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

查证依据MDN · Plan a first website ↗Playwright · Testing best practices ↗

演示正常,真实材料就出问题

看到的现象:短标题、少量样例正常,长文字或真实图片破版。

  1. 先检查哪些地方?

    比较演示材料与实际材料的长度、格式、数量和缺失情况。

  2. 接着处理

    用脱敏真实材料做验收;检查长文本、缺图、空列表和手机宽度,记录原数据未覆盖的情况。

  3. 这样才算解决

    代表性实际材料可用,未覆盖条件仍明确标注。

把这段发给 AI 协助处理

先在模板中补充实际材料,确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”,示例可以自行替换。

查证依据MDN · Common web layouts ↗Playwright · Testing best practices ↗

本节点可查的资料

遇到对应问题再查,资料不是额外必做步骤。

按本节点查术语 →
我的项目材料与备份

材料只存于这台设备的当前浏览器;不是项目文件,也不会自动发给 AI。中英文模板分别保存,项目选择和学习进度共用。不要在这里填写密码或 API Key。

包括想法、进度、各步模板、人工核对记录及选型条件;不包含你的真实项目代码。恢复会建立一个新草稿,不覆盖已有项目。

下载或导入不工作?复制备份文本恢复

草稿与进度只保存在当前浏览器。

按顺序完成本页操作,遇到问题时展开对应的检查和处理方法。

寻找起点

板块快捷入口

大家在做什么 · AI收益调研 · 50个方向 · GitHub项目完整路线图 · 从想法到上线先记下自己的想法只有“想做一个网站”,不知道写什么整理成可以交给 AI 的项目描述不知道第一版的流程怎么写打开一个能制作文件的 AI 工具无法安装、登录,或界面不一样给项目建一个自己的文件夹侧栏没有“文稿”或找不到文件夹让 AI 打开刚才的文件夹AI 说的是另一个项目建立 Git 仓库,写好项目说明和规则提交失败或要求填写姓名邮箱亲手核对 AI 创建的文件找不到上一步的文件一次回答一个问题AI 问的技术词看不懂确认这版只做哪几件事删减以后只剩外观把约定留成看得懂的说明说明太长,不知道该确认哪句把用户怎样使用写清楚AI 只列功能名,没有使用过程先看关键页面,再决定怎么开发原型看起来能用,但不清楚哪些是假数据把实际条件交给 AI 选做法我不知道“本机”和“共享”怎么选让 AI 列出下一小步第一项只有“完成前端”检查运行环境,启动最小项目安装或启动失败,不知道停在哪里打开第一张属于自己的页面地址打不开或一直加载只调整眼前这一页改外观后其他功能也变了让“保存”真正留下内容保存不了,或刷新后记录不见了从开始到结束走通一次按钮能点,但没有结果试试空白和连续点击出现空记录或重复记录关掉以后,还能重新打开第二天地址打不开对照最初想法,确认真的能用AI 说全部完成,但我仍不会用把试用结果记录成反馈问题偶尔出现,不能稳定重现先确定怎么修、怎样算修好AI 没给计划就开始修改按计划修复,再交给本人复测AI 说修好了,同样的操作仍失败先决定:自己用,还是分享发给别人后打不开检查是否具备交付条件评估说可上线,却没有证据准备交付物,并实际试运行安装包打不开或部署后启动失败确认交付,再检查实际入口自己的电脑能开,其他人打不开可选:把简单网页放到 GitHub Pages正式网址显示 404下次继续时,不用从头讲换对话后 AI 要重新做选择工具 · Codex Claude Cursor Qoder TRAE Kimi 价格首页项目分类和 Agent 沟通 · 提示词与排查技术栈选择前端与 UI · 组件词典术语库 · AI与项目开发 · 生活例子与图解打开工具,确认能操作项目把项目、版本记录和 AI 规则准备好把想要的界面风格说清楚只修改一个地方,让 AI 找准目标后端:保存资料与访问规则测试:亲手检查是否能用部署上线:交付一个真实入口运维:让产品继续可用Web 网站与应用 · 把想法变成一个网址。小程序 · 在用户熟悉的地方,做一个小工具。手机 App · 让一个好想法,成为日常习惯。桌面 App · 把重复的电脑工作,交给自己的工具。

一个面向零基础的实践指南

这是面向零基础的双语实践指南,按 6 个阶段、18 个节点、31 个动作组织。页面中的应用画面是示意图;项目完成情况由使用者核对。