用途:在 PBI 与用户故事定稿后、进入实现规划或设计规格之前,生成可点击、带旁白的 HTML 原型,让干系人预览每个故事主流程的 UI,提前暴露布局、UX、流程与状态缺口。仅适用于已评审、已通过门禁的 PBI/故事;纯后端无 UI 章节的 PBI 会跳过生成并告知用户。不用于生产 UI、设计规格或从零画线框图。
主要能力:每个 PBI 输出一个自包含 HTML 文件(所有故事以标签/分区呈现),内联 CSS/JS,除 Google Fonts 外无外部依赖,保存为 {pbi-filename}-mockup.html 并与 PBI 工件同目录。原型为脚本化可点击演示,每个主流程可端到端点击,带引导旁白(▶ Play / ⏭ Next / ⏮ Prev / ↺ Reset / ⏏ Exit)、说明面板和可见的“⚠ Simulated”横幅;交互仅为脚本模拟,不涉及真实认证、持久化或后端。需渲染默认/加载/空/错误等组件状态,并保持响应式布局与移动/桌面预览。
使用方式:按顺序执行流程——定位 PBI/故事、提取 UI 规格、[BLOCKING] 规划演示流程(每个流程一个 flow-spec 与待办)、加载设计系统、[BLOCKING] 盘点现有 UI 并映射关联流程、加载领域实体、生成 HTML、保存、报告、[BLOCKING] 保真度校验、[BLOCKING] 演示质量门禁。三个 BLOCKING 门禁不可跳过。输入路径为 team-artifacts/pbis/{YYMMDD}-pbi-{slug}.md 与 stories 目录下的故事文件,也可由用户显式提供路径。
适用场景:PBI 与故事定稿后、实现规划或设计规格之前,干系人需要功能视觉预览时;作为 workflow-idea-to-pbi 等流程的最后一步。
限制:交互为模拟,无真实后端;必须基于项目参考设计文档与现有组件保持保真,使用真实领域实体字段与示例数据而非 Lorem ipsum;描述性文字需技术无关(业务术语,非框架或 CSS 类名);若必需步骤或工具在当前环境无法运行,应停止并询问用户。具体收费、价格与平台信息暂未提供。