prd-generator-from-prototype

SKILL.md

---
name: prd-generator-from-prototype
description: 读取产品原型图/页面描述，按预设模板自动生成标准PRD文档，完成后自检一致性，不扩展需求范围
---

# 1. 触发规则（When）
## Use this skill when
- 用户提供原型页面、需求描述，要求生成PRD
- 需要按固定模板输出结构化产品需求文档
- 需要限定需求范围、禁止自由扩展
- 需要对生成结果做一致性自检

## Do NOT use this skill when
- 仅做简单问答、不生成文档
- 没有提供原型/页面信息
- 需求是代码开发、接口开发、数据查询

# 2. 输入输出（Input / Output）
## Input
- prototype_text: string  # 原型页面描述/截图文字化
- prd_template: string    # 模板类型：business/analysis/list/form/auto（默认auto）
- scope: string           # 需求范围，只生成该范围内容（推荐：按“页面/模块/功能点”列出清单）
## Output
- 标准PRD文档（Markdown）
- 一致性自检报告（漏项、错配、范围外内容）

# 2.2 scope 推荐格式与解析规则（强制约束）
## 推荐格式（择一）
- 页面清单：列出允许覆盖的页面/弹窗/标签页名称（例如：“预算编制页、指标明细弹窗、导入结果页”）。
- 功能点清单：列出允许覆盖的动作与能力（例如：“查询、重置、导出、提交、驳回、权限可见性”）。
- 边界声明：明确不包含内容（例如：“不包含接口设计、不包含数仓口径重算、不包含移动端”）。

## 解析规则（必须执行）
- 仅当某条PRD内容满足以下任一条件时，才视为“范围内”：
  - 明确对应到 scope 中的页面/弹窗/标签页；或
  - 明确对应到 scope 中的功能点，并且发生在 scope 允许的页面内。
- 若 prototype_text 包含但 scope 未包含的页面/功能点：
  - 必须在“一致性自检报告-范围外内容”中列出，并拒绝将其展开成需求条目；
  - 仅允许以“待确认事项/开放问题”的方式提示用户补充 scope。
- 若 scope 过于笼统（例如仅写“按原型生成”/“全部功能”）：
  - 必须先输出“需补充信息清单”（见 2.3），在用户补齐前不得生成完整PRD正文（可生成目录骨架与占位）。

# 2.3 信息不足时的补问模板（最小必要集）
当出现以下任一情况时触发补问：未提供 scope；scope 不可判定边界；prototype_text 仅为截图但字段/按钮不可读；或 prd_template=auto 且无法判断业务类型。

输出格式必须为：
- 缺失信息：
  - （1）scope：请按“页面/弹窗/标签页清单 + 功能点清单 + 明确不包含内容”给出
  - （2）原型信息：请补充可读的字段/按钮/流程/权限说明（可直接粘贴截图文字化内容）
  - （3）模板偏好：business 或 analysis（不确定可选 auto）
- 在补齐前我将提供：
  - PRD目录骨架（按所选模板）
  - 已确认信息摘要（仅基于 prototype_text 可确定部分）

## scope 可复制填写示例（推荐直接按此格式回填）
请将下方占位符替换为你的实际范围（保持三行结构不变）：

- 页面/弹窗/标签页：<页面A>；<页面B>；<弹窗C>；<标签页D>
- 功能点：<查询>；<重置>；<导出>；<新增/编辑/删除>；<提交/驳回/退回>；<权限可见性>
- 不包含：<接口设计>；<数据库表结构>；<数仓口径重算>；<移动端>；<跨模块改造>

# 2.1 约束优先级（冲突裁决）
- 当模板示例与第6节书面语言输出规范发生冲突时，**以第6节为最高优先级**；模板仅作为结构参考，需随规范调整输出形式。
- 当用户输入与本Skill约束冲突（例如要求扩展范围、要求输出JSON响应示例代码块）时，必须拒绝冲突请求并给出合规替代方案（书面字段结构描述）。

# 3. 执行步骤（Steps）
1. 读取原型：提取页面结构、字段、按钮、流程、权限
2. 匹配模板：优先使用用户指定的模板，未指定时默认使用【通用模块PRD模板】。
3. 限定范围：只生成scope内内容，不新增无关模块
4. 生成PRD：按模板输出完整结构（必须遵循第6节书面语言规范）
5. 自检核对：对比原型与PRD，检查一致性、漏项、越界

# 4. 失败处理（On Failure）
- 无原型/无范围：返回错误并提示补充信息
- 模板不匹配：提示可选模板列表
- 自检不通过：列出问题并修正后再输出
- 超出范围：明确标注并拒绝生成

# 5. 模板引用（渐进式披露）
请从以下模板选择：
- 通用业务模块PRD模板（template_business.md）：遵循固定结构，包含需求背景、方案、菜单结构、通用规则、多标签页详细规则、技术实现说明，适用于所有数据分析类功能。
- 通用数据分析模块PRD模板（template_analysis.md）：遵循固定结构，包含需求背景、方案、菜单结构、通用规则、多标签页详细规则、技术实现说明，适用于所有数据分析类功能。
- prd_template 映射规则：
  - business：使用 template_business.md
  - analysis：使用 template_analysis.md
  - list：使用 template_business.md 中的“需求结构（标准章节）”，重点展开“查询条件/页面展示/按钮与操作/异常规则”
  - form：使用 template_business.md 中的“需求结构（标准章节）”，重点展开“字段定义/校验规则/按钮与操作/权限控制”
  - auto：若原型以图表/指标/统计口径为主，使用 analysis；否则使用 business

默认使用：通用模块PRD模板

# 6. 书面语言输出规范（强制约束）

生成PRD文档时**必须**严格遵循以下规范，违者视为自检不通过：

## 6.1 禁止事项
- **禁止使用emoji图标**：文档中不得出现任何emoji符号（如🎯📊📦👤📖✅❌等），包括标题前缀、表格标记、状态标识等位置
- **禁止使用Given-When-Then格式**：验收条件不得采用"Given...When...Then..."的BDD测试用例格式，应改为自然语言描述
- **禁止虚拟人设引用**：不得出现"John审阅""AI优化""助手建议"等字样，保持文档客观性
- **禁止口语化表达**：不得使用"咱们""搞定""OK""没问题"等口语词汇
- **禁止感叹号滥用**：仅在警告/错误提示文案中使用单个感叹号，正文叙述一律不用感叹号
- **禁止叙述性内容使用Markdown竖线表格**：指标、目标、规则、约束、需求说明、验收标准、术语定义、附录（权限矩阵/开放问题/风险事项/参考文档/截图索引）等叙述性内容，一律使用书面段落或编号列表描述，严禁使用`| 列 | 列 | ... |`格式的Markdown表格。此为强制性要求，违者视为自检不通过
- **禁止使用ASCII线框图及树形代码块**：页面布局、弹窗结构、界面原型等不得使用`┌─┐│└┘├┤┬┴┼═`等制表符绘制线框图；菜单层级、功能树、目录结构等不得使用`├──`/`│`等字符在代码块中绘制树形图。以上两类均须改为书面语言分层次描述其组成和层级关系
- **禁止API响应示例使用JSON代码块**：接口定义中的响应示例须使用书面语言描述字段结构和数据格式，严禁使用```json代码块展示示例数据。应说明返回数据的字段名称、数据类型、取值含义及示例值

## 6.2 文档结构规范
- 章节标题采用中文数字编号：一、二、三……
- 子节标题采用阿拉伯数字编号：1.1、1.2、1.3……
- 同级列表项采用中文序号：（一）（二）（三）……或 1. 2. 3.
- 表格必须有表头行，列名使用简明术语
- **图片直接嵌入对应功能章节**：界面截图、原型图等必须直接嵌入到对应功能章节的正文中（使用Markdown `![描述](路径)`语法），严禁将图片集中放置在附录的"截图索引"章节中。每个功能章节应在功能说明或页面结构描述后紧邻插入相关截图，确保图文对应

## 6.3 语言风格要求
- 使用正式书面语，如"旨在达成以下目标""其处理逻辑如下""具体说明如下"
- 业务规则统一采用"规则名称+触发时机+执行逻辑+例外处理"四段式结构
- 功能描述采用"功能说明+字段定义+业务规则+操作按钮"固定顺序
- 接口定义包含请求方式、路径、参数、响应示例、错误码五要素

## 6.4 表格使用边界与字段定义格式

**可保留表格的场景（仅限以下情况）：**
- 文档修订记录表（版本/日期/修订内容/状态）
- 数据库DDL级字段定义表（字段名/数据类型/长度/必填/默认值/索引/说明），用于开发建表参考
- API接口参数表（请求参数/响应结构/错误码定义），用于前后端联调

**禁止使用表格的场景（须转为书面语言）：**
- 成功衡量指标、建设目标、不包含范围 → 分段叙述或编号列表
- 功能模块列表、菜单架构 → 加粗编号列表
- 配置差异对比 → 连贯段落逐项对比
- 字段定义（业务层面）→ "名称(英文名)，类型，必填，默认值，校验，来源"的连贯句式
- 查询条件、列表列定义、操作按钮说明 → 分段书面描述
- 编辑约束、状态约束 → 叙述性段落
- 性能需求、安全需求 → 按维度分段叙述
- 验收标准 → "AC-编号 功能名：预期结果"的自然语言格式
- 术语定义 → "**术语**：定义。"的加粗格式
- 附录（截图索引/权限矩阵/开放问题/风险事项/参考文档）→ 书面段落

**附录内容扩展规范：**
- **UI设计规范附录**：允许在附录中补充配色方案、布局风格、组件规范等UI设计细节，以便保持界面一致性。示例：
  配色方案：达标状态使用绿色（#52c41a），未达标状态使用红色（#f5222d），警告状态使用橙色（#faad14），主色调使用蓝色（#1890ff）。
  布局风格：参考综合人车比V2.0的卡片式布局，采用上下分区结构。
- **开发建议附录**（可选）：作为独立附录章节，可提供开发计划建议、工时估算、风险提示等内容，但不得放在正文主体中。

**字段定义推荐格式示例：**

> 录入人员（operator_name），只读文本类型，必填，默认值为当前登录用户，不可修改，数据来源于系统会话，用于标识数据录入者身份。
>
> 合计金额（total_amount），数字输入类型，必填，默认值为0，校验规则为大于0，始终显示。

**伪代码和代码块：**
- 仅允许用于伪代码/公式/枚举清单等非数据示例内容；**接口响应示例不得使用JSON代码块**，页面/弹窗布局不得使用ASCII线框图或树形代码块，应改为书面层次描述。
- **业务计算公式展示**：允许使用代码块展示业务逻辑计算公式（如序时进度标准计算、达成率计算等），以便开发人员准确理解业务规则。示例：
  ```
  月度序时标准 = 50000 ÷ 12 = 4166.67 公里/月
  N月序时进度标准 = 4166.67 × N 公里
  达成率 = 当前累计里程 ÷ 序时进度标准 × 100%
  ```

**页面/弹窗布局描述格式（替代ASCII线框图）：**

> 根据截图（图X），[页面/弹窗]采用[整体布局方式]（如左右分区/上下分区/居中模态对话框），各区域组成如下：
>
> [整体框架说明，如标题栏、标签页位置]
>
> [第一区域]为[区域名称]，包含以下内容：[字段列表或功能说明]。
>
> [第二区域]分为[X]部分。[子区域A][描述]。[子区域B][描述]。
>
> [底部操作区]排列以下按钮：[按钮名1]（功能）、[按钮名2]（功能）。