← Back to Skills Marketplace
rosscui-chy

prd-generator-from-prototype

by rosscui-chy · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
39
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install prd-generator-from-prototype
Description
读取产品原型图/页面描述,按预设模板自动生成标准PRD文档,完成后自检一致性,不扩展需求范围
README (SKILL.md)

\r \r

1. 触发规则(When)\r

Use this skill when\r

  • 用户提供原型页面、需求描述,要求生成PRD\r
  • 需要按固定模板输出结构化产品需求文档\r
  • 需要限定需求范围、禁止自由扩展\r
  • 需要对生成结果做一致性自检\r \r

Do NOT use this skill when\r

  • 仅做简单问答、不生成文档\r
  • 没有提供原型/页面信息\r
  • 需求是代码开发、接口开发、数据查询\r \r

2. 输入输出(Input / Output)\r

Input\r

  • prototype_text: string # 原型页面描述/截图文字化\r
  • prd_template: string # 模板类型:business/analysis/list/form/auto(默认auto)\r
  • scope: string # 需求范围,只生成该范围内容(推荐:按“页面/模块/功能点”列出清单)\r

Output\r

  • 标准PRD文档(Markdown)\r
  • 一致性自检报告(漏项、错配、范围外内容)\r \r

2.2 scope 推荐格式与解析规则(强制约束)\r

推荐格式(择一)\r

  • 页面清单:列出允许覆盖的页面/弹窗/标签页名称(例如:“预算编制页、指标明细弹窗、导入结果页”)。\r
  • 功能点清单:列出允许覆盖的动作与能力(例如:“查询、重置、导出、提交、驳回、权限可见性”)。\r
  • 边界声明:明确不包含内容(例如:“不包含接口设计、不包含数仓口径重算、不包含移动端”)。\r \r

解析规则(必须执行)\r

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

2.3 信息不足时的补问模板(最小必要集)\r

当出现以下任一情况时触发补问:未提供 scope;scope 不可判定边界;prototype_text 仅为截图但字段/按钮不可读;或 prd_template=auto 且无法判断业务类型。\r \r 输出格式必须为:\r

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

scope 可复制填写示例(推荐直接按此格式回填)\r

请将下方占位符替换为你的实际范围(保持三行结构不变):\r \r

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

2.1 约束优先级(冲突裁决)\r

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

3. 执行步骤(Steps)\r

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

4. 失败处理(On Failure)\r

  • 无原型/无范围:返回错误并提示补充信息\r
  • 模板不匹配:提示可选模板列表\r
  • 自检不通过:列出问题并修正后再输出\r
  • 超出范围:明确标注并拒绝生成\r \r

5. 模板引用(渐进式披露)\r

请从以下模板选择:\r

  • 通用业务模块PRD模板(template_business.md):遵循固定结构,包含需求背景、方案、菜单结构、通用规则、多标签页详细规则、技术实现说明,适用于所有数据分析类功能。\r
  • 通用数据分析模块PRD模板(template_analysis.md):遵循固定结构,包含需求背景、方案、菜单结构、通用规则、多标签页详细规则、技术实现说明,适用于所有数据分析类功能。\r
  • prd_template 映射规则:\r
    • business:使用 template_business.md\r
    • analysis:使用 template_analysis.md\r
    • list:使用 template_business.md 中的“需求结构(标准章节)”,重点展开“查询条件/页面展示/按钮与操作/异常规则”\r
    • form:使用 template_business.md 中的“需求结构(标准章节)”,重点展开“字段定义/校验规则/按钮与操作/权限控制”\r
    • auto:若原型以图表/指标/统计口径为主,使用 analysis;否则使用 business\r \r 默认使用:通用模块PRD模板\r \r

6. 书面语言输出规范(强制约束)\r

\r 生成PRD文档时必须严格遵循以下规范,违者视为自检不通过:\r \r

6.1 禁止事项\r

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

6.2 文档结构规范\r

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

6.3 语言风格要求\r

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

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

\r 可保留表格的场景(仅限以下情况):\r

  • 文档修订记录表(版本/日期/修订内容/状态)\r
  • 数据库DDL级字段定义表(字段名/数据类型/长度/必填/默认值/索引/说明),用于开发建表参考\r
  • API接口参数表(请求参数/响应结构/错误码定义),用于前后端联调\r \r 禁止使用表格的场景(须转为书面语言):\r
  • 成功衡量指标、建设目标、不包含范围 → 分段叙述或编号列表\r
  • 功能模块列表、菜单架构 → 加粗编号列表\r
  • 配置差异对比 → 连贯段落逐项对比\r
  • 字段定义(业务层面)→ "名称(英文名),类型,必填,默认值,校验,来源"的连贯句式\r
  • 查询条件、列表列定义、操作按钮说明 → 分段书面描述\r
  • 编辑约束、状态约束 → 叙述性段落\r
  • 性能需求、安全需求 → 按维度分段叙述\r
  • 验收标准 → "AC-编号 功能名:预期结果"的自然语言格式\r
  • 术语定义 → "术语:定义。"的加粗格式\r
  • 附录(截图索引/权限矩阵/开放问题/风险事项/参考文档)→ 书面段落\r \r 附录内容扩展规范:\r
  • UI设计规范附录:允许在附录中补充配色方案、布局风格、组件规范等UI设计细节,以便保持界面一致性。示例:\r 配色方案:达标状态使用绿色(#52c41a),未达标状态使用红色(#f5222d),警告状态使用橙色(#faad14),主色调使用蓝色(#1890ff)。\r 布局风格:参考综合人车比V2.0的卡片式布局,采用上下分区结构。\r
  • 开发建议附录(可选):作为独立附录章节,可提供开发计划建议、工时估算、风险提示等内容,但不得放在正文主体中。\r \r 字段定义推荐格式示例:\r \r

录入人员(operator_name),只读文本类型,必填,默认值为当前登录用户,不可修改,数据来源于系统会话,用于标识数据录入者身份。\r \r 合计金额(total_amount),数字输入类型,必填,默认值为0,校验规则为大于0,始终显示。\r \r 伪代码和代码块:\r

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

\r 页面/弹窗布局描述格式(替代ASCII线框图):\r \r

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

Usage Guidance
Treat this review as incomplete: the reviewer could not read metadata.json or the artifact directory, so installation should wait for a successful artifact inspection.
Capability Assessment
Purpose & Capability
Review is incomplete because metadata.json and artifact files were not readable through the available execution tool.
Instruction Scope
No instruction-scope concern was identified from artifact evidence, but the artifacts could not be inspected.
Install Mechanism
No install-mechanism concern was identified from artifact evidence, but the install artifacts could not be inspected.
Credentials
No environment-proportionality concern was identified from artifact evidence, but the artifacts could not be inspected.
Persistence & Privilege
No persistence or privilege concern was identified from artifact evidence, but the artifacts could not be inspected.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install prd-generator-from-prototype
  3. After installation, invoke the skill by name or use /prd-generator-from-prototype
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
prd-generator-from-prototype v1.0.0 - Initial release: generate standard PRD documents in Markdown from prototype/page descriptions using a fixed template and strict output constraints. - Only covers scope-defined pages and functions; automatically checks for consistency and highlights out-of-scope or missing items. - Enforces strict written language and formatting rules, including mandatory use of formal Chinese, section numbering, and restrictions against colloquial language and improper table usage. - Provides detailed prompts for missing information and refuses to generate full PRD without clear scope input. - Includes auto self-check and error handling to ensure PRD completeness, template conformity, and scope adherence.
Metadata
Slug prd-generator-from-prototype
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is prd-generator-from-prototype?

读取产品原型图/页面描述,按预设模板自动生成标准PRD文档,完成后自检一致性,不扩展需求范围. It is an AI Agent Skill for Claude Code / OpenClaw, with 39 downloads so far.

How do I install prd-generator-from-prototype?

Run "/install prd-generator-from-prototype" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is prd-generator-from-prototype free?

Yes, prd-generator-from-prototype is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does prd-generator-from-prototype support?

prd-generator-from-prototype is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created prd-generator-from-prototype?

It is built and maintained by rosscui-chy (@rosscui-chy); the current version is v1.0.0.

💬 Comments