前言¶

拿到一个原型交付物，往往意味着后面要手工补一批文档：需求、功能清单、测试用例、数据字典、概要设计、详细说明、数据库设计、试运行报告、维护手册、培训计划、测试报告。这类文档彼此之间有引用关系，手工写容易漏项，改一处原型就要重对一遍。

prototypes-spec 是一个面向这个环节的 Agent Skill：它读原型工具导出的 HTML（单个文件或整个目录），识别页面结构、页面内容、控件和交互，然后按你的要求生成对应的开发交付物。下面介绍它的能力边界、启用方式和实际使用建议。

这是什么¶

prototypes-spec 是社区发布的 Skill，坐标 @user_90addaef/prototypes-spec，发布者 user_90addaef，分类 dev-programming，当前版本 1.5.1，来自 SkillHub，页面评分 100000，下载量 2912。它的定位很明确：原型转开发文档的专用技能，不是通用文档或设计工具技能。

它解决的是”从原型到交付文档”这一段的重复劳动：把原型里已经画出来的页面树、控件、文本、跳转关系，提取成结构化信息，再落成 PRD、测试用例、数据字典、各类设计说明书等文档。

核心功能¶

支持的原型来源¶

• Axure RP：完整支持，可提取页面树、控件和交互。
• 墨刀 Mockplus：处理离线 HTML 演示包，提取页面文本和控件。
• MasterGo：处理离线标注导出，提取画板信息。
• 蓝湖 Lanhu：支持 Schema JSON 或导出 HTML。
• 其他工具导出的 HTML：退化为通用 HTML 解析。

输入形态¶

• 原型工具导出的 HTML 目录。
• 单个 HTML 文件。
• 包含多个 html 文件、data 目录、resources 目录的文件夹。

识别内容¶

页面结构、页面内容、控件、交互。Axure RP 作为完整支持的来源，可以拿到页面树级别的信息；其余工具按各自导出能力提取页面文本和控件。

可生成的交付物¶

文档类：

• PRD（产品需求文档）
• 系统概要说明书、详细说明书
• 数据库设计说明书
• 试运行报告、维护手册、操作手册
• 应用软件清单、系统参数配置说明
• 培训计划、服务计划
• 功能与性能测试报告

列表与图类：

• 功能清单
• 测试用例
• 数据字典
• 页面跳转关系图
• 用户故事
• 开发计划

安装与启用¶

prototypes-spec 基于通用 SKILL.md 格式，属于社区来源（source: community），标签显示 requires_api_key=false，使用前不需要申请 API Key。

技能主页：https://www.skillhub.cn/skills/user_90addaef/prototypes-spec
官方地址：https://api.skillhub.cn/user_90addaef/prototypes-spec

目前资料中没有给出各编辑器的具体安装命令，也没有 Cursor / Codex CLI / Claude Code 的差异化说明。实际安装路径请以技能主页说明为准，不要自行推断。

典型用法¶

技能的触发条件来自官方说明，覆盖了输入来源和文档类型两层关键词，以下按用途分组列出。

输入来源类：

Axure 原型、RP 原型、axure 导出、原型 HTML、原型文件
墨刀、mockplus、mockplus 导出、墨刀离线包
MasterGo、mastergo 导出、mastergo 离线标注
蓝湖、lanhu、蓝湖导出、蓝湖 schema

文档生成类：

原型转 PRD、原型转文档、原型生成文档、根据原型写需求、根据原型生成
系统概要说明书、概要设计、详细说明书、详细设计、数据库设计说明书、数据库设计、表结构设计
试运行报告、试运行方案、维护手册、运维手册、操作手册、用户手册
应用软件清单、软件清单、系统参数配置说明、参数配置说明
培训计划、培训方案、用户培训、培训安排、课程安排
服务计划、服务方案、运维服务计划、SLA、服务级别
功能测试报告、性能测试报告、功能与性能测试报告、测试报告、压测报告
根据 PRD 生成培训计划/服务计划/测试报告

操作类：

原型分析、解析原型、分析原型页面、原型提取
帮我从这个原型生成/输出/导出

输入形态类：

用户上传了 .html 文件或文件夹，并提到这是原型、设计稿、产品原型
涉及 "原型" + "文档/PRD/需求/功能/测试" 的组合
用户发来一个包含多个 html 文件、data 目录、resources 目录的文件夹，要求分析或生成文档

也就是说，拿到 Axure 导出的目录，说”帮我从这个原型生成 PRD”，属于预期触发路径；拿到一个通用 HTML 目录，说”分析这个原型的页面”，也会走通用 HTML 解析。

适用场景与注意¶

适合谁¶

• 拿到 Axure RP 导出目录，需要从原型直接产出需求、设计、测试类文档的团队。
• 使用墨刀、MasterGo、蓝湖离线导出包，希望把页面文本和控件提取成文档的人。
• 需要统一补齐概要设计、详细设计、数据库设计、试运行、培训、服务计划这类成套交付物的项目负责人。

限制与坑¶

• 覆盖深度取决于来源工具的导出能力。Axure RP 是完整支持，能提取页面树、控件和交互；墨刀、MasterGo、蓝湖分别受离线包和标注导出能力限制，提取的是页面文本、控件或画板信息。
• 非上述工具导出的 HTML 会退化为通用 HTML 解析，交互和页面树信息可能不完整。
• 交互提取只对完整支持的来源成立，复杂交互建议生成后人工复核。
• 文档类输出需要人工确认后再交付，生成结果应与实际原型逐页核对。
• 当前版本 1.5.1 属于社区来源，安装方式以技能主页为准。

结尾¶

prototypes-spec 的价值在于把”原型已画、文档待补”这段重复劳动固化成一条流程：丢入原型导出物，指定要生成的文档类型，拿到结构一致的初稿，再做人工核对。适合 Axure RP 完整场景和多工具混合的团队。

官方地址：https://api.skillhub.cn/user_90addaef/prototypes-spec