用途
HiUI Page Workflow 是 HiUI 页面的端到端交付 agent。它的目标不是只生成页面，也不是只写体验报告，而是把页面从需求细化、实现、工程验收到体验验收串成闭环。
这是一个门禁型编排 workflow，不复制下游 skill 的详细规则，但必须控制阶段状态、输入契约和证据门禁：
- 需求澄清、产品方案、页面清单、全局生成上下文、页面级提示词、HiUI 交接包：使用 hiui-refine
- 页面规划、生成、源码约束、contract、工程 gate：使用 hiui-design
- UX 检查标准、证据门禁、P 级问题、正式 docx 报告：使用或参考 ux-walkthrough
调度边界冻结见 references/dispatch-boundary.md：本 workflow 只依赖能力标识、公开调度身份和 machine-public protocol，不依赖下游内部命名。
核心铁律
- generationInputGate 未确认或未被用户明确授权假设时，不得生成页面或修改页面源码。
- uxGate.evidenceStatus 未就绪时，不得输出确定性的完整 UX 报告。
- standard-e2e / formal-e2e 未覆盖 P0 场景时，不得只输出 P2 表面问题。
主要能力与阶段门禁
本 workflow 使用 6 个阶段和 3 个 Gate。
- S0 需求与生成输入确认：细化需求，确认页面清单、页面提示词和 HiUI 交接包；进入下一阶段需 generationInputGate.status = confirmed。
- S1 HiUI 页面规划：调用 hiui-design 规划页型、拓扑、命令和必读文档；机器计划完成，blockingReasons 为空或已处理。
- S2 页面生成 / 修改：基于确认输入写页面；S1 完成，且再次确认 generationInputGate 已通过。
- S3 工程验收：记录并执行进入验证 / 交付相位的 requiredActions / formalAcceptanceActions；动作结果已记录为 passed / failed / skipped / blocked。
- S4 UX 验收：按验收等级执行 ux-smoke / ux-standard / ux-formal；uxGate.evidenceStatus = ready 或明确降级 / 阻塞。
- S5 修复与最终交付：修复 P0/P1，复验并输出报告；工程结果、UX 结果、截图和风险已收口。
Gate 最小状态：
- requirementGate.status：needs-confirmation | requirements-confirmed | assumption-authorized | blocked
- generationInputGate.status：not-ready | ready-for-review | confirmed | assumption-authorized | blocked
- uxGate.evidenceStatus：not-ready | ready | insufficient | blocked
使用方式
进入本 workflow 的典型请求包括：生成并验收 HiUI 页面；从产品需求生成并验收 HiUI 页面；将模糊需求细化、生成页面并完成验收；需求细化、页面生成、工程验收、UX 验收一条龙；端到端生成页面；生成页面后做体验走查；HiUI 页面提测前检查；修复页面并输出体验报告。
若用户只要求需求细化、产品方案、页面清单或页面提示词，且没有页面生成 / 验收目标，可在本 workflow 的 S0 收口，并按 hiui-refine 的交付模式输出。若用户通过本 workflow 明确要求“需求细化 -> 页面生成 -> 验收”全流程，不得停在 S0，必须继续进入 HiUI 规划、生成、工程验收和 UX 验收。若用户只要求体验走查，优先使用 ux-walkthrough。
HiUI 直通白名单：只有满足以下任一条件，才允许跳过完整需求细化并直接进入 hiui-design：用户已提供确认过的 HiUI 交接包；用户已提供明确页面清单和页面级提示词；当前任务只是已有页面的局部修改，且不改变页面结构、业务规则、权限或状态机；用户明确选择或明确表达“保留假设，先生成一版 / 按你的假设推进 / 不用再确认”。用户说“生成页面 / 继续 / 开始吧 / 端到端 / 一条龙”只代表任务目标，不等于授权跳过确认。
先判验收等级：quick-preview（生成页面并确认可运行，做 ux-smoke）；standard-e2e（生成 / 修改页面，跑工程 gate，做 ux-standard 结构化 UX 验收）；formal-e2e（提测、发布、合入、无 warning、完整 UX review，做 ux-formal 完整 ux-walkthrough）。若用户出现“提测 / 发布 / 合入 / 无 warning / source-gate / doctor / finalize-page / 完整体验走查 / UX review 报告”，升级为 formal-e2e。
适用场景
适用于从模糊产品需求生成并验收页面、HiUI 页面提测前检查、页面生成后做体验走查、页面从需求到实现再到 UX 验收闭环等任务。
限制与边界
- 本 skill 只负责编排和消费下游 skill 的稳定输出，不负责公开安装入口，也不承担 bundle 分发控制。
- 运行时依赖 hiui-refine、hiui-design、ux-walkthrough 在环境中已可用；若运行环境缺少上述依赖 skill，应先说明缺口，再提示使用公开入口完成安装。
- 调度时只依赖能力标识 requirements-refinement、page-planning-and-delivery、ux-walkthrough-review。
- 普通页面交付任务中，不要把安装、回滚、发布 smoke 脚本当成 workflow 默认步骤。
- 不要把 hiui-page-workflow 对外表述成安装入口、bundle 入口或组合分发入口。
- 若用户需要安装、升级、校验、回滚或发布 4 个 skill 的组合分发，应引导其使用 hiui-workflow。
安装指引
当用户询问如何安装本 workflow 或其依赖 skill 时，统一引导到公开安装入口：
npx skills add XiaoMi/hiui/skills/hiui-workflow --skill '*'
说明要求：安装入口是 hiui-workflow；被安装的是其中包含的 4 个独立 skill；上述命令当前是 Codex 默认安装方式，非 Codex 宿主需要显式指定目标 skill 根目录。
验证边界
本 skill 自身的完成判断，仍以页面交付 workflow 为准：需求确认是否完成、页面生成输入是否确认、页面规划和实现是否完成、工程验收结果是否已记录、UX 证据是否就绪、修复闭环和最终交付是否完成。安装、校验、回滚和发布 smoke 属于 hiui-workflow 的分发控制面，不属于本 skill 的默认完成路径。