Vibe GuideBETA

整理项目描述

项目描述就是告诉别人:我要做什么,给谁用,怎样使用。

做完这一节点,你会得到什么?
项目说明已确认,可以复制给后面的项目对话。
为什么要有这一节点?

把刚才的想法整理成一份说明,后面可以直接交给工具。

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

0101整理成可以交给 AI 的项目描述待核对展开这一步收起这一步
你想用这个项目完成什么事
把想法整理成一份项目说明
核对项目说明后确认保存
操作示意 · 非工具截图

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

开始前需要准备什么?

上一步确认的想法草稿。

做完后要留下什么?

项目说明已确认,可以复制给后面的项目对话。

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

把刚才的想法整理成一份说明,后面可以直接交给工具。

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

这个概念是什么意思?

项目描述就是告诉别人:我要做什么,给谁用,怎样使用。

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

如果 AI 要加一个未提到的功能,应该直接接受,还是先核对它是否解决第一版的问题?

查看参考答案

先核对它是否服务于已确认的第一版目标。有关但非必需的功能先记后续,不直接加入当前制作。

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

03这一步具体怎么做?

展开收起

本站的想法草稿与下方模板

  1. 点击下方模板的“带入前面已确认的材料”,检查是不是自己的想法。展开收起

    完成后应该看到:上一步的用户和目标已出现在模板中。

  2. 补项目名称、在哪种设备上用,以及从打开到完成的一次操作。只写自己想要的使用方法,不需要先选数据库。展开收起

    完成后应该看到:别人读完能知道要做什么、给谁用、怎样试。

  3. 点击“确认,生成我的专属内容”,核对下方出现的文字,再点“复制我的草稿”。回到本页时若只看到编辑框,再确认一次就会出现复制按钮;不要点“使用本步新版模板”清掉自己的填写内容。后面准备 Git 时再把这份说明交给工具。展开收起

    完成后应该看到:项目说明已确认,可以复制给后面的项目对话。

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

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

把前一步想法整理进模板;在“通过条件”写明:换一个浏览器打开同一服务仍能读到记录。

做完这一步,应该看到什么?
项目描述明确有页面、后端和数据库;本机使用不等于只存在浏览器里。
做不下去时,先怎么办?
若只写“刷新不丢”,补上重启服务和第二浏览器读取,避免把浏览器缓存误当数据库。

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

展开收起
  1. 点击下方模板的“带入前面已确认的材料”,检查是不是自己的想法。

    操作后应该看到什么?
    上一步的用户和目标已出现在模板中。
    没有看到这个结果时,怎么办?
    没有带入时回想法步骤确认草稿,或亲手粘贴已写好的内容。
  2. 补项目名称、在哪种设备上用,以及从打开到完成的一次操作。只写自己想要的使用方法,不需要先选数据库。

    操作后应该看到什么?
    别人读完能知道要做什么、给谁用、怎样试。
    没有看到这个结果时,怎么办?
    拿不准的条件写“尚未确定”,留给后面和 AI 讨论。
  3. 点击“确认,生成我的专属内容”,核对下方出现的文字,再点“复制我的草稿”。回到本页时若只看到编辑框,再确认一次就会出现复制按钮;不要点“使用本步新版模板”清掉自己的填写内容。后面准备 Git 时再把这份说明交给工具。

    操作后应该看到什么?
    项目说明已确认,可以复制给后面的项目对话。
    没有看到这个结果时,怎么办?
    发现内容有误就修改模板、重新确认,再复制最新版。

05这一步出现的词

展开收起

项目描述 ↗

把目标、用户、问题和成功条件写清的材料。

装修前写明住几人、需要几间房和预算。

上下文 ↗

AI本次能看到的对话、文件和背景信息。

桌上摊开的资料才方便当前查阅。

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

展开收起

不知道第一版的流程怎么写

先检查哪里,确认问题的原因?
先选择一个人和一件事,暂时不要列所有功能。
按下面的方法处理问题
按“打开哪里 → 做什么 → 看到什么”写三段。例如学习记录:打开页面、填写并保存、再次找到记录。无法确定的地方写尚未确定。
恢复后应该看到
重新执行原操作,得到本页要求的实际结果;未执行的检查仍标为未验证。

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

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

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

展开收起

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

这一步的填写模板

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

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

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

测试条件:合法输入保存成功;空白被拒绝;服务停止时不显示保存成功;重启后能读回;连点一次提交不产生重复记录。

08看到这个结果才算完成

描述包含目标用户、问题、第一版、通过条件和后续范围,没有把例子当成自己的需求。

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

展开收起

没有带入时回想法步骤确认草稿,或亲手粘贴已写好的内容。

看结果对照(教学示意,不是你的项目结果)
项目:读书会预约。设备:手机浏览器。流程:查看场次→输入姓名→报名→查看确认。预算:尚未确定。

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

本节点可查的资料

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

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

材料只存于这台设备的当前浏览器;不是项目文件,也不会自动发给 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 个动作组织。页面中的应用画面是示意图;项目完成情况由使用者核对。