Communitygithub.com

通用产品与技术要求文档生成器

通过交互式两步工作流,生成包含可视化 Mermaid 图表的完整产品和技术需求文档(PRD-Project)。当用户要求创建 PRD、规划任何软件/网页/移动端/AI/游戏项目、编写规格说明或设计系统架构时使用。

通用产品与技术要求文档生成器 是什么?

该技能是一个全面的产品需求文档(PRD)生成器,旨在将任何项目创意转化为结构化的、可直接用于开发的 PRD.md 文件。它适用于 Claude Code 等 AI 编码代理,支持网页、移动应用、SaaS、AI Agent、游戏和企业系统等多种项目类型。工作流分为两个步骤:首先,它会分析用户提示,并自动提出 4 到 5 个高度相关的问题(例如,核心目标、领域特定机制、MVP 范围、技术偏好),以澄清细节,除非用户跳过提问。然后,在获得答案后,它会根据项目类型生成包含 7 个部分的 PRD 文档,包括概述、需求、核心特性、用户流程(含 Mermaid 流程图)、架构(含系统图和文件夹结构)、数据库架构(适用于后端/前端项目)以及技术栈建议。该技能强调实用性,生成具体的、可操作且无冗余的规范,并内置了 Mermaid 图表生成规则以确保语法正确。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/chandrapratamalab/phantom-skill/tree/HEAD/skills/prd-writer

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

通用 PRD 编写器

将任何项目创意转化为完整的、可直接用于开发的产品和技术需求文档(PRD.md)。

工作流

步骤 1:分析提示并提问动态澄清问题

除非用户明确表示“直接生成”/“跳过问题”或已提供完整细节,否则不要在第一次交互时生成完整 PRD。

  1. 检测项目类型: 从用户的提示中识别他们正在构建的内容(例如,3D/动态网站、SaaS/网页应用、移动应用、AI Agent/机器人、游戏、CLI/插件或企业系统)。
  2. 提出 4 到 5 个高度相关的问题: 严格根据特定项目领域定制问题:
    • 询问核心目标/目标用户以及预期的最终操作。
    • 询问领域特定机制(例如,动态页面的 3D/滚动交互;SaaS 的用户角色和支付流程;机器人的触发/API 流程;游戏的游戏循环)。
    • 询问MVP 范围边界和技术/库偏好或设备限制。
  3. 提供快速示例: 在每个问题后面包含简短选项(放在括号中),以便用户可以快速回复,并提醒他们:“回答您已经想到的要点,或键入 '直接生成' 以便我自动为您选择最佳选项。”

步骤 2:生成 7 节 PRD-Project

一旦用户回答(或要求立即继续),将输出保存到 PRD.md(如果位于代码工作区中),并按照以下精确的 7 节结构呈现文档,根据项目类型动态调整技术内容:

# PRD-Project: [项目名称]
## 需求文档

### 1. 概述
- **产品摘要:** 概念、解决的核心问题以及独特的价值主张。
- **目标受众与用户画像:** 用户角色、目标和痛点。
- **目标与成功指标:** 适合项目的可衡量的 KPI(例如,转化率、FPS/加载速度、留存率或任务准确率)。

### 2. 需求
- **功能需求:** 按角色、模块或屏幕部分逻辑分组的核心能力。
- **非功能需求:** 性能基准、响应能力、安全性、兼容性和资源限制。
- **范围外(第一阶段):** 有意排除在初始版本之外的功能。

### 3. 核心特性
对于每个特性/模块,请指定:
- **优先级:** P0(必须拥有)、P1(应该拥有)、P2(最好拥有)。
- **用户故事:** 作为[角色],我想要[操作],以便[收益]。
- **验收标准:** 具体的、可测试的通过/失败条件。
- **边缘情况与回退:** 处理错误、空状态、弱设备/不受支持的浏览器或失败的请求。

### 4. 用户流程
- **逐步旅程:** 从开始到结束的按时间顺序的用户或系统交互路径。
- **可视化流程图:** 渲染一个简洁的 `mermaid` 图(`flowchart TD` 或 `sequenceDiagram`)。

### 5. 架构
- **系统与文件夹结构:** 高级组件交互和推荐的目录布局。
- **架构图:** 渲染一个 `mermaid` 图,展示 UI、逻辑、API、渲染循环或外部服务如何连接。
- **核心模块/端点:** 关键路由、控制器或事件处理器的表格。

### 6. 数据库架构(根据项目类型自适应)
- **如果是有后端的/持久化应用:** 提供 Mermaid `erDiagram` 和表架构(字段、类型、主键/外键约束、关系)。
- **如果是纯前端/静态/3D/CLI/工具:** 定义本地状态架构、配置 JSON 结构、资产清单或表单/事件负载架构,而不是 SQL 表。

### 7. 技术栈
根据用户的约束(前端/UI、逻辑/后端、数据/资产、部署),推荐最佳工具并附带简短理由。

图表与质量规则

  • 仅限有效的 Mermaid: 始终使用双引号包裹包含空格、括号或符号的节点标签(例如,A["英雄区域 (3D 视图)"] --> B["滚动触发器"]),以便图表能够无语法错误地清晰渲染。
  • 零冗余: 保持规范具体、可操作,并可直接供开发人员或 AI 编码代理实施。

相关技能