requirements-prototype

name: requirements-prototype description: > 原型设计标注技能 — 从 spec IPO 表推导符合规范的原型标注文档，达到「开发就绪（D3）」深度， 可被 prototype-scan 直接消费生成代码。 USE FOR: 为模块/页面生成原型标注（交互模式+字段+组件+交互规则）； 把 spec 功能设计转为结构化页面清单；验证已有原型标注是否达到 D3； 补全原型标注的缺失项（字段名/字典编码/状态机规则）。 DO NOT USE FOR: 视觉设计（颜色/字体/间距）；流程图绘制（用 requirements/flowchart/）； 处理逻辑设计（用 requirements/spec/）；数据库/接口设计。 tools: - create_file - read_file - replace_string_in_file

原型设计标注规范（wl-skills-design）

⚠️ 核心定位（先读）

原型标注不是画图，是把 spec 的功能设计转成结构化页面清单—— 固定每页的交互模式、字段位置、组件选型、交互规则，让 prototype-scan 能精确解析成代码。

• 一个原型页面 = spec 中的一个功能（4.x.4.z），复用 spec 功能编码，不另起编码
• 原型字段 ⊆ spec IPO 字段（不凭空造字段）
• 不做视觉设计（颜色/字体由 UI 规范决定）

第一步（必须）：加载规范

.github/standards/02-prototype.md

唯一权威来源，包含：8 种交互模式、每页 7 项必标内容、三级深度（D1/D2/D3）、 钢铁行业特化约定、验证清单（23 项）。不读规范，不执行生成。

第二步：确认 spec 上游（强制前置检查）

原型的字段和功能必须来自 spec。生成前确认：

找不到 spec 时不要凭空捏造字段，引导用户先补 spec。

第三步：识别任务类型，加载对应 Sub-Skill

第四步：套用模板

.github/skills/requirements/prototype/templates/page-annotation.md

单页面标注模板，含 7 项必标区块。每个页面套一份，不得任意删减区块。

空白模板 vs 真实样例：templates/page-annotation.md 是空白起点（纯结构 + 占位符）； examples/01-page-annotation.md 是真实样例（质量标杆）——一份达 D3 的炼钢计划列表完整标注， 含状态机显隐与字段对齐表，生成结果须对照样例自检且不低于它。

操作入口（完整闭环）

⚠️ 闭环工作流（必须遵循）

[阶段1] 生成（按页面逐个标注，套 page-annotation 模板）
      ↓
[阶段2] 验证（执行 23 项检查清单 PT-A/B/C/X）
      ↓ 有失败项？
[阶段3] 修复（按 02-prototype.md §十 修复协议）
      ↓
[阶段4] 复验（全部 P0/P1 通过）→ 原型达 D3 → ✅ DONE

执行规则

跨文档一致性检查（PT-X 组，每页执行一次）

原型字段集 ⊆ spec IPO 字段集            → X01
原型 dictCode 集 = DB 枚举定义集         → X02
原型按钮集 → spec 处理逻辑均有对应        → X03
原型字段英文名 ⊆ 术语词典英文名集         → X04（词典存在时）
原型页面「关联 IPO」编码 ∈ spec 4.x.4    → X05

验证报告格式（每页验证后必须输出）

验证报告 — [页面名]（关联 [功能编码]）
深度等级：D1 / D2 / D3
总项数：23 | 通过：N | 失败：M | 暂挂：K
失败项：
  [X01] 原型字段 {alloyRatio} 在 spec IPO 中不存在
  [B02] 字段 {planStatus} 是 dict 类型但未标 dictCode
状态：❌ 需修复后继续

快速参考：交互模式速选

详细决策树见 standards/02-prototype.md §二.1。

与下游 prototype-scan 的衔接

D3 级标注的字段清单结构 = prototype-scan 消费格式，可直接转 page-spec JSON：

SKILL（本技能）输出 D3 标注  →  prototype-scan 解析  →  page-codegen 生成 Vue 代码

标注越精确，代码还原度越高（D3 + prototype-scan 可达 95-100%）。