Prototype To Prd

Prototype to PRD · 原型/站点逆向写 PRD

把 可见界面与交互 转为结构化需求：先盘点真源，再按 prd-writer 分两版交付（概念版 → 落地版）。

文件结构

写 PRD 前：完成盘点并读 prd-writer-handoff.md；写概念版/落地版时 Read 对应 prd-writer/references/ 模板。
交付模式：读 AGENTS.md「交付模式」；本技能未声明时默认「标准」（写 PRD 阶段与 prd-writer §0 一致；可说「快速模式」降档或「严格模式」升档）。

执行顺序（门禁）

用户消息
  → 1. 识别输入源（Axure / 站点 / 混合）
  → 2. 采集与盘点（按 references 执行）
  → 3. 写入「原型盘点」+ 3–5 句摘要（标准：默认继续；用户可打断纠正）
  → 4. 三视角补缺口（仅问盘点看不出的；快速模式：合并为 1 轮）
  → 5. 概念版（标准默认分两文件；快路径见 prd-writer §0）
  → 6. 落地版（prd-writer prd-template + MVP 闸门）
  → 7. prd-writer self-check.md
  → 8. （可选）Word 导出

禁止：未读原型/站点就写 §5；把猜测写成确定需求。严格 下禁止跳过概念版确认；标准/快速 按 prd-writer §0。

1. 识别输入源

主题命名：从 Axure 项目名、document.js 的 projectName、站点 <title> 或用户说明提取；不确定时用「待定-原型逆向」。

2. 采集与盘点

Axure 导出包

按 references/axure-html-parse.md：

1. 读 index.html、data/document.js（或根目录 document.js）建立 页面树 / 站点图
2. 逐页读 files/<page>/ 下 HTML（及同目录 data.js 若有）：控件文案、表单字段、Tab/步骤、弹层标题
3. 从 data.js、页面内脚本、notes 区提取 交互说明、条件分支、动态面板状态（能解析则写进盘点；解析不出标 [原型未标明]）
4. 合并重复母版/公共页，去重导航

线上站点 / 本地 HTML

按 references/web-site-inventory.md；采集工具优先级见下节。

采集工具（线上 URL）

已配置 Playwright MCP？
  ├─ 是 → playwright-mcp-capture.md（navigate → wait → snapshot → evaluate → 多路由）
  └─ 否 → WebFetch；失败则请用户配置 MCP 或导出 HTML
需登录？→ auth-gated-sites.md（MCP 登录协作见该文件 §9）

1. 列可达页面（主导航、hash 路由、页脚；登录后若不可达则标注）
2. 每页：模块分区、主 CTA、表单、列表、空态/错误态（若可见）
3. 推断用户动线（主路径 + 可见分支）；推断处标 [推断]

盘点产出

按 references/inventory-template.md 写入：

路径：prd/PRD/{YYYYMMDD}-{客户名称}{项目名称}{形态}-原型盘点-V{版本号}.md

写完后用 3–5 句摘要告知用户，并说明：

盘点已写入 -原型盘点-V*.md。若无漏页/理解偏差，我将按 prd-writer 继续写 PRD；有需要更正请直接指出。

• 标准 / 快速：用户 未在下一轮消息中纠正 → 视为可继续，不阻塞等待「确认」
• 严格：须用户 明确确认 盘点无误后再写概念版
• 用户更正 → 更新盘点稿对应章节，再进入下一步

3. 三视角补缺口

盘点解决「界面有什么」；以下 不能从原型可靠推出，按 prd-writer/references/diagnosis-guide.md 只补缺口（每次 1–2 问）：

• 用户：目标人群、痛点（原型常缺）
• 商业：变现、为何做、与竞品差异
• 开发：后端能力、第三方、权限模型、真实数据源

已有 PRD/调研在 prd/（旧项目 docs/） → 先 Read（同 prd-writer/references/read-first.md），不重复追问。

4. 交接 prd-writer 写 PRD

按 references/prd-writer-handoff.md 与 prd-writer/SKILL.md 模式 A：

概念版「已有输入摘要」：链回 -原型盘点-V*.md，并注明输入源（Axure 路径 / URL）。

落地版额外规则：

• §3 动线：与盘点中的页面跳转、交互分支一致；简单用 Mermaid，复杂见 diagram-handoff.md
• §4 功能清单：页面/模块映射到功能树；🔴🟡⚪ 默认按「主路径可见 + 用户确认的 MVP」划分
• §5：仅展开 MVP 🔴；原型有标注的交互/状态/字段优先写入；无标注用 [待补充] 并写清影响
• §4.1 线框：优先从盘点中核心页 ASCII 提炼，可与原型布局一致

严格 下用户 明确确认 概念版后再写落地版（「差不多」不算确认）；标准 下用户说「可以/继续」即可进入落地版；快速 跳过概念版（见 prd-writer §0）。

5. 交付物一览

命名片段（{客户名称} 可省、{形态} 五选一、{版本号} 首版 V1.0）见 prd-writer §4「命名片段规则」，三份产物共用同一前缀。

修订：就地改也要改文件名。 不论体量大小一律就地 Edit 改（大文档尤其别整份重写，小文档也不要另存新文件）——目录里永远只留最高版本那一份；改完必须三样一起动——文首「文档版本」、版本记录表、mv 把文件名的版本号也改掉（局部修订 +0.1，结构性重写进大版本；日期取改动当天）。**绝不允许内容已是 V1.1、文件名还写 V1.0。**改名后 grep 一遍旧名，把 README 清单、下游「来源」行、tools/ 脚本里的引用一并改掉。完整规则见 ../common/README.md。

进研发门禁：PRD 落盘后若用户要开发 → 适用 prd-writer §10 / ../common/prd-to-srs-gate.md，须 req-doc Step F 再 page-generator。

用户已有 PRD、仅想对照原型查漏 → 不走本技能全流程；用 prd-writer 模式 B/C，本技能盘点稿可作为附件输入。

6. 与相邻技能

7. 通用原则

1. 真源优先：原型/站点可见 > 用户口头 > 推断；推断与待确认必须标注
2. 不编造业务规则：无标注的条件分支不写死逻辑
3. 复用 prd-writer：模板、自检、MVP 闸门不另起炉灶
4. 分阶段：严格 下概念版未确认不写 §5 细节；标准 须概念对齐后再写落地版
5. 写完必过 prd-writer/references/self-check.md（盘点稿路径写入自检备注）

8. 导出 Word（可选）

⚠️ 导出前后各一件事：① 图片必须放在文档同级的 images/ 子目录且文件名纯 ASCII——这是唯一可用形式，img/、images/sub/、../images/、与文档同目录、中文名全都静默丢图（脚本仍打印 Export succeeded，但 word/media/ 是空的）；② 导出后立刻验 unzip -l <docx> | grep -c "word/media/"，数字必须等于图片张数。实测边界表见 ../common/README.md。

Markdown 落盘并通过 prd-writer/references/self-check.md 后，若用户要求导出 Word（或消息命中「导出 PRD」「PRD 导出 Word」「需求文档转 Word」等），执行本步；未明确要求时不主动导出。命令与模板规则同 prd-writer §9，共用 ../common/export-word.*。

适用文件

命令

Windows（PowerShell）： ../common/export-word.ps1 <markdown文件路径> formal

跨平台： python ../common/export-word.py <markdown文件路径> formal

Git Bash： bash ../common/export-word.sh <markdown文件路径> formal

示例（文件名遵循 §5 落地版命名，<主题> 替换为实际项目名）：

../common/export-word.ps1 prd/PRD/{YYYYMMDD}-{客户名称}{项目名称}{形态}-产品需求文档-V{版本号}.md formal

输出与依赖

• 输出路径：与源 Markdown 同目录，文件名相同、扩展名为 .docx
• 本地图片：脚本自动扫描 MD 内 ![](相对路径) 并一并上传；远程 URL 图片不处理
• 依赖：Python 3；可访问 ../config.json 中 apiBaseUrl

导出完成后告知用户 .docx 路径；若 API 不可用，说明失败原因并保留 Markdown 为真源。

外部依赖与降级：Word/xlsx 导出

导出链走技能库根的 config.json 里的 apiBaseUrl（端点不随仓库分发，取值见该文件）。

三条不许：不许把「导出失败」写成完成；不许跳过导出直接说交付完成； 不许在导出后不验图——unzip -l x.docx | grep -c 'word/media/' 要等于文档里的图片张数（文件名含中文会静默丢图）。

外部依赖与降级：浏览器/模拟器驱动

本技能要真的把页面跑起来点一遍，依赖宿主提供的浏览器工具（Claude Code 的 Browser 面板、 Playwright MCP 等），移动端还要模拟器。

铁律：报告里只写真正执行过的结果。没跑的标「未执行」，跑挂的标「失败」并贴关键报错。