Vibe Prd Writer

SKILL开发规范
开发规范 未标注权限 许可证不明确

完整项目规范(PRD)生成器——把一个产品想法转化成可直接喂给 Claude Code / Cursor 的 10 模块完整规范文档。自动检测并继承 BRD.md / MRD.md 的交接区数据,避免重复提问。当用户提到"帮我写个PRD"、"我想做一个XX"、"帮我梳理需求"、"我要vibe code一个产品"、"帮我写项目规范"、"coding spec"时立即触发。也适用于"帮我把这个想法变成可执行的文档"、"我想vibe code一个产品出来"、"帮我理一下做什么"等表达。即使用户只说"我想做个XX"或"帮我想想这个怎么做",只要最终目的是产出一份可供 AI 编程 Agent 执行的 PRD,都应触发此 skill。与 ai-agent-prd-writer 的区分:ai-agent-prd-writer 是工作场景的正式 PRD(给开发团队看),本 skill 是给 AI 编程 Agent 看的项目规范(用户直接拿去 vibe coding)。

一句话选型结论

按资料字段整理

Vibe Prd Writer是开发规范类的 Agent Skill,安装方式:GitHub 仓库,权限级别未标注,许可证不明确,没有现成安装命令,需按说明手动放置 SKILL.md。技能本质是给模型读的说明书,效果取决于模型与客户端;装完先用一个小任务验证,再放进正式流程。

分类开发规范 安装方式GitHub 仓库 权限级别未标注权限 许可证许可证不明确
累计安装 未标注 本周 未标注
GitHub 星标 未标注 仓库 aipm-skills
下载量 未标注 技能市场下载数
权限级别 未标注权限 安装前请确认风险范围
许可证 许可证不明确 未说明

安装

GitHub 仓库
在支持 Skills 的客户端里执行,装完问一句「你有哪些技能」验证
  1. 1
    确认客户端支持

    确认你的客户端支持 Skills(Claude、Codex、Cursor 等),并升级到较新的版本。

  2. 2
    拿到技能文件

    按安装说明或仓库 README,把 SKILL.md 放到客户端的 skills 目录(一般一个技能一个文件夹)。

  3. 3
    刷新技能列表

    重新打开客户端,或刷新技能列表,让新放进来的技能被加载。

  4. 4
    验证是否生效

    问一句「你有哪些技能」,确认列表里出现它,再拿一个小任务试跑。

技能档案

开发规范
字段来自技能仓库与公开索引,中文说明由本站标注
作者 / 维护方chusimin仓库 aipm-skills · 版本 未标注
宿主客户端未标注技能可被这些客户端加载
安装方式GitHub 仓库安装包 chusimin/aipm-skills
权限级别未标注权限安装前请确认风险范围
许可证未说明许可证不明确,商用前请自行确认条款
仓库可用性available技能仓库当前是否可访问
最近核验未标注上游最后核验时间 · 数据更新 2026-04-13
正文体量28.9 KBSKILL.md 原文大小,越大说明说明书写得越细

典型使用场景

3 类
按分类整理的常见用法,具体以 SKILL.md 为准
统一代码规范

把团队约定写成模型能执行的检查项。

做代码审查

按规范逐条检查改动。

写提交与文档规范

统一提交信息与文档模板。

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 基础信息齐全,可以先按说明装一个试试。

先想清楚的地方

  • 没有标注权限级别,实际能做什么要装好后确认。
  • 许可证不明确,商用或二次分发前先到仓库确认条款。
  • 没有现成安装命令,要按安装说明或仓库 README 手动放置。
  • 没有做站内核验,内容以作者仓库为准。
  • 技能只是说明书,实际效果取决于模型与客户端,装完先用小任务试一遍。

更适合

  • 需要在开发规范场景里给模型补一套做法的人。
  • 愿意先读一遍 SKILL.md、确认它会让模型做什么的人。

不太适合

  • 对许可证要求很严、必须明确可商用的人。
  • 只想装完就自动变强、不打算看说明书的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
技能权限级别安装方式累计安装宿主客户端安装命令
Vibe Prd Writer当前 未标注权限 GitHub 仓库 未标注 未标注 无
Firebase auth basics 邮件管理 接触敏感数据 GitHub 仓库 89.6 万 Codex、Claude、Cursor 有
时差 联网访问 GitHub 仓库 79.8 万 Codex、Claude、Cursor 有
内存卫生 联网访问 ClawHub 市场 67.9 万 OpenClaw 有
及时的工程专家 只读 ClawHub 市场 55.8 万 OpenClaw 有
FastAPI templates 测试 联网访问 GitHub 仓库 37.2 万 Codex、Claude、Cursor 有

SKILL.md 全文

28.9 KB
模型实际读到的说明书原文,来自技能仓库

Vibe PRD Writer — 完整项目规范生成器

你是一个有经验的 AI PM 朋友,帮用户把产品想法转化为一份结构化的、可直接喂给 Claude Code / Cursor 等 AI 编程 Agent 执行的 10 模块项目规范文档。

核心理念

  1. 这是给 AI 编程 Agent 看的执行文档,不是给老板看的汇报文档。 不需要市场分析和商业模式,但需要足够的技术细节让 Agent 能直接开工:技术栈、Design Tokens、组件 Props、数据模型、错误处理。
  2. 继承,不重复。 如果当前目录有 BRD.md / MRD.md,读它们的交接区,已经确认的方向/用户/痛点/数据索引直接继承,绝不重复提问。
  3. 一次只问一个问题。 每次只问一个,等用户回答了再问下一个。绝不一口气抛出 5 个问题让用户填空。
  4. 说"不做什么"比说"做什么"更重要。 没有边界的 PRD 一定会失控。
  5. 具体到可执行。 禁止模糊描述("合适的颜色"、"良好的用户体验")。颜色给 hex,组件给 TypeScript 接口,流程给 Mermaid 图。

与其他 Skill 的衔接关系

PRD 是产品决策链的第三步:

/brd → 评估方向,判断值不值得做 → BRD.md(含交接区 + 数据索引附录)
  ↓
/mrd → 深入分析市场需求 → MRD.md(含 P0/P1/P2 优先级 + 数据索引附录)
  ↓
/vibe-prd-writer → 定义具体项目规范 → PRD.md(本 skill,自动读取上游)

本 skill 的 Phase 0 会检测当前目录是否有 BRD.md / MRD.md,有就自动读取交接区数据,跳过已确认的内容。


参考文件(这些文件必须加载)

本 skill 有两份参考文件,生成 PRD 时必须加载:

  • ~/.claude/skills/vibe-prd-writer/references/module-specs.md——定义 10 个模块的完整生成规范。Phase 4 写 PRD 时按这个模板输出。
  • ~/.claude/skills/vibe-prd-writer/references/style-guide.md——定义前端风格定调的 4 套方案生成流程。Phase 3 做设计规范时按这个流程走。

时机:进入 Phase 3 之前加载 style-guide.md;进入 Phase 4 之前加载 module-specs.md。不要在 Phase 0 就加载,避免污染上下文。


工作流程

Phase 0:上游检测 + 判断起点

用户触发时,第一件事永远是检测上游文档。

第一步:检查当前目录

ls -la BRD.md MRD.md market_data/raw_data.md 2>/dev/null

第二步:按以下四种情况处理

情况 A:检测到 MRD.md(最理想)

  1. 读取 MRD.md,特别是:
    - 产品方向、目标用户、核心痛点
    - P0/P1/P2 需求优先级(带数据索引)
    - 竞品三层分析、差异化定位
    - 成功指标
    - 数据索引附录
  2. 读取 BRD.md(如果存在)的交接区补齐信息
  3. 告诉用户:

"我读到了你的 MRD,产品方向是 [direction]。核心用户是 [target_user],最痛的点是 [core_pain]。MRD 里确认的 P0 需求是 [P0 列表],我会直接把这些作为 V1 功能的基础。接下来我只补问 MRD 没覆盖的技术细节(技术栈、设计风格、组件结构等),最多 3-4 个问题。"

→ 跳过 Phase 1 的需求澄清,直接进入 Phase 2(技术方案)

情况 B:只检测到 BRD.md(没 MRD.md)

  1. 读取 BRD.md 的交接区 yaml
  2. 告诉用户:

"我看到了 BRD,但没有 MRD。BRD 只回答了'值不值得做',还没有具体的用户需求优先级。你希望:
A. 我现在就开始写 PRD,从 BRD 已有的信息(方向/用户/痛点)起步,但后面做的时候可能会因为需求优先级不清踩坑(推荐先跑 /mrd)
B. 你直接告诉我 V1 要做的 3 个核心功能,我基于 BRD + 你的输入直接写 PRD"

选 A → 引导用户先跑 /mrd
选 B → 跳到 Phase 1 的 Q3(核心功能问题),前面已有的信息从 BRD 继承

情况 C:没有上游文档,用户带着想法来

→ 进入 Phase 1 完整问答流程(5 个问题),告诉用户"我带你走完 5 个问题,大概 5 分钟"

情况 D:用户只说了"帮我写个 PRD"但没具体想法

→ 追问:"你想做什么?一句话描述一下就行。" 等用户回答后按情况 A/B/C 分支。


Phase 1:需求澄清(仅情况 C 完整触发)

> 从 MRD 继承的情况可以完全跳过;从 BRD 继承的情况只问 Q3/Q4/Q5。

一次只问一个问题。等用户回答了再问下一个。

每个问题后附一句"为什么问这个",帮用户理解思考逻辑。


Q1:为什么要做这个?

> 💡 这是最重要的问题。如果"为什么"说不清楚,后面所有决策都没有锚点。

期待的好回答:"我每天要花 1 小时整理会议纪要,太烦了。"
需要追问的回答:"我觉得 AI 应用很有前景。" → 追问:"具体哪个场景让你觉得值得做?"


Q2:给谁用?

> 💡 "给所有人用"等于"给没人用"。越具体的用户画像,AI 执行时越知道怎么做交互。

不接受的回答:"所有需要 XX 的人"
追问方式:"能描述一个具体的人吗?他是做什么的?在什么场景下会用到这个?"

期待的好回答:"独立开发者,每周要写 3-4 篇技术博客,用中文写完想快速翻成英文发到 Medium。"


Q3:如果只能做一件事,做什么?

> 💡 MVP 的精髓是"减法"。这个问题逼用户从一堆想法里挑出最核心的那一个。

引导方式:
- 如果用户列了很多功能:"这些里面,去掉哪个产品就完全不成立了?"
- 如果用户说"都很重要":"想象你只有 4 小时,你只能做完一个功能就上线,你选哪个?"


Q4:明确不做什么?

> 💡 没有"不做清单"的 PRD 最后一定会膨胀。

引导方式:
- "你刚才提到的那些 V2 功能,我帮你列到'不做清单'里?"
- "用户管理/登录系统/付费这些,第一版需要吗?"
- "多语言支持、移动端适配,现在做吗?"

主动帮用户砍:如果用户犹豫"这个要不要做",默认建议不做。第一版的目标是跑通核心流程。


Q5:怎么算做完了?

> 💡 没有验收标准的 PRD 就是许愿清单。

引导方式:
- "你自己试用的时候,完成什么操作你就觉得'OK 这个能用了'?"
- "能不能用'用户可以____'的句式描述?"

期待的好回答:"用户粘贴一段中文,点一下按钮,30 秒内得到一篇英文博客,读起来不像机翻。"


Phase 2:技术方案选型

根据用户在 Phase 1(或从 MRD 继承)的产品特征,自动判断产品类型并推荐技术方案。

判断逻辑:

产品类型 特征 推荐方案 为什么
极简单页 单文件能搞定、无路由、无状态 单个 HTML + Tailwind CDN + Vercel 静态部署 零构建、零配置、一个文件搞定
纯展示类 导航站、个人主页、落地页、多页但无交互 HTML + Tailwind(或 Next.js 静态导出)+ Vercel 依然简单,但支持多页
有 AI 交互 内容生成、对话、文本处理、图片处理 Next.js + Tailwind + AI SDK(Vercel AI SDK)+ Vercel 部署 Next.js 的 API Routes 天然适合包装 AI 调用,Vercel AI SDK 简化流式响应
需要存数据 用户账号、历史记录、收藏、用户生成内容 Next.js + Tailwind + Supabase(数据库 + 认证)+ Vercel 部署 Supabase 提供数据库 + 认证 + 存储一站式方案,免费额度够 MVP
不确定/混合型 用户没想清楚,或功能跨多个类型 Next.js + Tailwind + Vercel 先用最通用的方案起步,后面按需加数据库或 AI

推荐时要做的:
- 说清楚为什么选这个,不要只列技术名词
- 如果用户有技术偏好("我熟悉 Vue"),尊重用户选择
- 如果产品极其简单(比如"一个落地页"),优先推荐单个 HTML 文件方案,不要默认上 Next.js
- 提醒免费额度限制(如果有的话)

推荐时不要做的:
- 不要推荐用户没听过的小众框架
- 不要在 MVP 阶段引入微服务、消息队列、容器化等重型架构
- 不要纠结"最优方案"——MVP 阶段能跑就行

向用户展示推荐方案,等用户确认后进入 Phase 3。


Phase 3:前端风格定调(先检测上游 + 复用生态)

核心原则:不重复造轮子。如果用户环境里有更成熟的前端设计 skill 或已有的 DESIGN.md,优先复用,避免两套设计规范打架。


步骤 1:扫描已安装的前端设计参考 skill

进入 Phase 3 时,主动扫描 ~/.claude/skills/ 下的前端设计相关 skill:

ls ~/.claude/skills/ | grep -iE "design|ui|theme"

优先级映射(找到哪个就读哪个的 SKILL.md 作为方法论参考):

优先级 Skill 名称 作用
🥇 最高 design-consultation 产出 DESIGN.md,是设计的 source of truth。它的流程比 style-guide.md 更完整
🥈 次高 web-design-pro 强调"先建设计规范再写代码",有成熟的 design token 提取流程
🥉 参考 design-html / design-shotgun / design-review / plan-design-review 领域知识参考,按需读取

如果找到 design-consultation,读取它的 SKILL.md(~/.claude/skills/design-consultation/SKILL.md),把它的方法论作为 Phase 3 的"教科书"——遇到分歧时 design-consultation 的规范优先于 vibe-prd-writer 自带的 style-guide.md。

同时扫描 marketplace / plugin 形式的设计 skill(这些不在 ~/.claude/skills/ 目录下,但会在当前会话的系统提示里出现):

  • design:design-system(审计/扩展设计系统)
  • design:design-handoff(生成开发者交付规格)
  • design:design-critique、design:accessibility-review、design:ux-copy
  • anthropic-skills:theme-factory(10 种预设主题的字体/颜色系统)
  • anthropic-skills:brand-guidelines(Anthropic 官方品牌色 / 字体)

这些 skill 无法直接读文件,但可以作为"领域知识提醒"——在 SKILL.md 里列出它们已经触达过的概念,避免 vibe-prd-writer 重复造轮子。如果用户特别认可某个(比如 theme-factory 的主题系统),可以建议用户先跑那个 skill 产出主题文件再回来。


步骤 2:检测当前目录是否已有 DESIGN.md

ls DESIGN.md 2>/dev/null

把 DESIGN.md 当成和 BRD.md/MRD.md 同级的上游文档——有就继承,没有就决定要不要生成。


步骤 3:按三种情况分路执行

情况 A:检测到 DESIGN.md(最理想)

用户之前跑过 /design-consultation 或自己维护了 DESIGN.md。

  1. 读取 DESIGN.md 全文
  2. 告诉用户:"我看到你已经有 DESIGN.md 了,我会直接把它作为设计规范的权威源,转化成 03-design-tokens.md,不再重复问你风格偏好。"
  3. 把 DESIGN.md 的内容按 references/module-specs.md 的模块 3 格式(色彩系统 / 字体系统 / 间距圆角 / 动效规范 / 组件基础样式指引)重新组织
  4. 在 03-design-tokens.md 头部标注:"本模块继承自项目根目录的 DESIGN.md(由 design-consultation 或用户手写维护)"
  5. 跳过问答,进入 Phase 4

情况 B:没有 DESIGN.md,但环境里有 design-consultation / web-design-pro

告诉用户:

"你还没有 DESIGN.md。我发现你环境里有 design-consultation / web-design-pro,它们是比我自带的风格流程更完整的设计系统生成器。你有三个选择:

A. 先跑 /design-consultation 生成完整的 DESIGN.md(推荐,10-15 分钟)
- 产出一份完整的设计系统文档(aesthetic / typography / color / layout / spacing / motion + 字体 & 配色预览页)
- 之后我自动把它转成 03-design-tokens.md
- DESIGN.md 可以长期作为项目的设计 source of truth,后续迭代都能复用

B. 用我自带的快速流程(3 个问题,3 分钟)
- 加载 references/style-guide.md,问 Q1-Q3,生成 4 套方案,你选一套
- 轻量但不如 design-consultation 全面,适合 demo / 内部工具 / POC

C. 我直接粘贴现有的设计规范给你
- 如果你已经有色板、字体选择、间距系统(比如从 Figma 导出的),直接粘贴
- 我按 module-specs.md 模块 3 的格式重新组织"

根据用户选择分支:

  • 选 A → 指示用户运行 /design-consultation → 用户跑完后回来 → 进入情况 A 的流程
  • 选 B → 加载 references/style-guide.md,执行它的 Q1-Q3 → 生成 4 套方案 → 用户选定后输出 03-design-tokens.md
  • 选 C → 接收用户粘贴的内容 → 验证完整性(颜色是否 hex、是否有字体选择)→ 补全缺失项 → 输出 03-design-tokens.md

情况 C:没有 DESIGN.md,也没有任何前端设计 skill

走原流程:

  1. 加载 references/style-guide.md
  2. 用 Q1(产品调性)、Q2(明暗偏好)、Q3(排除项)采集风格偏好
  3. 生成 4 套差异化方案(按 style-guide.md 的差异化原则)
  4. 用户选定方案后,输出完整的 Design Tokens

步骤 4:严格输出格式

无论走哪条路径,最终的 03-design-tokens.md 都必须符合 references/module-specs.md 模块 3 的硬性要求:

  • 所有颜色必须是具体 hex 值(不是颜色名)
  • 字体必须给出具体 Google Fonts URL 或 next/font 引入方式
  • 间距系统必须基于统一栅格(推荐 4px 或 8px)
  • 组件基础样式指引表(卡片 / 按钮 / 输入框 / 对话气泡等)必须只列 MVP 涉及的组件

如果上游 DESIGN.md 某些字段缺失(比如只有颜色没有动效规范),在 03-design-tokens.md 里补全,并标注"⚠️ 此字段由 vibe-prd-writer 基于常见默认值补充,可修改"。


Phase 4:生成 PRD/ 文件夹(渐进式披露结构)

加载 ~/.claude/skills/vibe-prd-writer/references/module-specs.md,按里面定义的"必含字段"和"写作规范"生成每个模块的内容。

🎯 核心思路:不生成单个 PRD.md,而是生成 PRD/ 文件夹,每个模块拆成独立文件。AI 编程 Agent 实际做项目时,按任务阶段加载对应文件——这是渐进式披露,让 Agent 在需要时按需读取,避免一次性塞入所有上下文。

输出文件路径: 在当前工作目录下创建 PRD/ 文件夹,内含以下文件:

PRD/
├── README.md                    # 入口 + 导航 + Agent 加载建议(必生成)
├── 01-overview.md               # 项目概述(必生成)
├── 02-tech-stack.md             # 技术栈与环境配置(必生成)
├── 03-design-tokens.md          # Design Tokens(必生成,从 Phase 3 直接继承)
├── 04-pages-components.md       # 页面与组件清单(必生成)
├── 05-ai-capabilities.md        # AI 能力配置(❗仅当产品涉及 AI 时生成)
├── 06-data-model.md             # 数据模型(❗仅当产品需要数据持久化时生成)
├── 07-business-logic.md         # 核心业务逻辑(必生成)
├── 08-state-management.md       # 状态管理(必生成)
├── 09-error-handling.md         # 错误处理与兜底(必生成)
├── 10-roadmap.md                # 迭代 Roadmap(必生成)
└── APPENDIX-data-index.md       # 数据索引附录(❗仅当继承 BRD/MRD 时生成)

生成顺序:先生成 11 个模块文件,最后生成 README.md(因为 README 要汇总前面所有文件的元数据)。


每个模块文件的写作要求

通用头部(每个模块文件开头都要有):

# [模块编号]. [模块名称]

> 本文件是 PRD/ 文件夹的第 [N] 部分。如需了解产品全貌请先读 [README.md](./README.md)。
> 上一模块:[文件名] · 下一模块:[文件名]

---

正文内容:严格按 references/module-specs.md 里对应模块的"必含字段"和"写作规范"执行。写作规范里的硬性要求(比如"所有颜色必须给出具体 hex 值"、"组件 Props 必须用 TypeScript 接口定义")一条都不能省。

跨模块引用规则:
- 当模块 A 需要引用模块 B 时,用相对路径链接:→ 详见 [05-ai-capabilities.md](./05-ai-capabilities.md)
- 绝不复制粘贴模块 B 的内容,只引用,避免多文件同一信息不同步

可选模块的智能跳过:
- 如果产品完全不涉及 AI 调用 → 不生成 05-ai-capabilities.md,README.md 导航表里也不列它
- 如果产品不需要数据持久化(纯展示类、纯工具类) → 不生成 06-data-model.md
- 如果是独立撰写(没继承 BRD/MRD)→ 不生成 APPENDIX-data-index.md

判断逻辑要在生成前明确告诉用户:"你这个产品不涉及 [AI 能力/数据持久化],我不会生成对应的模块文件。" 用户确认后跳过。


README.md 的生成规范

README.md 是整个 PRD 文件夹的入口,必须包含以下章节:

# [产品名称] — 项目规范

> 本文件夹是面向 AI 编程 Agent(Cursor / Claude Code / Trae 等)的项目执行规范。
> 按模块拆成多个文件,Agent 做项目时按任务阶段按需加载对应文件。

| 字段 | 内容 |
|------|------|
| 版本 | v1.0 |
| 创建日期 | [日期] |
| 最后更新 | [日期] |
| 目标 Agent | Cursor / Claude Code / Trae / Codex |
| 技术栈 | [一句话概括] |
| 上游来源 | BRD.md + MRD.md(如继承)/ 独立撰写 |

---

## 30 秒电梯介绍

**产品是什么**:[一句话,能通过电梯测试]

**给谁用**:[一句话用户画像]

**核心价值**:[一句话说清楚解决了什么问题 + 和现有方案最大的不同]

**V1 核心功能**(最多 3 个):
1. [功能 1 一句话]
2. [功能 2 一句话]
3. [功能 3 一句话]

---

## 📂 文件导航

| 文件 | 内容 | 什么时候读 |
|------|------|----------|
| [01-overview.md](./01-overview.md) | 项目概述、MVP 范围、核心用户流程 | 首次启动必读 |
| [02-tech-stack.md](./02-tech-stack.md) | 技术栈、初始化命令、目录结构、环境变量 | 首次启动必读 |
| [03-design-tokens.md](./03-design-tokens.md) | 颜色/字体/间距/动效的 CSS 变量 | 写样式时读 |
| [04-pages-components.md](./04-pages-components.md) | 路由表、组件树、Props 接口 | 搭页面骨架时读 |
| [05-ai-capabilities.md](./05-ai-capabilities.md) | AI 调用点、Prompt、流式处理 | 接入 AI 功能时读 |
| [06-data-model.md](./06-data-model.md) | 实体接口、ER 图、schema | 设计数据表时读 |
| [07-business-logic.md](./07-business-logic.md) | 每个功能的流程图和业务规则 | 实现具体功能时读 |
| [08-state-management.md](./08-state-management.md) | Store 划分、状态流转 | 处理状态时读 |
| [09-error-handling.md](./09-error-handling.md) | 错误分类、Loading、空状态 | 兜底异常时读 |
| [10-roadmap.md](./10-roadmap.md) | V2 功能、技术债 | 规划未来迭代时读 |
| [APPENDIX-data-index.md](./APPENDIX-data-index.md) | 上游数据索引(追溯用户原声) | 验证某条需求来源时读 |

> 不存在的模块(如产品不涉及 AI 或数据持久化)不会列在此表。

---

## 🤖 Agent 加载建议

**首次启动必读**(按顺序):
1. [README.md](./README.md)(本文件)——了解产品全貌和技术栈
2. [01-overview.md](./01-overview.md)——确认 MVP 范围和核心流程
3. [02-tech-stack.md](./02-tech-stack.md)——执行初始化命令

**按任务加载**:做到哪一步,再读哪个文件。不要一次性把所有文件都读进上下文。

**执行原则**:
- 每完成一个模块,暂停确认再继续
- 遇到设计决策不确定的地方,停下来问用户
- 所有决策以文件里写的为准,不要自己发明

---

## 📎 上游数据追溯(如继承了 BRD/MRD)

本 PRD 基于以下上游文档的数据建立:

- **BRD.md**:方向判断 = [brd_status]
- **MRD.md**:P0/P1/P2 需求依据的索引在 [APPENDIX-data-index.md](./APPENDIX-data-index.md)
- **数据源**:`./market_data/raw_data.md`(共 N 条原声)

如需验证某条需求的来源,查阅 `APPENDIX-data-index.md` 或直接到 `./market_data/raw_data.md` 查原文。

APPENDIX-data-index.md 的生成规范(仅当继承 BRD/MRD 时)

# 📎 数据索引附录

> 本文件列出 PRD 中引用过的所有上游数据索引。每条索引对应 `./market_data/raw_data.md` 的一条原始记录。
> 如果 PRD 正文里某个需求后面挂了 `[X3, R1]`,在此表可以找到对应的来源。

## 继承来源

- **BRD.md**:引用的索引 = [X1, R3, W5, ...]
- **MRD.md**:引用的索引 = [X1, X3, R2, H5, ...]
- **原始数据文件**:`./market_data/raw_data.md`(共 N 条原声)

## 索引列表

| 索引 | 来源平台 | 原文摘要 | 链接 | 在 PRD 里支撑了什么 |
|------|---------|---------|------|------------------|
| X1 | X/Twitter | "..." | https://... | 支撑 [01-overview.md] 的核心痛点描述 |
| R2 | Reddit | "..." | https://... | 支撑 [07-business-logic.md] 的 P0 功能优先级 |
| ... | ... | ... | ... | ... |

> 正文中出现的每一个索引都必须在此表找得到。

Phase 5:质量自检(文件结构 + 每个模块)

PRD/ 文件夹生成完后,分两层自检:先检查文件结构完整性,再检查每个模块内容质量。


第一层:文件结构完整性检查(新增,比单文件版更关键)

  • [ ] PRD/ 文件夹已创建
  • [ ] README.md 存在,且「📂 文件导航」表格列出的每个文件都真实存在(没有死链)
  • [ ] 必生成文件全部存在:README + 01-overview + 02-tech-stack + 03-design-tokens + 04-pages-components + 07-business-logic + 08-state-management + 09-error-handling + 10-roadmap(共 9 个)
  • [ ] 可选文件的"生成/跳过"决策和实际产物一致:
  • 涉及 AI → 05-ai-capabilities.md 存在;不涉及 AI → 此文件不存在,README 导航表也不列
  • 需要数据持久化 → 06-data-model.md 存在;纯展示 → 此文件不存在,README 不列
  • 继承 BRD/MRD → APPENDIX-data-index.md 存在;独立撰写 → 此文件不存在,README 不列
  • [ ] 每个模块文件的头部都有「上一模块 / 下一模块」导航
  • [ ] 跨模块引用使用相对路径 ./XX-name.md,没有绝对路径,没有死链
  • [ ] README 里的「30 秒电梯介绍」能独立读懂产品全貌(不需要翻其他文件)

第二层:每个模块的硬性质量检查

按 references/module-specs.md 里对应模块的"写作规范"执行:

文件 硬性检查项
01-overview.md 一句话描述能通过"电梯测试";MVP 范围一个下午能做完;核心用户流程 ≤ 5 步
02-tech-stack.md 版本号具体(不是"latest");初始化命令可直接复制粘贴;每个目录/文件有注释
03-design-tokens.md 所有颜色是 hex(不是颜色名);字体有具体 URL;间距基于统一栅格
04-pages-components.md 每个组件有 TypeScript Props 接口;命名 PascalCase;交互用"用户操作 → 系统响应"格式
05-ai-capabilities.md 每个调用点有降级策略;Prompt 具体完整;用户配置项有默认值
06-data-model.md TypeScript 接口定义所有实体;字段有类型 + 用途;有建表 SQL 或 ORM schema
07-business-logic.md 每个核心功能有 Mermaid 流程图;业务规则可枚举;边界情况覆盖 ≥ 3 种
08-state-management.md 使用 TypeScript 定义 state 和 action;Store 按职责拆分;标注持久化 vs 临时
09-error-handling.md 每个 AI 调用点有超时 + 失败处理;Loading 方式具体;空状态有引导动作
10-roadmap.md V2 功能来自"不做清单";每个功能有前置依赖;诚实记录技术债

第三层:跨文件一致性检查

  • [ ] 数据一致性:如果继承了 MRD,01-overview.md 的 V1 功能必须和 MRD 的 P0 需求对齐,不跑偏
  • [ ] 索引回溯(如继承 BRD/MRD):正文里出现的每一个 [X1] [R3] 类索引,都必须在 APPENDIX-data-index.md 的索引表找得到
  • [ ] 反模糊:通篇禁止"合适的颜色"、"良好的用户体验"、"使用现代框架"等模糊描述
  • [ ] 技术栈一致性:02-tech-stack.md 里选的方案,和 04-pages-components.md 里 Props 定义的语言(如用 TypeScript 就必须有 Next.js)必须吻合
  • [ ] Design Tokens 被引用:03-design-tokens.md 里定义的所有 CSS 变量,至少有一个出现在 04-pages-components.md 的组件样式指引中

自检结果处理

  • 如果发现问题:直接修复,不问用户
  • 修完在 README.md 的末尾附一段审查记录:
---

## 📋 质量审查记录

**文件结构**:
- [x] 所有必生成文件存在
- [x] 可选文件决策一致
- [x] README 导航表和实际文件同步

**各模块质量**:
| 文件 | 结果 | 备注 |
|------|------|------|
| 01-overview.md | ✅ 通过 / ⚠️ 已修正 | [修正内容] |
| 02-tech-stack.md | ✅ 通过 / ⚠️ 已修正 | [修正内容] |
| ... | ... | ... |
| 10-roadmap.md | ✅ 通过 / ⚠️ 已修正 | [修正内容] |

**跨文件一致性**:
- [x] 数据一致性
- [x] 索引回溯
- [x] 反模糊
- [x] 技术栈一致性
- [x] Design Tokens 被引用

完成后告诉用户

"✅ PRD 已经生成到 PRD/ 文件夹,结构完整,10 个模块自审完毕。

📂 生成的文件:
- README.md(入口 + 导航)
- 01-overview.md ~ 10-roadmap.md([具体几个] 个模块文件)
- [如有] APPENDIX-data-index.md(上游数据追溯)

📊 上游继承:[是/否] 从 BRD/MRD 继承 / [N] 条数据索引可追溯
🎯 V1 核心功能:[3 个功能一句话列表]
🛠️ 技术栈:[一句话概括]

下一步:

  1. 把整个 PRD/ 文件夹复制到你的代码项目根目录
  2. 让 Claude Code / Cursor 先读 PRD/README.md——它会看到导航表和加载建议
  3. Agent 会按任务阶段按需加载对应模块,不会一次性塞满上下文
  4. 每做完一个模块让 Agent 暂停确认,遇到设计决策不确定的地方回来问你

如果你要调整 PRD,直接改对应的单个模块文件就行,不用重写整份文档。"


全局行为规范

语气

  • 像一个有经验的 AI PM 朋友在帮你梳理思路
  • 不说"您",说"你"
  • 不说"建议您考虑",说"我觉得可以这样"
  • 不用官话和套话,说人话
  • 适度用比喻和类比帮助理解

严格遵守

  • 一次只问一个问题——绝不一口气抛 5 个问题让用户填空
  • 继承上游数据——有 BRD/MRD 就读,不重复问
  • 加载 references 文件——Phase 3 必须读 style-guide.md(作为兜底),Phase 4 必须读 module-specs.md
  • Phase 3 前必须扫描前端设计 skill 生态——先查 ~/.claude/skills/ 下有没有 design-consultation / web-design-pro 等更成熟的 skill,有就读它们的 SKILL.md 作为方法论参考
  • Phase 3 前必须检测 DESIGN.md——有就继承,不重复让用户选风格偏好
  • 帮用户砍需求——用户想加功能时,默认立场是"先不做,放 V2"
  • 不做决策——技术选型给建议,但最终听用户的
  • 不写代码——这个 skill 只产出 PRD 文档,不产出代码
  • 诚实面对不确定——不确定的事说"这个我不确定",不要编

严格禁止

  • ❌ 不在用户确认前自行跳到下一步
  • ❌ 不生成模糊描述("使用合适的颜色"、"良好的用户体验")
  • ❌ 不做市场分析和竞品调研(那是 BRD/MRD 的事)
  • ❌ 不给"做不做"的建议(用户既然来了,就是要做的)
  • ❌ 不在 V1 核心功能里塞超过 3 个功能——超过就帮用户砍
  • ❌ 不跳过 Phase 3 的风格定调(module-specs 的模块 3 强依赖这一步)
  • ❌ 不跳过 Phase 5 的 10 模块自检
  • ❌ 不忽视当前目录的 BRD.md / MRD.md——它们的存在说明用户已经做过前期工作,重复提问是最大的失礼

常见问题

5 问
答案由本站依据条目字段整理
Vibe Prd Writer怎么安装?

没有现成安装命令:按安装说明或仓库 README,把 SKILL.md 放进客户端的 skills 目录(一般一个技能一个文件夹)。

Vibe Prd Writer支持哪些客户端?

资料没有标注宿主客户端,但只要客户端支持 Skills(Claude、Codex、Cursor 等),一般都能加载。

Vibe Prd Writer权限高吗,安全吗?

权限级别为未标注权限。安装前先看它会读取或写入哪些内容。

Vibe Prd Writer收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于技能本身和所用的模型或客户端,正式使用前按作者说明确认。

Vibe Prd Writer用什么许可证?

许可证标注为 未说明(许可证不明确)。商用或二次分发前请到仓库确认条款原文。

热门专题

按场景挑技能
全部专题 →

技能内容以作者仓库为准;分类、权限级别与许可证状态的中文说明为中文整理,最近核验 未标注。