驾驭 Vibe Coding · 01.4 / 04

把方法留在项目里

前三节解决一次项目怎样准备、开发和交付。这一节把反复有效的 Prompt、规则、Skill 和检查方式留在项目里,让下一次开始得更清楚。

  • GoodVibe 编写
  • 含 Prompt Builder 与手边书

准备、开发和交付可以完成一次项目。GoodVibe 还会多做一步:把已经验证过的 Prompt、规则、Skill 和检查方式留在项目里,下一次不必从一段空白对话重新开始。

这些材料会跟着后面的复刻、界面、动效、声音与 3D 项目继续生长。只收下真正使用过、知道怎样验收的内容,工具榜单和未经验证的模板留在外面。

保存能够继续指导判断的材料,也保留改变主意和删除旧规则的空间。

GoodVibe 的保存原则

制作循环

每一轮都停在有证据、能够恢复的位置

GoodVibe 把一次协作压成四个可重复动作:说清任务、小步实现、真实验收、保存发布。它们会随着项目变复杂,但顺序不需要频繁改变。卡住时回到上一份证据,通常比继续追加 Prompt 更有效。

  1. 01

    说清任务

    这次只完成什么?

    写清目标、当前情况、限制和完成标准,让 Agent 先读项目再给最小方案。

    留下:一条边界清楚的任务 Prompt

  2. 02

    小步实现

    这次改动是否足够小?

    一次只完成一个可验证结果,不顺手重构无关内容。

    留下:一组有明确目的的改动

  3. 03

    真实验收

    页面真的完成了吗?

    在浏览器里走主要流程,检查报错、手机宽度和生产构建;有问题就带着证据做最小修复。

    留下:截图、错误记录与通过结果

  4. 04

    保存发布

    怎样留下可恢复、可访问的结果?

    检查 Diff,只提交本次文件;获得公开链接后,再在线上走一次主要流程。

    留下:一个版本节点与一条公开链接

图 02 · 每一轮都能停在一个有证据、可恢复的位置。

Prompt Builder

用四个空位组织当前任务

目标说明这一轮要改变什么,当前情况给出页面与已有材料,限制保护现有设计和技术边界,完成标准负责验收。四项都写成当前项目的真实信息,生成的 Prompt 才值得进入工作记录。

填写四件事

first-task.md
请先不要修改代码。

目标:<我想完成什么>
当前情况:<现在看到什么,相关页面或文件是什么>
限制:<必须沿用什么,不要改什么>
完成标准:<我怎样判断它做好了>

先读取项目并输出:
1. 与任务有关的文件
2. 你对当前实现的理解
3. 最小修改方案
4. 风险和需要我确认的事项

等我确认后再实现。

项目规则

稳定约定和当前任务分开保存

启动命令、目录约定、Design System、禁区和完成检查会反复生效,适合写进 AGENTS.md 或项目 Rules。当前页面、当前 Bug 和这次完成标准只属于本轮任务,留在 Context Pack 或对话里即可。

规则文件太长时,Agent 很难判断优先级。主文件保留入口、硬边界和检查方式,设计、内容与特定技术说明通过链接分开维护。

项目里的最小资料结构

harness-map.md
/harness├── AGENTS.md              # 启动、目录、边界与完成检查├── prompt-playbook.md     # 已经真实使用并验证的 Prompt├── context/               # 当前功能或项目的 Context Pack├── skills/                # 解决特定问题的方法说明└── checks/                # 浏览器、构建与发布检查
# 使用规则- 长期约定写进 AGENTS.md,当前任务留在 Context Pack- Prompt 用过并验收以后再保存- Skill 只在对应问题出现时启用- 每次交付后删除过期规则与重复材料

Skills

具体问题出现时,再加入一份专业方法

Skill 负责补充某一种判断或工作步骤,例如界面方向、去除模板感、浏览器验收。一次启用很多 Skill 会让规则互相竞争,也难以追踪是哪一份说明改变了结果。先说清当前缺口,再选择来源清楚的一份。

01

界面方向

常见内置界面设计能力

从空白页面开始,或现有界面缺少明确的视觉方向。

使用边界:先读项目 Design System;Skill 负责提高判断,不覆盖品牌规则。

02

浏览器验收

browser verification

Agent 说“已经完成”,但你还没有在真实页面中看到证据。

使用边界:明确 URL、设备范围、操作路径和截图要求,避免只验收首屏。

项目手边书

把常用材料放在随时能回来的地方

工具安装、概念解释、Prompt Cheatsheet 和发布检查适合做成可搜索的参考页。课程正文只展开当前需要的一小部分,完整索引在新标签页打开,这样不会丢掉当前阅读位置和练习状态。

进入下一章以前

确认这些方法已经留在项目里

第一章结束时,你应该能重新启动项目、把任务分成小轮次、根据页面证据修正问题,并交付公开链接。下面的检查不会追问术语定义,只看这些动作能否独立完成。

这一章留下

四份可以继续使用的证据

01能启动项目,并指出页面入口与本次要改的文件
02能用目标、当前情况、限制和完成标准写出任务 Prompt
03能查看 Diff,并根据真实报错完成一次最小修复
04能保存可恢复版本,并在桌面与手机验收公开链接

本章验收记录

环境检查、项目结构图、Debug 记录、Git checkpoint 和公开 URL。

prompt-playbook.md

只保留本章真正使用过、知道怎样验收的 Prompt,后续 Chapter 继续追加。

学习进度

正在读取你的学习记录…