prd-manager

一个辅助 Vibe Coding 的 Skill 工具，通过生成结构化的版本需求文档，来指导 AI 进行 Coding ，提升 Coding 的准确性。

事前确认流程

默认按以下顺序推进：

prd.md（确认） → design.md / dev.md（确认） → plan.md → docs/prd/README.md

其中：

• prd.md 生成后需要用户确认，再进入设计和技术文档阶段
• dev.md 生成后需要再次确认，再输出开发计划
• plan.md 只负责排期、任务、风险，不重复技术实现内容

能力范围

• 生成模式：从零产出完整项目文档链路，覆盖 prd.md、design.md、plan.md、dev.md
• 管理模式：维护已有 docs/prd/<version>/ 文档，支持查看、扩展、对比、搜索、归档
• 索引维护：同步更新 docs/prd/README.md，保持版本摘要倒序展示

安装方式

如果你通过 Skill 目录安装，可参考：

git clone https://github.com/kociii/prd-manager ~/.claude/skills/prd-manager

适用场景

• 从零建文档：为新项目或新版本初始化完整 PRD 文档链路
• 增量补需求：在已有版本中新增需求，并同步补充设计、计划或技术文档
• 版本治理：查看版本状态、维护摘要索引、归档旧版本
• 版本对比：对比不同版本之间的需求、优先级和计划变化
• 跨版本检索：按主题搜索历史需求，如认证、支付、通知
• 前后端协作：让 prd.md、design.md、plan.md、dev.md 各自聚焦单一职责

确认输出边界

文档	关注点
prd.md	做什么、为什么：功能需求、用户故事、验收标准、业务目标
design.md	长什么样：页面结构、交互流程、组件清单、ASCII 原型
plan.md	何时做、谁来做：任务拆解、时间线、里程碑、风险
dev.md	如何实现：技术架构、数据模型、接口影响、文件变更

该 Skill 强调文档边界明确：

• 不把技术方案写进 prd.md
• 不把用户故事写进 dev.md
• 不把数据模型和接口定义写进 plan.md

这也是该 Skill 最重要的约束：每份文档只回答一个问题。

项目类型适配

• 前端项目：design.md 为必含文档，重点描述页面结构、交互和组件设计
• 后端项目：dev.md 为核心文档，需包含接口影响清单
• 涉及数据库变更：应额外输出独立 SQL 文件，如 sql/DDL.sql 与 sql/DML_init.sql

输入示例

你可以把它当成一个“帮你把需求整理清楚”的工具来用。描述越具体，它越能把零散想法整理成结构化输出。

• /prd-manager 我这边想做一个 v0.3.0 的用户认证版本，你先帮我把需求整理成结构化 PRD。场景是一个后台管理系统，用户分普通员工和管理员；我现在明确想到的功能有账号密码登录、短信验证码登录、注册、找回密码、首次登录强制改密、异常登录提醒；P0 先保证登录注册闭环，P1 再补安全设置和登录风控。
• /prd-manager 我现在脑子里只有一个大方向，想做会员订阅功能，你帮我先把需求梳理清楚，只输出 prd.md 就行。这个功能主要面向 C 端用户，要包含套餐展示、试用、开通会员、续费提醒、自动续费关闭、退款规则、权益说明；目标是提升付费转化，所以也请顺手把成功指标和验收标准整理出来。
• 我想用 prd-manager 给 v0.2.4 加一个“视频播放器”需求，但我现在说得比较散。这个播放器主要用在课程详情页，用户是付费学员，至少要支持倍速、清晰度切换、字幕、播放记录、断点续播、试看限制；你帮我按场景、用户、功能、优先级整理一下，再告诉我要不要补 design.md 和 dev.md。
• /prd-manager 帮我看看当前项目所有 PRD 版本现在分别是什么状态。除了列版本号，我还想知道每个版本的目标是什么、已经有哪些文档、还缺哪些关键文档，帮我整理成一眼能看懂的摘要。
• 用 prd-manager 帮我对比一下 v0.2.0 和 v0.3.0，我不想看原始 diff。我更想知道这两个版本到底业务上增加了什么需求、删掉了什么、哪些优先级变了、开发计划哪里有变化，最后再帮我总结一句这次版本升级的重点。
• /prd-manager 帮我把所有版本里跟认证相关的内容都找出来。我不仅要文件列表，还想让你顺手整理一下：哪些版本已经覆盖登录、注册、找回密码、权限控制，哪些版本只做了一部分，哪些地方还缺。
• 我准备把 v0.1.0 收起来，用 prd-manager 先帮我检查这个版本的文档是不是整理完整了。比如 prd、plan、design、dev 有没有缺，README 索引有没有同步，确认没问题以后再帮我归档。

目录

.
├── SKILL.md
├── assets/
│   ├── prd_template.md
│   ├── design_template.md
│   ├── plan_template.md
│   ├── dev_template.md
│   └── readme_template.md
├── references/
├── agents/
└── evals/

能力验证

evals/evals.json 已覆盖该 Skill 的核心场景，包括：

• 新建版本
• 初始化缺失的 docs/prd/
• 版本冲突检测
• 按需只生成单个文档
• 查看版本状态
• 扩展已有版本
• 对比版本差异
• 搜索需求
• 归档版本

许可证

MIT，详见 LICENSE。