原型说明生成器

中文简介

原型说明生成器：把产品意图变成与验证目的相称、可交接且可复查的原型说明。它先决定要学什么，再决定保真度、页面、状态与交付对象；不会用漂亮页面、虚构文案或遗漏状态掩盖尚未决定的产品逻辑。

使用背景

当团队需要用原型验证任务、对齐体验、准备 Figma 文件，或将已确认的体验交给 Codex、Cursor 等编程代理实现时使用。它接收 prd-builder 的范围、验收与埋点，也可把成型交接物传给 microinteraction-motion-designer 或 spec-to-implementation-plan。

核心原则

原型目的决定保真度：探索问题用低保真，可用性任务用中保真，视觉/实现评审才使用高保真；高保真不是默认质量标志。
每个页面、弹层和状态都必须服务于一个关键任务、决策、恢复路径或受控比较；写不出存在理由就不纳入本轮。
用关键任务流定义范围：写清入口、触发、系统反馈、分支、恢复和可观察的成功退出，而不是罗列页面。
状态是体验的一部分。对每个关键屏幕和组件按风险覆盖默认、加载、空、错误、成功、禁用、权限/未登录、长内容和部分数据。
真实、可辨认的内容优先于 lorem ipsum。无法取得真实内容时，标出内容来源、已知字段和受控合成规则，禁止以泛化占位词替代业务判断。
响应式、无障碍和埋点从任务流派生：不同屏幕宽度如何重排，键盘/读屏如何完成任务，什么事件证明用户走到何处。
交付物按接收方改变：设计师需要可测试任务和 Figma 结构；编程代理需要可实现的状态、数据、组件和约束；一句话想法只能得到带未知项的探索范围。

适用场景

为设计师准备可用性测试原型，明确研究问题、受试任务、必要路径、观察点和 Figma 组织方式。
为 Figma 制作、评审或设计系统对齐准备页面、组件、变量、内容和原型连接说明。
为 Codex、Cursor 或前端团队准备高保真、响应式、可访问且不擅自增加产品逻辑的实现说明。
从 PRD、用户流、线框、截图、会议纪要或一句话想法收敛本轮最小可验证体验。

不适用场景

需要先发现用户问题、任务和证据时，先用 feature-discovery-interviewer 或 user-feedback-synthesizer，不要把未验证方案画得更精致。
需要定义范围、验收、依赖或产品决策时，先用 prd-builder；原型说明不代替 PRD。
需要完整工程任务拆分、代码库入口和测试策略时，把已确认的说明交给 spec-to-implementation-plan。
只有品牌海报、营销视觉或静态插画需求而没有用户任务时，不要伪装成产品原型。

输入要求

先收集以下输入；未提供的事实标为 [待确认]，同时写明补齐动作和它会影响的决定：

原型目的、要回答的决策问题、受众、负责人、截止时间，以及本轮明确不验证什么。
目标用户、使用情境、主任务、入口、成功退出、失败后果和已有证据或 PRD 条目。
平台、目标视口、设计系统/品牌、已有截图或组件库，以及技术、隐私、合规和性能约束。
关键流程、分支、权限、外部跳转、数据来源、内容负责人和可用的真实样本。
接收方是设计师、Figma 制作人、编程代理还是混合团队；交付格式、可点击范围和审查标准。
需要观察或衡量的行为、事件名称/已有埋点规范、隐私限制和测试或上线环境。

信息不足时的处理

只有一句想法： 不承诺页面数、高保真视觉或完整组件库。产出一个低保真探索卡：候选用户与任务、最小入口到退出、需要验证的问题、未知项和补数访谈/数据动作；仅用少量可替换线框表达假设。
没有原型目的： 暂停选择保真度。列出概念探索、可用性、干系人对齐、视觉评审和工程实现五种目的，要求 owner 选择要改变的决定。
没有真实内容或数据： 不用“示例文本”掩盖逻辑。列出内容字段、来源、刷新/权限规则和脱敏要求；可用经过标注的合成样本展示长度、密度、日期、金额和异常值。
没有平台或响应式约束： 只声明待确认的目标断点与输入方式，不把桌面布局缩小为移动端。先要求目标设备、最小宽度、导航模式与内容优先级。
没有状态或错误规则： 对高风险操作停止进入高保真实现；先向产品/工程确认加载、空、失败、重试、权限、撤销与回滚策略。

工作流

建立原型决策卡。 写明要改变的决定、原型目的、目标用户、核心任务、风险、接收方、截止时间、非目标和未知项。
映射目的与保真度。 用 references/usage-guide.zh.md 选择低/中/高保真，并写明需要真实到什么程度、哪些内容可合成、哪些交互必须可点击。
切出关键任务流。 画出入口、用户动作、系统反馈、分支、恢复和成功退出；把不影响本轮学习或交接的页面排除。
建立页面存在理由。 对每个屏幕/弹层写它支持的任务步骤、信息/决策、进入和离开条件；合并没有独立理由的页面。
补齐状态、组件与内容。 为关键屏幕和可复用组件登记状态、触发、校验、恢复、真实内容字段、来源和边界样本；交给编程代理时分配 P-*、C-*、B-* ID。
定义跨端、无障碍与埋点。 写明断点重排、触控/键盘路径、语义与焦点、对比度/动态效果要求，以及事件、触发和最小属性。
按接收方编排交接。 设计师交付研究任务和观察记录；Figma 交付页面树、组件/变量和原型连接；编程代理交付可追溯的行为契约、数据、接口、状态、路由、恢复与验收；想法阶段交付假设与补数动作。
执行质量门。 读取 references/checklists.md，删除与目的无关的屏幕，标记未知项，并确认模板、内容和示例之间可闭环。

专业判断规则

原型目的与保真度

目的	推荐保真度	必须真实的部分	不应假装完成的部分
探索问题/对齐概念	低	任务假设、信息层级、分支	品牌、动效、像素级组件、工程可行性
可用性测试	中	任务路径、可读内容、反馈、恢复、点击连接	未验证的边缘功能和生产数据承诺
视觉/干系人评审	中到高	品牌、关键布局、内容密度、关键状态	未确认的后端逻辑或完整数据集
编程实现评审	高	组件、状态、真实数据形态、响应式、无障碍、验收	未获确认的产品规则、接口或性能指标

目的同时包含学习/交接问题、目标决策和失败成本。若只是“做一个高保真原型”，先追问它需要改变什么决定。
同一项目可有不同保真度的区域：付款确认可高保真，尚未验证的推荐页可低保真；不要因一张页面高保真而让全流程膨胀。

页面、任务流与完整状态

页面表的“存在理由”必须能对应一个任务步骤、关键选择、系统反馈、错误恢复或比较变量；纯装饰页、重复确认页和未被测试的二级流不纳入。
主流程至少涵盖首次入口到成功退出；对会阻断任务的取消、权限拒绝、网络失败、校验失败和无数据路径给出用户可恢复的下一步。
状态覆盖按风险而非机械凑数：只读简介不必伪造成功态；提交、搜索、权限、支付和数据同步必须写加载、失败、恢复、禁用与部分成功策略。

内容、响应式、无障碍与埋点

内容表必须说明字段、来源、是否真实/脱敏/合成、允许替换范围和极值样本。合成内容要保留实际长度、语言、日期、金额、空值和权限差异，不能写 lorem ipsum 或“用户 A”。
响应式说明至少包含目标宽度、布局重排、导航变化、触控目标、内容优先级、截断/换行与横向溢出规则；不同于“自动适配”。
无障碍至少覆盖语义结构、可见焦点、键盘顺序、表单标签和错误关联、对比度、读屏状态播报，以及减少动态效果或替代反馈；高风险流程还要写焦点回退和错误摘要。
埋点记录事件名、触发时刻、对象/来源/状态等最小属性、不可采集的敏感字段与用途。原型研究可记录观察点和任务完成/放弃；实现说明应对接既有事件规范。

接收方差异化交付

接收方	必须交付	不应假设
设计师	研究问题、受试任务、场景、可点击路径、观察点、页面理由和状态优先级	设计师会自行补齐产品规则或研究目标
Figma 制作/评审	页面树、命名、组件/变体/变量、连接、原型起点、内容和评审注释	只给静态截图即可测试或交接
Codex/编程代理	路由/屏幕、组件契约、状态与转换、数据模型/内容、响应式、无障碍、事件、技术约束和验收	代理可合理发明接口、权限、错误恢复或业务规则
一句话想法	问题假设、候选用户/任务、低保真范围、未知项和补数动作	它已经具备生产范围或高保真依据

编程代理行为契约

对每个会改变页面、组件或业务结果的行为，使用 B-* 记录当前状态、用户/系统事件、守卫/前置条件、下一状态、明确路由目标、副作用、接口请求、成功响应、失败响应和失败恢复。
页面用 P-*、组件用 C-* 标识，并在各自清单中引用 B-*；任何未被引用的 B-* 或没有行为契约的可交互页面/组件，都是未完成交接。
成功响应不仅写“成功”：写状态码和消费字段，以及由此产生的业务结果、后续状态与路由。失败响应同样写错误类型/状态、保留或回滚的数据和用户可执行的恢复。
接口尚未确认时标为 [待确认] 并停止高保真实现交接；不得由代理补造路径、请求体、权限、价格、成功后业务结果或错误恢复。

输出契约

输出按 references/templates.md，至少包含：

原型决策卡：目的、决策问题、保真度及理由、受众、接收方、非目标、风险和未知项。
关键任务流：入口、动作、系统反馈、分支、恢复、成功退出、测试任务或验收点。
页面与状态清单：每页存在理由、进入/离开条件、内容、任务步骤及按风险选择的完整状态；编程代理交接使用 P-* 和关联 B-*。
组件与内容契约：变体、交互、校验、数据字段、真实/脱敏/合成来源、极值样本和不可编造规则；编程代理交接使用 C-* 和关联 B-*。
编程代理行为契约：每个 B-* 都给出当前状态、事件、守卫、下一状态、明确路由目标、副作用、请求、成功/失败响应和失败恢复。
响应式、无障碍与埋点：跨端行为、键盘/读屏与视觉反馈、事件/属性、隐私边界和观察点。
接收方交接包：分别列出设计师的研究任务/观察记录、Figma 的页面树/组件变量/原型连接、编程代理的行为契约与实现边界，或想法探索范围。
明确的开放问题和补数动作；信息不足时只交付探索范围，不虚构高保真细节。

质量门槛

不交付没有目标决策、用户任务和保真度理由的原型范围。
不交付无法说明存在理由、没有进入/离开条件或不服务关键流的页面。
不交付只列默认态，却让关键提交、搜索、权限或数据操作缺少加载、失败和恢复的说明。
不以 lorem ipsum、泛化头像或无来源数字掩盖内容、长度、权限和异常逻辑。
不把“响应式”或“无障碍”作为空标签；必须给出可检验的布局、键盘/语义和反馈规则。
不把设计师/Figma/编程代理视为同一种交接对象，也不让编程代理自行补造产品规则。
不交付没有 P-*/C-* 到 B-* 可追溯关系，或缺少路由、接口响应和失败恢复的编程代理说明。
交付前阅读 references/checklists.md；需要保真度选择和调用顺序时读取 references/usage-guide.zh.md，需要三种场景示范时读取 references/examples.md。

常见失败与修正

失败	修正
“做一套高保真页面”	先写待改变的决定与任务，再按目的选择局部保真度。
页面清单很长但无法解释为什么存在	给每页写任务步骤或状态理由；没有理由就删除或合并。
只画顺利路径	为阻断关键任务的加载、失败、权限、空和取消路径写恢复动作。
用占位文案和随机数字演示复杂业务	记录字段来源和受控合成规则，保留真实长度、格式、空值和权限差异。
“支持手机和桌面”	指定目标宽度、导航切换、重排、优先级和输入方式。
给 Codex 一张截图就要求可运行实现	增加路由、组件/状态、数据、无障碍、事件、技术边界和验收。
“接受优惠”后只写一个成功页	写明接受/拒绝的业务结果、接口、响应、下一状态、路由与失败恢复。
只有一句想法却产出完整设计系统	降级为低保真探索卡，并列出需要补齐的用户、任务和平台事实。

参考资料

references/usage-guide.zh.md：中文调用顺序、保真度选择和接收方交接指引。
references/templates.md：完整说明、探索卡、Figma 与编程代理交接模板。
references/checklists.md：范围、状态、内容、跨端、无障碍、埋点和交接质量门。
references/examples.md：设计师可用性、Codex 高保真实现和一句话想法的闭环示例。

prototype-brief-builder

SKILL.mdprototype-brief-builder/SKILL.md