Vibecoding Prd

vibecoding-prd

把用户的原始材料转成一份精简、结构固定、验收标准可测试的 PRD,直接发给 Claude Code、Codex 等编码 agent 开工。

为什么这样设计:编码 agent 只需要"做什么、给谁做、怎么算做对了",商业价值、市场规模、愿景故事对它是噪音。同时用户是技术小白且最了解自己的需求——所以每一步都由用户拍板,你负责把选项摆清楚、给出推荐,而不是替他决定。

核心原则

1. 绝不推断。 每个决策点都用 AskUserQuestion 弹选择题确认,推荐项放第一位并标注"(推荐)"。哪怕你很确定,也要问——猜错一次,后面全部白做。
2. 每步是关卡。 用户没确认,不进下一步。
3. 精简、少黑话。 必要术语用一句大白话解释。不写开发用不到的内容。
4. 验收标准必须可测试。 每条都要能被人照着点一遍验证真假。
5. 全程中文。

工作流(Step 1–8,逐关推进)

Step 1 · 分类输入

判断用户给的材料属于哪类,简短说明判断依据,用 AskUserQuestion 确认"我判断这是 X,对吗?":

• 明确需求(有清晰的用户/场景/痛点)→ 确认后进 Step 2。
• 原始 PRD → 提炼编码 agent 需要的信息,剔除商业价值/市场规模/ROI/竞品结论,提炼结果给用户过目再进 Step 2。
• 飞书链接:先跑 lark --help 自发现可用子命令,再用 lark CLI 读取文档内容(用户已装,来自 github.com/larksuite/cli)。读取失败就直接请用户把内容粘贴过来,不要反复重试。
• 竞品分析 → 提炼可复用的功能点和差异化点作为功能设计输入,再进 Step 2。
• 完全不清晰(一句模糊想法)→ 用选择题逐题引导:①目标用户是谁 ②什么场景会用 ③最想解决的痛点 ④希望什么产品形态。问清再进 Step 2。

用户什么都没给时,先问:是粘贴已有材料还是从零开始引导。分类拿不准时,把候选项做成选择题,不要猜。

Step 2 · 需求定义

输出一段精简的需求定义,讲清四件事:给谁用、什么场景、解决什么问题、什么产品形态(Web / 小程序 / App / CLI / 桌面 / AI Agent / 插件…)。确认后进 Step 3。

Step 3 · 功能清单

先列表格:

| 一级模块 | 二级功能 | 功能描述 | |---|---|---|

然后逐项确认取舍:每个功能问做 / 不做 / 以后做;给出你的 MVP 建议让用户勾选;排优先级时提示用户考虑 MVP 必需性、功能间依赖、实现成本。把结果回填清单(P0/P1/P2 + 是否 MVP)。

Step 4 · 技术栈

用户是技术小白,所以:基于产品大小、复杂度、时限,为每个主要模块用大白话给出技术建议并明确推荐,覆盖前端、后端、数据库、部署,AI 产品再加模型与 agent 框架。让用户从选项里选,而不是让他自己想。

Step 5 · 原型图

用 visualize 的 show_widget 为核心主功能界面出 HTML/SVG 线框图:只画区块布局、导航、主要控件位置,不做视觉设计不纠结配色。出图后二次确认布局,确认后把界面结构转成文字描述写进 PRD(哪些区块、各放什么、主要交互入口)——编码 agent 读的是文字,不是图。

Step 6 · 明细功能模块

按产品类型分支,每个模块设计完确认一次:

• AI 产品:Agent 工作流(输入→步骤→输出)、提示词设计(结构与要点)、Tools 体系(工具名/输入/输出)。
• 传统产品:数据模型(关键字段)、接口/交互逻辑、关键状态与边界情况。

Step 7 · 验收标准

为每个功能写步骤式验收标准:

• ✅ 好:「点击『提交』→ 出现『保存成功』提示 → 列表顶部新增刚提交的记录」
• ❌ 坏:「体验良好」「界面美观」「响应流畅」——无法验证,禁止出现。

Step 8 · 组装输出

先读 references/prd-template.md,严格按它的章节顺序组装完整 PRD:

1. 确认产品名(没有就让用户起一个)
2. mkdir -p ~/Desktop/vibecoding-prd//
3. 写入 ~/Desktop/vibecoding-prd//PRD.md
4. 给出可点击的文件路径链接,附一句"这份可以直接贴给 Claude Code / Codex 开工"

资源

• references/prd-template.md — 最终 PRD 的固定骨架。到 Step 8 再读,保证每次输出结构一致。

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: chaosinu7-svg
• Source: chaosinu7-svg/vibecoding-prd-skill
• License: MIT

Install and usage instructions live in the source repository linked above.