Vibe Coding 方法论

目录什么是 Vibe Coding核心流程阶段一：项目启动1. 书写项目描述2. 对齐需求3. 生成总纲领 — CLAUDE.md4. 生成技术文档5. 任务拆分6. 创建全局快照（初始空状态）阶段二：项目开发阶段三：项目验收阶段四：项目维护文件体系总览附录一：文件模板项目描述需求文档CLAUDE.md技术文档任务拆分文档全局快照附录二：提示词模板对齐需求生成 CLAUDE.md生成技术文档任务拆分开发单个任务更新全局快照增量需求什么是 Vibe CodingVibe Coding 不是"把模糊需求丢给 AI 然后祈祷"，而是一种渐进式精化的协作开发模式。核心思想是：你不需要在开始前就想清楚所有细节，而是通过与 AI 的持续对话，逐步将模糊想法转化为可工作的代码。核心流程阶段一：项目启动项目启动阶段指的是从有一个模糊的 idea 到让 AI 真正开始写代码之前的阶段。这个阶段需要完成以下文件的初始化构建：1. 书写项目描述尽可能详细地描述你的项目，把你已有的所有信息都写进去，包括：项目背景与目的主要功能目标受众技术栈偏好能想到的任何边界条件和约束不要留白让 AI 猜——你写得越详细，后续对齐需求的成本越低。模板和示例见 附录一：文件模板 → 项目描述2. 对齐需求使用 grilling-me 等 skill 与 AI 对话，让 AI 基于你的项目描述追问、补漏、挑战你的假设，最终生成一份详细的需求文档。反复调整直到满意。注意：这一步不建议和后续步骤挤在同一个会话里。如果对话太长，可以一个会话产出一份需求文档，然后新开会话继续下一步。提示词模板见 附录二：提示词模板 → 对齐需求3. 生成总纲领 — CLAUDE.md新开会话，让 AI 基于需求文档生成 CLAUDE.md。CLAUDE.md 是整个项目最重要的"总纲领"文件，每个新会话都会自动加载。CLAUDE.md 的固定内容板块：板块说明项目简介一两句话说清楚项目是什么，让 AI 快速建立上下文AI 协作规则指导 AI 如何与你协作（先确认再动手、不过度设计、保持简洁等）文档优先级列明项目有哪些文档，指示 AI 在编码前必须先阅读哪些文档编码红线绝对不能违反的约束，包括安全规则、禁止使用的库/模式等受保护文件哪些文件 AI 不能随意修改输出规范对 AI 输出内容的要求（代码风格、注释策略等）编写原则：CLAUDE.md 只写How（怎么建、怎么协作），不写What（建什么功能）。如果某条内容是在描述"用户能做什么"而不是"代码该怎么写或协作该怎么进行"，就删掉。规则尽量通用，不绑定特定 AI 模型。模板和示例见 附录一 → CLAUDE.md提示词模板见 附录二 → 生成 CLAUDE.md4. 生成技术文档让 AI 基于 CLAUDE.md 和需求文档，生成技术文档，内容包括：技术栈（语言、框架、库、版本号）架构决策（为什么选这个方案而不是那个）目录结构/命名规范CLAUDE.md 中已写明 AI 在编码前必须先阅读技术文档，所以技术文档内容不需要重复放进 CLAUDE.md。模板和示例见 附录一 → 技术文档提示词模板见 附录二 → 生成技术文档5. 任务拆分让 AI 基于上述所有文档，对当前项目的所有功能进行拆分，生成任务拆分文档。任务拆分粒度标准：能独立验证— 任务完成后产物必须能跑、能测，不能是"写了一个没人调得动的半成品"2-3 个文件以内— 涉及的改动面越窄，AI 的输出质量越高一个会话内能完成— 如果任务大到 AI 写到一半上下文就炸了，说明拆分得不够细太粗（避免）刚好（推荐）实现用户模块实现用户注册接口搭建前端页面实现登录页 UI加上权限系统给文章接口加上角色校验模板和示例见