Vibe Coding 不翻车：用 PRD-Manager 把脑子里的想法翻译给 AI

claude code 安装好了 ，claude skills 也讲过了

接下来就是实战vibe coding了

我做的一个简单的打地鼠小游戏，可以参考参考

友情链接

claude code 安装

claude skills 讲解

然后接下来就是 vibe coding了，

一、AI 写代码总写歪，根源在哪儿

你跟 AI 说：「帮我做个用户登录」。

AI 利索地写了一坨代码，跑起来也没报错。但你点开一看，它给的是账号密码登录，而你心里想的是邮箱验证码登录。

这种翻车，每个人都遇到过。

不是 AI 蠢，是你脑子里那套完整的业务想法，没翻译成 AI 能看懂的「施工图」。你嘴上能说清的，永远只是冰山一角。

PRD-Manager 干的事，就是逼你把这些没想完的东西先想清楚，整理成 AI 能直接消费的结构化文档。

二、PRD-Manager 是什么

PRD-Manager 是一个 Claude Skill，作者在 GitHub 公开开源（MIT 协议）。当前版本 v2.0.0。

它的定位很明确：辅助 Vibe Coding 的文档管理工具。

通俗讲：你不用学产品经理那套，也不用打开 Obsidian/ 飞书写一堆模板。你只要跟 AI 说一句「用 prd-manager 帮我整理需求」，它会自动按 8 种文档的边界，把你脑子里的东西问出来、写下来、版本化管起来。

它解决的核心问题就一个：把模糊想法 → 结构化文档 → 喂给 AI 写代码。

三、8 种文档，每份只回答一个问题

这是 PRD-Manager 最关键的设计。每份文档的边界划得很清楚，不会乱：

| 文档 | 只回答 | 不要碰 |

| — | — | — |

| prd.md | 做什么 / 为什么 | 技术方案 |

| design.md | 长什么样 | 数据库设计 |

| dev.md | 怎么实现 | 用户故事 |

| plan.md | 谁来做 / 什么时间 | 接口定义 |

| ops.md | 怎么部署运维 | 测试用例 |

| test.md | 怎么测试验证 | 用户故事 |

| CHANGELOG.md | 版本变更历史 | 当前需求 |

| CLAUDE.md | 项目上下文给 AI | 业务细节 |

为什么要分这么细？

因为这正好对应了 AI 在不同阶段需要看的东西：

• 写需求时，只读 prd.md，不会被技术细节带歪

• 画 UI 时，只读 design.md，不需要懂数据库

• 写代码时，读 dev.md + plan.md，知道做什么、改哪些文件

• 写测试时，读 prd.md + test.md，做 PRD ↔ Code 双向验证

每份文档只回答一个问题 —— 这条规则，AI 才不会把验收标准混进技术架构里乱写一通。

文档之间是怎么联动的

prd.md 写完先停一下，让你确认需求没遗漏；dev.md 写完再停一下，让你确认技术方案没问题。双确认避免了 AI 一路跑偏到底。

四、安装与触发方式

安装PRD-Manager 是一个 Skill，放进 Claude 的 skills 目录就能用：

怎么触发

不需要记任何命令。直接跟 AI 说人话就行，触发词带「prd-manager」就稳了：

目录结构

PRD-Manager 支持两种目录结构，会自动识别。新项目直接用「版本优先」就行：

五、实战 v1.0.0：从一句话需求到能跑的打地鼠

光看介绍没感觉，咱们直接动手做一个小游戏。

目标：做一个打地鼠网页小游戏，纯前端，单 HTML 文件能跑。

5.1 一句话需求开场

打开 Claude Code，新建一个空目录 whack-a-mole，敲下这样一句话：

时会做的事：

• 识别意图 = 新项目从零生成 PRD

• 优先输出 prd.md，停下来等你确认

• 确认后再继续 design.md → dev.md → plan.md

5.2 AI 反问出来的细节

这是关键一步。AI 不会闷头写，它会反问你。下面是真实场景里它会追问的问题（用 PRD-Manager 之前你压根想不到这些）：

地鼠出现的频率是固定的还是随时间加快？

一只地鼠最多停留多久？没点中算不算扣分？

30 秒后是直接弹分数，还是有再来一局按钮？

要不要保存历史最高分？保存到哪里？

移动端要不要适配？

有没有暂停按钮？

每一个问题，都是一个潜在翻车点。你只要回答 yes/no 就行：

5.3 生成 prd.md

回答完，PRD-Manager 会产出 docs/v1.0.0/prd.md，大概长这样：

1个「打地鼠」从一团模糊变得边界清晰了。这就是 PRD-Manager 的价值。

5.4 确认后继续生成

你回一句「确认 prd.md，继续」，PRD-Manager 会接着输出：

• design.md：3x3 网格的 ASCII 原型、配色、地鼠动画的状态

• dev.md：技术栈选型（原生 HTML + CSS + JS，不引入框架）、文件结构（单文件 index.html）、关键函数清单

• plan.md：任务拆解（搭骨架 → 出地鼠逻辑 → 计分倒计时 → 结算 → 移动端适配）、预估 90 分钟完成

• test.md：5 条手动测试用例 + 验收清单

• CHANGELOG.md：v1.0.0 初版记录

• CLAUDE.md：项目上下文，告诉 AI「这是一个纯前端单文件项目，不要引入任何依赖」

5.5 让 AI 按文档写代码

文档齐了，下面这一步才是 Vibe Coding 真正爽的地方。你只要说：

写出来的 index.html 会精准命中你的需求：3x3 网格、1 秒一只、1.2 秒停留、30 秒计时、结算弹窗。** **

上面最开头是我做的一个简单的视频，可以参考参考

六、实战 v1.1.0：加难度、加排行榜、加音效

游戏跑起来了，玩了两把感觉不够刺激。咱们升级。

6.1 描述新需求

会做的事：

• 识别这是「新增功能模块」 = Minor 版本号 +1，从 v1.0.0 → v1.1.0

• 在 docs/v1.1.0/ 下生成新的文档集

• 不会把已经有的 v1.0.0 改掉，历史完整保留

• 自动追加 CHANGELOG.md

6.2 PRD-Manager 又会反问

三档难度的具体参数怎么设？

最高分用什么 key 存？切换难度时如何展示对应的最高分？

音效要本地文件还是用 Web Audio API 合成？要不要静音开关？

切换难度是开局时选还是中途可改？

回答完后，新版本的 prd.md 会精准记录：

确认后，PRD-Manager 会只更新与本次变更相关的部分：

• design.md：增加难度选择按钮的位置、最高分显示位、静音图标的状态

• dev.md：新增 localStorage 读写函数、新增 Web Audio 工具函数、改造原有 spawnMole() 接收参数

• plan.md：3 个子任务，预估 60 分钟

• test.md：增加 4 条用例（难度切换、最高分覆盖、静音持久化、跨刷新一致性）

• CHANGELOG.md：自动追加 [v1.1.0] 区块，列明新增 / 变更 / 兼容性

• CLAUDE.md：把「难度系统」「localStorage 存储 schema」「音效策略」三条加入项目记忆

6.4 让 AI 实现 v1.1.0

• 读 CLAUDE.md：知道这是一个纯前端单文件项目，不要装任何依赖

• 读 dev.md：知道改造 spawnMole()、新增三个工具函数、文件还是单 index.html

• 读 plan.md：按子任务顺序写

• 写完对照 prd.md 的验收标准自检

• 同步在 test.md 里登记每条用例的状态

注意 PRD-Manager 强调的一条规则：代码改了，测试必须跟着改。 这条「测试驱动」是它内置的硬规则，AI 在生成代码同时会顺手把对应的手测步骤补到 test.md，避免「上线了才发现测试没跟上」。

6.5 版本对比

跑两轮下来，你会想知道前后到底差了啥。直接说：

会甩给你一份原始 diff，而是输出一份业务向的对比摘要：

汇报、给自己复盘，都比看 diff 香多了。

七、5 个使用心得

实际跑下来，下面这几条你记一下，能少踩很多坑。

1. 别一次说太多需求

PRD-Manager 是按 8 种文档串行推进的，一次性塞 20 条需求容易让它产出大而空的 PRD。一次升一个 Minor 版本，做 1～3 件事最舒服。

2. 双确认那一步不要跳

prd.md 和 dev.md 的两次「确认」是它最值钱的设计。你随手回一句「确认」固然爽，但停下来真读一遍，往往能挑出 1～2 处自己没想清楚的地方，省下后面好几轮返工。

3. 让 PRD-Manager 主动问你问题

你提需求的时候越模糊，它反问的问题越多，整理出来的 PRD 越精准。别怕被它问烦，被问到的每一项都是潜在翻车点。

4. CLAUDE.md 当成项目记忆体认真维护

尤其是「不要引入框架」「数据存哪」「不允许的依赖」这种约束，写进 CLAUDE.md 后，AI 在每次写代码前都会读，比你每次手动叮嘱靠谱得多。

5. 版本号让它自己判断

破坏性变更 → Major、新功能 → Minor、Bug 修复 → Patch，PRD-Manager 会自动识别。你别硬指定，它判断比你准。

MPH_MARKER_24

八、常见问题

Q1：我不是程序员，能用吗？

完全可以。PRD-Manager 主要是帮你「把想法说清楚」，写代码的活还是交给 AI。你只要会回答「是 / 否」「这个先做、那个后做」就够了。

Q2：和 Cursor / Windsurf / 其他 IDE 兼容吗？

PRD-Manager 是 Claude Skill，目前主要在 Claude Code 里触发最稳。但生成出来的 docs/ 文件夹是纯 Markdown，扔到 Cursor / Windsurf 当上下文用一样能跑。

Q3：项目已经写了一半，能中途接入吗？

可以。直接说「用 prd-manager 给当前项目补 v1.0.0 的 PRD」，它会读现有代码反向推 PRD，再继续后面的版本。

Q4：8 份文档每次都要全写吗？

不需要。PRD-Manager 支持「按需只生成单个文档」。比如改个文案 Bug，让它只更 CHANGELOG.md 和 test.md 就够了。

Q5：和我已经在用的 Obsidian/ Lark / 飞书文档冲突吗？

完全不冲突。docs/ 是项目内文档，给 AI 看的；Obsidian / 飞书是给团队看的。两边并行就行，PRD-Manager 这边负责「让 AI 写对」。

写在最后

Vibe Coding 这个概念之所以火，是因为它降低了写代码的门槛。但它有个隐藏前提：你得会描述你的需求。

PRD-Manager 解决的，正是这个隐藏前提。

你脑子里有想法，它帮你翻译；翻译完丢给 AI，代码精准命中；下个版本来了，它接着帮你版本化管起来。

真不是什么高深技术，就是一份份 Markdown 文件。但这种「先想清楚、再让 AI 干活」的工作方式，比你一边和 AI 拉扯一边返工，效率高 10 倍。

打地鼠这个例子很简单，换成你自己的项目（CRM / 后台 / SaaS / 自动化脚本），逻辑完全一样。

祝你 Vibe Coding 不再翻车 ✍️

• PRD-Manager GitHub（fork 版本，与原作者 wlzh/prd-manager 同步）

• 原作者仓库 wlzh/prd-manager

• Anthropic Claude Skills 官方文档

看到这里的朋友，觉得有用可以点个关注，后续会持续更新 AI 实用教程，搞钱干货。

有任何配置问题、使用问题，都可以在评论区留言，我看到都会一一回复！