跳到主要内容
返回笔记专区Field Notes / 01

Notes on making

把想法,
一步步做出来。

Vibe Coding 实践笔记:从一句朴素的想法出发,学会和 AI 一起澄清、制作、检查,再把可用的作品交到别人手里。

The idea

人负责方向与判断,
AI 帮忙实现与迭代。

根据 Vibe Coding 小白手册整理,并补充了实践问答和检查清单。

01 / THE PROCESS

从想法到作品,走六步。

不需要一次把所有事情做完。每一步都留下看得见的结果,下一步才有依据。

01

描述问题

先说清谁会用、遇到什么问题,以及希望完成的事情。不要急着把页面和功能全部列满。

02

澄清边界

让 AI 列出不确定的地方,逐一确认使用场景、数据、权限和第一版范围。

03

留下约定

把目标、暂不做的事、关键决策和验收方式写进项目文档,方便后续对话接手。

04

小步实现

先做一条完整的核心流程,能够启动、操作和检查结果后,再扩展下一个功能。

05

亲自走查

从用户的角度操作。发现问题时,提供截图、发生步骤和期望结果,让反馈具体可复现。

06

备份与交付

检查实际数据和部署环境,保留可回退的版本;发布后用真实设备和链接再检查一次。

02 / QUESTIONS

遇到问题,
先问清楚。

把容易卡住的地方整理成问答。展开一条,从眼前的问题开始。

01不会写代码,也可以开始吗?

可以先从一个熟悉的问题出发。你不必在第一天掌握所有技术,但需要负责说明目标、选择方案和验证结果。遇到不懂的术语,就让 AI 结合当前项目解释,并说明这个选择带来的影响。

02为什么要先写项目文档?

较长的项目会跨越多轮对话。把目标、范围、关键决定、运行方式和验收标准放进工程,可以给后续工作提供可检查的共同上下文。文档也需要随着项目变化更新,不能代替实际验证。

03页面上能看到数据,就代表保存了吗?

不一定。它可能只是写在前端的示例,也可能只存在浏览器里。试着新增一条记录、刷新页面,必要时换一个浏览器或设备检查;再确认数据保存在哪里、谁可以访问、如何备份。

04AI 一直改错或越改越乱,怎么办?

先停下连续修改,记录复现步骤和当前报错。让 AI 解释可能的原因、列出会修改的文件,再要求一个尽量小的修复方案。修完重新走一遍原本出错的流程,也检查附近是否出现回归。

05什么时候算可以交付?

至少要有清楚的验收范围:关键流程能走通,数据行为符合预期,常用设备可操作,发布后的链接可访问。涉及账号或敏感信息时,还要单独检查权限、隐私和备份方式。

03 / PROMPT LIBRARY

给对话一个好的起点。

提示词不必写得复杂。把方括号里的内容换成自己的情况,再根据回答继续追问。

项目开始

把想法说清楚

我想做一个【产品或页面】,给【使用者】解决【具体问题】。 第一版最重要的结果是【完成标准】。 请先复述你的理解,列出需要我确认的问题,并给出推荐选项和理由。先不要写代码。

开始执行

拆成可验收的小步

请根据已确认的需求,整理目标、范围、关键决策和验收标准。 把工作拆成小批次,先完成【一条核心流程】。 完成后告诉我改了什么、如何运行和验证,以及还有哪些问题。

发现问题

描述一个具体问题

我在【页面/设备】执行【操作步骤】时,出现了【实际结果或报错】。 我期望的是【期望结果】。 请先定位可能原因,说明准备修改的文件,用最小改动修复,并告诉我如何验证。

04 / BEFORE YOU SHARE

分享之前,
自己先走一遍。

一份简单的出发清单。根据作品的实际需求增减,不必等到完美才开始验证。

  • 从入口开始走一遍核心流程,检查按钮、链接与空状态。
  • 新增、修改的数据按预期保存;刷新后重新检查。
  • 在手机与电脑上检查布局、文字、点击区域和滚动。
  • 核对真实环境的配置、访问权限,以及不能公开的密钥。
  • 保留可回退的版本,并用发布后的链接再走查一次。