阅读全文

⭐⭐⭐ Spring Boot 项目实战	⭐⭐⭐ Spring Cloud 项目实战
《Dubbo 实现原理与源码解析 —— 精品合集》	《Netty 实现原理与源码解析 —— 精品合集》
《Spring 实现原理与源码解析 —— 精品合集》	《MyBatis 实现原理与源码解析 —— 精品合集》
《Spring MVC 实现原理与源码解析 —— 精品合集》	《数据库实体设计合集》
《Spring Boot 实现原理与源码解析 —— 精品合集》	《Java 面试题 + Java 学习指南》

摘要: 原创出处 http://www.iocoder.cn/Fight/GitHub-yiyebaohuozheigexiangmujiejuele-AI-bianchengzuidadekengmeiyoujiyi/ 「芋道源码」欢迎转载，保留摘要，谢谢！

• Vibe Coding 的真正痛点：AI 没有记忆
• 三份文档，一条流水线
• PRD：把”我想做什么”翻译成 AI 能读懂的语言
• TechDesign：堵死 AI 自由发挥的空间
• AGENTS.md：给 AI 写的项目 README
• 全工具兼容：从 Cursor 到 Claude Code
• Vibe Coding Webapp：不想手写文档的人的福音
• 实战上手：从零到跑起来
• 四条实践建议

---

🙂🙂🙂关注微信公众号：【芋道源码】有福利：

1. RocketMQ / MyCAT / Sharding-JDBC 所有源码分析文章列表
2. RocketMQ / MyCAT / Sharding-JDBC 中文注释源码 GitHub 地址
3. 您对于源码的疑问每条留言都将得到认真回复。甚至不知道如何读源码也可以请教噢。
4. 新的源码解析文章实时收到通知。每周更新一篇左右。
5. 认真的源码交流微信群。

---

Andrej Karpathy 2025 年初在 X 上发了一条帖子，说他最近写代码完全靠”感觉”——用 Cursor Composer 配合 Claude 生成，遇到报错直接把错误消息扔回给 AI，基本不看 diff，代码出来能跑就行。他把这种方式叫做 Vibe Coding。

那条帖子火了之后，大多数人都复刻了那种”感觉”——打开 Cursor，憋一句话，等 AI 出代码——但没人复刻出 Karpathy 说的那种效果。

原因只有一个：你跟 AI 说的话没有上下文，AI 不知道你在建什么，只能往最通用的方向猜。

GitHub 上的 vibe-coding-prompt-template（作者 Alp Yalay，2100+ stars）就是为了解决这个问题——把所有约定写成文件，让 AI 每次对话都先读规则，不再靠”教了又忘”。

Vibe Coding 的真正痛点：AI 没有记忆

用 AI 写代码，大部分人的工作流是这样的：打开 Cursor 或 Cline，把想法用一两句话描述，等结果。前几轮往往挺顺。但到了第 5 轮、第 10 轮，问题开始集中爆发：

• AI 开始往你不需要的方向加功能
• 之前定好的命名规范被悄悄改掉
• 你让它修一个 bug，它顺手动了三个不相关的文件
• 换个模型或换个 IDE，之前所有”约定”全部消失

这些问题的根源都一样：AI 没有持久记忆，每次对话的上下文都是临时的。

解法很直观：把所有约定写成文件，放在项目里，每次对话都让 AI 先读。 这就是 vibe-coding-prompt-template 做的事——不是一堆 prompt 模板，而是一套完整的项目记忆系统。

三份文档，一条流水线

整套工作流围绕三类文档展开，顺序不能乱：

文档	回答什么问题	谁读
PRD.md	做什么？给谁做？	AI + 人
TechDesign.md	用什么技术？怎么架构？	AI + 人
AGENTS.md	代码规范、安全要求、工作流程	AI

三份文档层层递进：PRD 定义需求边界 → TechDesign 锁定技术选型 → AGENTS.md 约束执行细节。AI 在整个开发过程中始终有据可循，而不是每次都要重新”教”一遍。

PRD：把”我想做什么”翻译成 AI 能读懂的语言

对应仓库里的 part2-prd-mvp.md。

从一句话的 Project Overview（比如”一个帮忙管理每日习惯的 App，目标用户是时间紧张的上班族”），到具体的 User Stories（”作为[用户]，我希望[功能]，以便[目的]”，每条附验收标准），再到 Feature List——这一条尤其关键，要明确区分第一版必须有的功能和”以后再做”的功能。

不写清楚，AI 很容易好心帮你把路线图上的功能一起塞进来。

此外还有 UI/UX Guidelines（视觉风格、配色偏好）和 Data Model（核心数据实体及其关系）。写完保存为项目根目录下的 PRD.md。

TechDesign：堵死 AI 自由发挥的空间

对应 part3-tech-design-mvp.md。

Tech Stack 要写具体——“Next.js + Tailwind + Supabase + NextAuth”这种精度正好，越含糊 AI 越容易自由发挥。Architecture 描述系统分层；API & Integration 列出核心端点和第三方服务；Database Schema 给出字段名、类型、关系；Implementation Roadmap 把开发计划拆成阶段。

很多人跳过这步，觉得麻烦。代价是 AI 在没有约束的情况下自行选型——有时候会得到一个 class 组件写满的老 React 项目，而你想要的是 hooks。

AGENTS.md：给 AI 写的项目 README

这是整套方案的核心，也是区别于其他”prompt 合集”类项目的关键。

AGENTS.md 的设计理念来自一个正在成为行业标准的文件格式——OpenAI、Google、Anthropic 和 Cursor 团队都在推动的 Agent 配置规范。一份专门给 AI 看的项目使用手册。

生成出来的 AGENTS.md 通常包含：

## Project Overview
[项目一句话描述，供 AI 快速定位上下文]

## Setup Commands
pnpm install
pnpm dev

## Code Style & Conventions
- 使用 TypeScript，禁止 any
- 功能组件优先，禁止 class 组件
- 文件命名：kebab-case，组件命名：PascalCase
- 样式只用 Tailwind，禁止内联 style

## Security
- 禁止提交 .env 文件
- 所有 API key 通过环境变量读取

## PR & Commit Instructions
- commit message 格式：feat/fix/refactor: 描述
- 每个 PR 只做一件事

放到项目根目录后，每次打开 AI IDE，第一条指令就是让 AI 读它。效果是让 AI 在整个开发过程中都遵循你的规则。

全工具兼容：从 Cursor 到 Claude Code

这套模板支持当前主流 AI 编程工具，不需要改模板内容，只是存放位置略有不同：

工具	配置文件名
Cursor	.cursorrules 或 AGENTS.md
Windsurf	.windsurfrules
Cline (VS Code)	AGENTS.md
Claude Code CLI	CLAUDE.md
Aider	.aider.conf.yml + AGENTS.md
Lovable / v0 / Bolt.new	直接粘贴 PRD 内容

实际使用时，你可以用同一份 AGENTS.md 同时驱动 Cursor 和 Claude Code CLI：

ln -s AGENTS.md CLAUDE.md

两个工具读同一份文件，不用维护两份配置。

项目还提供了一组 Claude Code Skills 和 Git Hooks——review-pr 让 Claude 以 Senior Engineer 视角过 PR，write-tests 按 AGENTS.md 定义的测试框架自动补测试用例，Git Hooks 在 commit 前自动检查 .env 泄露和 console.log 残留。

Vibe Coding Webapp：不想手写文档的人的福音

v2.3.0 之后项目新增了 Web 界面：vibeworkflow.app。

在页面上描述项目想法，选择技术偏好，系统调用 Gemini 自动生成 PRD 和 TechDesign 草稿，在线编辑确认后一键导出 Markdown。对没有写 PRD 习惯的人来说，这把”对着空白文件发呆”变成了填表。

实战上手：从零到跑起来

Step 1：用模板创建仓库

打开 KhazP/vibe-coding-prompt-template，点 “Use this template” → “Create a new repository”，克隆下来。

git clone https://github.com/你的用户名/你的项目名.git
cd 你的项目名

Step 2：生成 PRD

打开 AI 对话工具，把 templates/part2-prd-mvp.md 的内容复制进去，描述项目。AI 会追问目标用户、核心功能，最终生成完整 PRD。保存为 PRD.md。

Step 3：生成 TechDesign

继续在同一对话里粘贴 templates/part3-tech-design-mvp.md。AI 基于 PRD 推荐技术栈，确认后生成 TechDesign.md。

Step 4：生成 AGENTS.md

把 PRD 和 TechDesign 一起发给 AI，说”根据这两份文档生成 AGENTS.md”。生成后放项目根目录。用 Claude Code 的执行 ln -s AGENTS.md CLAUDE.md。

Step 5：开始 Vibe Coding

打开 Cursor，在 Composer 里输入：

“请先读取 AGENTS.md、PRD.md 和 TechDesign.md，理解项目目标，然后列出 Phase 1 的开发计划，等我确认后开始执行。”

确认没问题，说”开始”，然后就可以喝咖啡了。

四条实践建议

在 PRD 里写”不要什么”。 AI 非常需要负向约束。”不要使用 Redux”、”不要在第一版加国际化支持”——没有这些，AI 很可能”好心”帮你加一堆你不需要的东西。

让 AI 先计划，再执行。 每次开始较大任务前加一句：”在写代码之前，先列出你打算改动的文件和原因，等我确认后再执行。”这条习惯能把”AI 乱改一堆东西我看不懂”的情况减少 80%。

AGENTS.md 是活文档。 每次发现 AI 犯同样错误，就把对应规则加进去。时间长了，这份文件就变成了你项目的”AI 使用手册”，换模型、换工具，它都能快速上手。

分工用对工具。 UI 设计和用户流程用 Lovable/v0 快速出原型，数据库、鉴权、业务逻辑交给 Cursor 或 Claude Code。两类工具各有所长，都往 AGENTS.md 里喂一遍，能减少很多重复解释。