← 返回 Skills 市场
rosscui-chy

prd-generator-from-prototype

作者 rosscui-chy · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ 安全检测通过
39
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install prd-generator-from-prototype
功能描述
读取产品原型图/页面描述,按预设模板自动生成标准PRD文档,完成后自检一致性,不扩展需求范围
使用说明 (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](功能)。

安全使用建议
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.
能力评估
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.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install prd-generator-from-prototype
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /prd-generator-from-prototype 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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.
元数据
Slug prd-generator-from-prototype
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

prd-generator-from-prototype 是什么?

读取产品原型图/页面描述,按预设模板自动生成标准PRD文档,完成后自检一致性,不扩展需求范围. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 39 次。

如何安装 prd-generator-from-prototype?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install prd-generator-from-prototype」即可一键安装,无需额外配置。

prd-generator-from-prototype 是免费的吗?

是的,prd-generator-from-prototype 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

prd-generator-from-prototype 支持哪些平台?

prd-generator-from-prototype 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 prd-generator-from-prototype?

由 rosscui-chy(@rosscui-chy)开发并维护,当前版本 v1.0.0。

💬 留言讨论