create-yss-spec 1.1.1 → 1.1.3

package/template/.codex/skills/yss-ui/references/quick-recipes.md

@@ -152,7 +152,7 @@ const nodeColumns = reactive<YTableColumn[]>([
 
 ---
 
-## 模板 4：列表请求 + Mock 联调
+## 模板 4：列表请求 + API 接入
 
 ```ts
 const fetchData = async () => {

package/template/AGENTS.md

@@ -67,6 +67,10 @@ yss-product-lifecycle
 -> competitive-intelligence (需要竞品 / 市场事实时)
 -> grill-with-docs
 -> to-prd
+-> product overview design / functional architecture
+-> product-design:index
+-> prototype-review
+-> Product Design focused skill 产出高保真 HTML 原型并经用户确认
 -> OpenAPI Draft
 -> OpenSpec-style Spec Delta (中高风险行为变化时)
 -> OpenAPI Freeze
@@ -126,9 +130,10 @@ Matt skills 与 YSS skills 产物正文默认使用中文，包括澄清记录
 - 任务开始前必须先参考 `docs/process/harness-process-tailoring.md` 判断小改动 / 中等变更 / 新模块或高风险变更；裁剪只能减少不相关产物，不能裁剪安全人审、Issue 追踪、Git checkpoint 和 fresh verification。
 - 新功能或较大改动必须先用 `grill-with-docs` 澄清需求，再用 `to-prd` 形成 PRD，并在 PRD、实施计划或 Issue 中引用澄清记录。
 - PRD 基线阶段必须同步明确功能架构：功能域、模块边界、优先级、MVP / 非目标范围和模块依赖；不清晰时不得进入 PRD 校准。
+- 只要进入 PRD 初稿 / 需求基线流程，产品总体设计 / 功能架构就是必要产物，默认路径为 `docs/design/<feature>-product-overview-design.md`，且必须包含低保真原型 / 页面草图。不得直接从 PRD 初稿进入页面 / 原型 / 交互设计、OpenAPI Draft、PRD 校准、需求冻结或实现；不进入 PRD 生命周期的小文案、低风险 Bug 或局部配置变更，必须在影响面评估中说明不适用原因。
 - 涉及页面设计、原型评审、UI 实现、组件选型、主题 token、颜色排版间距或 Ant Design / YSS UI 风格一致性的任务，必须先用 `yss-design-system` 作为设计系统基线；详细规范引用 `docs/design/design-system.md`。
-- 有用户界面的功能在 PRD 初稿后必须先引用 `yss-design-system`，再用 `product-design-prototype` 产出页面、原型、交互状态、PRD 回填项和 OpenAPI 反推清单，并通过 `prototype-review` 后才能进入 PRD 校准 / 需求冻结和 UI 驱动的 OpenAPI Draft。
-- 任何 API 契约变更必须先在 `docs/api/specs/*.yaml` 形成 Draft；有 UI 的功能不得只基于 PRD 反推 OpenAPI，必须结合产品总体设计、页面/原型/交互说明、状态矩阵和 `prototype-review` 结论，经工程基线（如适用）、系统 / 数据架构和设计审查后 Freeze，再实现前后端和测试。
+- 有用户界面的功能在 PRD 初稿和产品总体设计 / 功能架构后必须先引用 `yss-design-system`，再以 `product-design:index` 作为产品原型产出主入口，按 Product Design plugin 路由到 `$get-context`、`$ideate`、`$prototype`、`$image-to-code`、`$url-to-code` 等 focused skill，产出页面、原型、交互状态、PRD 回填项和 OpenAPI 反推清单；低保真 `prototype-review` 通过后，必须产出高保真 HTML 原型，默认路径为 `docs/design/prototypes/<feature>/index.html`，且必须使用 Ant Design v6。原型产出前必须使用 `antd` CLI 查询设计语言、组件 API、demo、token 和 semantic 信息；原型完成后必须记录 AntD v6 校验证据。该高保真 HTML 原型是流程必需产物，可由系统 / Agent 在低保真评审通过后自动产出，不要求用户手工提供；产出后必须获得用户确认并记录确认结果，未产出或未确认前不得进入 PRD 校准 / 需求冻结和 UI 驱动的 OpenAPI Draft。
+- 任何 API 契约变更必须先在 `docs/api/specs/*.yaml` 形成 Draft；OpenAPI 不得只基于 PRD 反推，必须结合产品总体设计 / 功能架构；有 UI 的功能还必须结合页面/原型/交互说明、状态矩阵、`prototype-review` 结论和 Ant Design v6 高保真 HTML 原型，经工程基线（如适用）、系统 / 数据架构和设计审查后 Freeze，再实现前后端和测试。
 - API、权限、状态机、数据模型、跨端、新模块或高风险行为变化，应在 Design Review / OpenAPI Freeze 前补充 OpenSpec-style Spec Delta，落点为 `docs/specs/<feature>-spec-delta.md`；小文案、局部样式、配置微调和低风险 Bug 默认不需要。Spec Delta 只记录行为差异、验收场景和测试映射，不恢复 OpenSpec CLI、额外变更目录或状态机。
 - OpenAPI Freeze 后进入 `to-issues`，将冻结范围拆成端到端垂直切片 Issue；不得要求额外状态机或变更目录作为交付前置。
 - 涉及服务边界、部署、集成、性能、安全、可靠性或运维的变更，必须在设计审查前产出系统总体架构或等价设计记录。
@@ -252,7 +257,8 @@ Web Adapter
 |------|----------|------|--------|
 | PRD Review | PRD 完成后 | Product / Domain Review Agent | 用户、痛点、非目标范围、验收标准或安全红线不清 |
 | Grilling Review | 新功能 / 较大改动 PRD 前、Architecture Review 前 | Product / Domain / Architecture Agent with `grill-with-docs` | 用户价值、边界、状态、反例、架构约束、验收标准或安全红线经不起质询 |
-| Prototype Review | 有 UI 的 PRD 初稿完成后、PRD 校准前 | Product Design / UX / Frontend / API Agent | 页面清单、原型/线框、用户流、状态矩阵、PRD 回填项、权限状态或 OpenAPI 反推清单不清 |
+| Prototype Review | 有 UI 的 PRD 初稿完成后、高保真 HTML 原型前 | Product Design / UX / Frontend / API Agent | 页面清单、原型/线框、用户流、状态矩阵、PRD 回填项、权限状态或 OpenAPI 反推清单不清 |
+| High-fidelity HTML Prototype Review | 低保真原型评审通过后、PRD 校准前 | Product Design / UX / Frontend Agent | Ant Design v6 高保真 HTML 原型缺失、主流程/关键状态/响应式/权限体验不可审查 |
 | API Review | OpenAPI Draft 后 | API + Frontend + Backend Agent | schema、错误结构、分页、权限、契约测试不可落地 |
 | Architecture Review | 系统/数据架构后 | Architecture Review Agent | 业务/功能/系统/数据架构、DDD 分层、模块依赖、ADR、状态流或回滚策略不清 |
 | Plan Review | 垂直切片生成后 | Planning / Test Agent | 切片横向拆层、缺测试命令、缺回滚点或范围过大 |

package/template/CONTEXT.md

@@ -12,6 +12,7 @@
 | PRD | 产品需求文档，用于记录用户问题、解决方案、用户故事、关键决策和测试 seam。 | 除非作为既有参考，否则不要写入具体实现文件路径。 |
 | OpenAPI Draft | review-only 的 OpenAPI 3.1 契约草案。 | Freeze 前不得作为前后端稳定实现契约。 |
 | OpenAPI Freeze | 已通过评审、可作为前后端实现和契约测试输入的 OpenAPI 3.1 契约。 | Freeze 后变更必须回到 API 影响分析和设计审查。 |
+| 高保真 HTML 原型 | 低保真原型评审通过后，用于在浏览器中审查真实视觉密度、交互状态和页面流的产品设计资产。 | 不等同于生产前端实现，也不替代 OpenAPI、PRD 校准或垂直切片。 |
 | 垂直切片（Vertical Slice） | 贯穿所有受影响层、可独立验证的窄功能路径。 | 优先使用垂直切片，避免只按层拆分的横向任务。 |
 | ADR | 架构决策记录，用于沉淀难以回滚、非显而易见且存在真实取舍的技术决策。 | 常规实现选择不要写 ADR。 |
 | Fresh Verification | 完成前重新执行的验证证据，包括测试命令、契约校验、关键路径检查或人工审查结论。 | 不等同于“之前跑过”或实现者自述。 |

package/template/docs/adr/adr-product-design-prototype-entrypoint.md

@@ -0,0 +1,54 @@
+# ADR-001: 使用 product-design:index 作为产品原型主入口
+
+## 状态
+
+已接受
+
+## 日期
+
+2026-07-06
+
+## 背景
+
+YSS Harness 需要把有 UI 功能的产品原型产出收敛到一个稳定入口，同时保留需求质询、设计系统、Ant Design v6 事实校验、原型评审和用户确认门禁。原有 `product-design-prototype`、`wireframe-prototype`、`high-fidelity-html-prototype` 容易被理解为并列主入口，导致 Agent 在不同阶段选择不同原型工具，难以保证高保真 HTML 原型、AntD v6 校验证据和用户确认记录一致落地。
+
+## 决策
+
+产品原型产出统一以 `product-design:index` 为主入口。该 skill 只负责路由，实际按 Product Design plugin 规则进入 `$get-context`、`$ideate`、`$prototype`、`$image-to-code`、`$url-to-code`、`$design-qa` 或 `$share` 等 focused skill。
+
+`grill-with-docs` 保留为前置需求质询和领域边界澄清工具，不承担 HTML 原型产出。`antd` skill / `antd` CLI 作为 Ant Design v6 组件、demo、token、semantic 和 design.md 的事实来源。YSS 生命周期继续负责 `prototype-review`、用户确认、PRD 回填和 OpenAPI Draft 门禁。
+
+## 考虑的替代方案
+
+| 方案 | 优点 | 缺点 | 结论 |
+|------|------|------|------|
+| 继续使用多个原型技能并列入口 | 对旧流程改动少 | Agent 路由不稳定，难以统一 AntD v6 高保真 HTML 原型和确认记录 | 放弃 |
+| 只保留 `high-fidelity-html-prototype` | 产物目标直接 | 缺少 Product Design plugin 的上下文、视觉探索、URL / 图片 / 代码来源路由能力 | 放弃 |
+| 以 `product-design:index` 为主入口，旧技能保留兼容 | 路由统一，可复用 focused skills，迁移风险低 | 需要在文档中明确 legacy 边界 | 采纳 |
+
+## 后果
+
+### 正面影响
+
+- 有 UI 的产品原型产出入口统一。
+- 高保真 HTML 原型、AntD CLI 校验证据和用户确认记录成为固定门禁。
+- Figma / Axure / Excalidraw / 截图 / URL 可作为输入来源，而不是主交付格式。
+
+### 负面影响
+
+- 需要维护完整 `.codex/skills/product-design/` 插件目录，不能只复制 `index/SKILL.md`。
+- 旧原型技能在过渡期仍会存在，需要通过流程文档限制使用语境。
+
+### 风险
+
+- 如果 Agent 未读取 Product Design focused skill，可能误把 `product-design:index` 当作直接产出技能。
+- 如果跳过 `antd` CLI 查询，原型可能偏离 Ant Design v6 组件 API 或 token。
+- 如果缺少用户确认记录，下游 PRD 校准和 OpenAPI Draft 会失去体验冻结依据。
+
+## 相关
+
+- `AGENTS.md`
+- `docs/process/product-prototype-workflow.md`
+- `docs/process/lifecycle-artifact-map.md`
+- `docs/design/README.md`
+- `docs/design/templates/prototype-confirmation-template.md`

package/template/docs/api/templates/openapi-draft-review-checklist.md

@@ -16,6 +16,9 @@
 | 原型 / 线框图 |  |  |
 | 状态矩阵 | `docs/design/<feature>-state-matrix.md` |  |
 | 原型评审结论 | `docs/design/<feature>-prototype-review.md` |  |
+| 高保真 HTML 原型 | `docs/design/prototypes/<feature>/index.html` | 有 UI 时必需；必须使用 Ant Design v6，并通过 `product-design:index` 路由产出或记录例外原因 |
+| AntD CLI 校验证据 | `docs/design/<feature>-prototype-confirmation.md` 或评审记录 | 有 UI 时必需；记录 design.md / info / demo / token / semantic 查询 |
+| 用户确认记录 | `docs/design/<feature>-prototype-confirmation.md` | 有 UI 时必需；未确认前不得进入 OpenAPI Draft 评审 |
 | YSS 工程基线 | `.codex/skills/yss-ddd-scaffold-generator/references/yss-backend-scaffold-parent/SKILL.md` |  |
 
 ## P0 追踪矩阵
@@ -31,7 +34,8 @@
 | Draft 成熟度 | 明确当前仅为 review-only；实现、生成 client、契约测试固化均等待 OpenAPI Freeze |  |  |
 | OpenAPI 语法 | YAML、`$ref`、path 参数、lint 通过 |  |  |
 | P0 覆盖 | 每个 P0 需求有 endpoint/schema/error/test 或明确非目标 |  |  |
-| 交互输入完整 | Draft 已同时依据 PRD、产品总体设计、交互说明、原型/线框、状态矩阵和 prototype-review；缺任一项需说明无 UI 影响或返回上游补齐 |  |  |
+| 产品总体设计完整 | Draft 已依据 PRD 和产品总体设计 / 功能架构；缺产品总体设计时返回上游补齐 |  |  |
+| 交互输入完整 | 有 UI 时，Draft 已同时依据交互说明、原型/线框、状态矩阵、prototype-review、Ant Design v6 高保真 HTML 原型、AntD CLI 校验证据和用户确认记录；无 UI 时需说明页面 / 交互资产不适用原因 |  |  |
 | DDD 契约边界 | Endpoint/schema 归属的限界上下文清楚；术语与 `CONTEXT.md` 和功能架构一致；契约不直接暴露内部聚合、Repository 或持久化表结构 |  |  |
 | 页面动作覆盖 | 每个按钮 / 抽屉 / 弹窗动作有 endpoint/non-goal、`actionKey`、权限和错误码 |  |  |
 | 对象生命周期 | manage/maintain/configure/create/update/archive/retry/cancel/publish/export/create-draft 语义闭环 |  |  |

package/template/docs/design/README.md

@@ -7,7 +7,11 @@
 - `docs/design/design.md`：从本地 `Product-Design-System` 引入并整理的 Ant Design 企业级设计系统说明，后续页面设计、交互说明、原型评审和前端实现默认引用该文件。
 - `docs/design/tokens/`：随仓库保存的主题、亮色 / 暗色 / 紧凑 token 和 CSS 变量快照，后续实现不得依赖本机 Downloads 目录。
 
-进入 API 影响分析 / 契约草案前，有用户界面的功能建议先沉淀：
+产品原型产出默认以 `product-design:index` 为主入口。该 skill 只负责路由，实际按 Product Design plugin 规则进入 `$get-context`、`$ideate`、`$prototype`、`$image-to-code`、`$url-to-code`、`$share` 或 `$design-qa` 等 focused skill；YSS 生命周期仍负责校验低保真评审、高保真 HTML 原型、AntD CLI 校验证据、用户确认和 PRD / OpenAPI 回填。
+
+进入 PRD 初稿 / 需求基线流程后，必须先沉淀产品总体设计 / 功能架构，再进入页面 / 原型 / 交互设计、PRD 校准、API 影响分析 / 契约草案或实现。产品总体设计文档必须包含低保真原型 / 页面草图，用于验证页面结构、关键操作和主流程。无 UI 的功能也需要产品总体设计 / 功能架构来说明功能域、业务对象、模块边界、API / 数据影响和不适用的页面状态；只有不进入 PRD 生命周期的小改动可在影响面评估中记录不适用原因。
+
+进入 API 影响分析 / 契约草案前，有用户界面的功能还必须沉淀：
 
 - 页面清单和信息架构。
 - 用户主路径和异常路径。
@@ -16,30 +20,33 @@
 - 表单、表格、弹窗、抽屉、步骤流等交互说明。
 - loading、empty、error、readonly、disabled、no-permission、conflict 等状态矩阵。
 - 页面字段、筛选条件、操作按钮和权限规则。
+- 低保真原型评审通过后的 Ant Design v6 高保真可交互 HTML 原型，默认路径为 `docs/design/prototypes/<feature>/index.html`；该产物可由系统 / Agent 自动生成，不要求用户手工提供，产出前必须使用 `antd` CLI 查询设计语言、组件 API、demo、token 和 semantic 信息，产出后必须记录 AntD v6 校验证据并获得用户确认。
 
 这些资产用于反推 API 影响、契约草案、OpenAPI 请求 / 响应字段、错误结构、分页筛选、权限状态和前端验收标准。
 
 推荐模板：
 
-- `docs/design/templates/product-overview-design-template.md`：PRD 初稿之后、页面 / 原型 / 交互设计之前，用于团队评审产品总体设计、功能架构、页面/API/数据影响和 PRD 回填项；它是原型设计输入，不是交互说明本身。
+- `docs/design/templates/product-overview-design-template.md`：PRD 初稿之后、页面 / 原型 / 交互设计之前，用于团队评审产品总体设计、功能架构、低保真原型、页面/API/数据影响和 PRD 回填项；它是后续交互设计输入，不替代详细交互说明。
 - `docs/design/templates/interaction-spec-template.md`：页面、流程、交互、PRD 回填项和 OpenAPI 反推清单。
 - `docs/design/templates/state-matrix-template.md`：loading、empty、error、readonly、no-permission、conflict 等状态。
 - `docs/design/templates/prototype-review-checklist.md`：进入 PRD 校准 / API 影响分析 / 契约草案前的原型评审门禁。
+- `docs/design/templates/prototype-confirmation-template.md`：高保真 HTML 原型产出后的用户确认记录。
 
 推荐技能：
 
 - `yss-design-system`：项目设计系统与 Ant Design 企业级 UI 风格基线；页面设计、原型评审、UI 实现和主题 token 落地时默认先引用。
-- `product-design-prototype`：基于 PRD 初稿和产品总体设计 / 功能架构，产出页面 / 原型 / 交互设计资产。
-- `wireframe-prototype`：低保真线框、Excalidraw、Figma、Penpot、tldraw、Axure 等原型链接沉淀。
-- `component-story-prototype`：Storybook / Histoire 工程态状态原型。
-- `mock-api-prototype`：MSW / mock fixtures 支撑未冻结 API 前的交互验证。
+- `product-design:index`：产品原型产出的主路由；根据输入是否有 URL、截图、Figma、代码目标或视觉方向，进入 `$get-context`、`$ideate`、`$prototype`、`$image-to-code`、`$url-to-code`、`$share` 或 `$design-qa` 等 focused skill。
+- Product Design focused skills：基于 PRD 初稿和产品总体设计 / 功能架构，产出低保真 / 高保真页面、原型、交互设计资产和可分享原型；高保真 HTML 原型默认由该路由链路产出。
+- `antd`：Ant Design v6 组件、demo、token、semantic 和 design.md 查询工具；生成或修改高保真 HTML 原型前后必须留下 CLI 校验证据。
 - `prototype-review`：原型阶段评审门禁；未通过则不要进入 PRD 校准 / API 影响分析 / 契约草案。
+- 兼容入口：`product-design-prototype`、`wireframe-prototype`、`high-fidelity-html-prototype` 仅作为历史兼容或产物门禁名称保留；新的产品原型产出默认使用 `product-design:index`。
 - `excalidraw-diagram-generator`：根据已形成的 Discovery、PRD、OpenAPI Draft、Architecture 或 系统 / 数据架构设计 生成 `.excalidraw` 图；用于说明和审查，不替代文本规格。
 
 推荐目录：
 
 ```text
 docs/design/diagrams/
+docs/design/prototypes/
 docs/architecture/diagrams/
 docs/discovery/diagrams/
 ```

package/template/docs/design/prototypes/.gitkeep

@@ -0,0 +1 @@
+

package/template/docs/design/templates/interaction-spec-template.md

@@ -1,15 +1,19 @@
 # <功能名称> 交互说明模板
 
-> 适用时机：PRD 初稿之后、PRD 校准 / API 影响分析 / 契约草案之前；仅用于有用户界面影响的功能。
+> 适用时机：PRD 初稿和产品总体设计 / 功能架构完成之后，PRD 校准 / API 影响分析 / 契约草案之前；仅用于有用户界面影响的功能。
 
 ## 1. 输入资产
 
 | 资产 | 路径 / 链接 | 说明 |
 |---|---|---|
 | PRD 初稿 | `docs/requirements/<feature>-prd.md` | 原型评审后需要回填和校准 |
+| 产品总体设计 / 功能架构 | `docs/design/<feature>-product-overview-design.md` | 必需；缺失时先返回产品总体设计阶段 |
 | 领域术语 | `CONTEXT.md` | 核心名词、状态和业务规则 |
 | Discovery | `docs/discovery/<feature>-discovery.md` | 可选 |
+| Product Design 路由 | `product-design:index -> <focused skill>` | 必需；记录 `$get-context`、`$ideate`、`$prototype`、`$image-to-code` 或 `$url-to-code` |
 | 原型 / 线框图 | `<链接或导出图片路径>` | Excalidraw / Figma / Penpot / tldraw / Axure / Markdown |
+| 高保真 HTML 原型 | `docs/design/prototypes/<feature>/index.html` | 低保真原型评审通过后补齐；必须使用 Ant Design v6；可由系统 / Agent 自动产出；产出后必须获得用户确认 |
+| AntD CLI 校验证据 | `<命令输出或记录路径>` | `antd design.md/info/demo/token/semantic --version 6.0.0 --format json` |
 | 现有 API 草案 | `docs/api/specs/<feature>.yaml` | 可选；通常应先完成产品设计和 PRD 校准 |
 
 ## 2. 页面地图
@@ -99,9 +103,10 @@
 ## 8. 前端验收
 
 - loading、empty、error、no-permission、readonly、conflict、dirty-form 状态已展示，或明确不适用。
-- 每个表格列、筛选条件、表单字段、抽屉、弹窗和按钮都有数据来源或 mock fixture。
+- 每个表格列、筛选条件、表单字段、抽屉、弹窗和按钮都有数据来源或契约反推说明。
 - 设计可以拆成独立可演示的垂直切片。
-- 如果需要工程态原型，已规划 Storybook / Histoire 或静态 fixture。
+- 低保真原型评审通过后，高保真 HTML 原型使用 Ant Design v6 覆盖主流程、关键状态和响应式断点。
+- 原型产出前已使用 `antd` CLI 查询设计语言、组件 API、demo、token 和 semantic 信息；原型产出后已记录 AntD v6 校验证据。
 
 ## 9. 决策与未决问题
 

package/template/docs/design/templates/product-overview-design-template.md

@@ -8,7 +8,7 @@ owner: ai
 # <功能名称> 产品总体设计与功能架构
 
 > 适用时机：PRD 初稿之后、页面 / 原型 / 交互设计之前。
-> 本文用于明确功能域、模块边界、MVP 范围、页面清单、状态 / 权限影响、OpenAPI 反推点和 PRD 回填项；它是页面 / 原型 / 交互设计的上游输入，不替代 PRD、交互说明、契约草案 / OpenAPI Draft 或系统概要设计。
+> 本文用于明确功能域、模块边界、MVP 范围、页面清单、低保真原型、状态 / 权限影响、OpenAPI 反推点和 PRD 回填项；它是页面 / 原型 / 交互设计的上游输入，不替代 PRD、交互说明、契约草案 / OpenAPI Draft 或系统概要设计。
 
 ## 1. 输入资产
 
@@ -68,30 +68,59 @@ owner: ai
 |------|----------|----------|----------|------------------|------|
 |  |  |  |  |  |  |
 
-## 8. PRD 回填项
+## 8. 低保真原型 / 页面草图
+
+> 本节用于在产品总体设计阶段先验证页面结构、核心操作和跨页面流转，不展开到高保真视觉、组件实现或完整字段级交互；后续页面 / 原型 / 交互设计需基于本节继续细化。无 UI 功能仍保留本节，用流程 / 能力草图和“不适用原因”说明用户或系统如何完成任务。
+
+### 8.1 页面地图
+
+| 页面 / 区域 | 入口 | 核心任务 | 关键操作 | 下一步 |
+|-------------|------|----------|----------|--------|
+|  |  |  |  |  |
+
+### 8.2 低保真线框
+
+```text
+页面名称：
+
+[导航 / 面包屑]
+[查询 / 筛选区域]
+[主内容区域：表格 / 表单 / 画布 / 列表]
+[操作区：主按钮 / 次按钮 / 更多操作]
+[反馈区：校验结果 / 错误提示 / 空态]
+```
+
+### 8.3 原型评审关注点
+
+| 页面 / 流程 | 需要验证的问题 | 关联 P0 需求 | 关联 API / 数据 / 权限影响 | 后续交互设计待细化 |
+|-------------|----------------|--------------|-----------------------------|--------------------|
+|  |  |  |  |  |
+
+## 9. PRD 回填项
 
 | 编号 | 回填内容 | 影响章节 | 优先级 | 状态 |
 |------|----------|----------|--------|------|
 |  |  |  |  | 待确认 / 已回填 |
 
-## 9. 开放问题与决策
+## 10. 开放问题与决策
 
 | 问题 / 决策 | 选项 | 建议 | 负责人 | 截止点 | 状态 |
 |-------------|------|------|--------|--------|------|
 |  |  |  |  | PRD 校准前 / API 影响分析前 | 待确认 |
 
-## 10. 评审清单
+## 11. 评审清单
 
 - [ ] 用户主流程和异常路径已覆盖 MVP。
 - [ ] 业务对象、状态和关系不会与 `CONTEXT.md` 术语冲突。
 - [ ] 功能域、模块边界和优先级清楚。
 - [ ] Strategic DDD Check 已完成，或明确说明本次变更不影响领域边界。
 - [ ] 页面、API、数据、权限和审计影响已显式标注。
+- [ ] 低保真原型 / 页面草图已覆盖 P0 页面、主流程和关键异常路径，并能支撑后续交互设计。
 - [ ] PRD 回填项已列出，并分清阻断项和非阻断项。
 - [ ] 安全红线已标记 `TODO-HUMAN-REVIEW`。
 - [ ] 可进入页面 / 原型 / 交互设计，或明确阻断项。
 
-## 11. 结论
+## 12. 结论
 
 - 评审结论：Approved / Blocked
 - 阻断项：

package/template/docs/design/templates/prototype-confirmation-template.md

@@ -0,0 +1,57 @@
+# <功能名称> 高保真原型确认记录
+
+> 适用时机：Ant Design v6 高保真 HTML 原型产出后、PRD 校准 / 需求冻结 / UI 驱动 OpenAPI Draft 前。未确认前不得进入下游门禁。
+
+## 1. 原型信息
+
+| 项目 | 内容 |
+|---|---|
+| 功能名称 |  |
+| PRD | `docs/requirements/<feature>-prd.md` |
+| 产品总体设计 / 功能架构 | `docs/design/<feature>-product-overview-design.md` |
+| 交互说明 | `docs/design/<feature>-interaction-spec.md` |
+| 状态矩阵 | `docs/design/<feature>-state-matrix.md` |
+| 原型评审 | `docs/design/<feature>-prototype-review.md` |
+| 高保真 HTML 原型 | `docs/design/prototypes/<feature>/index.html` |
+| Product Design 路由 | `product-design:index -> <focused skill>` |
+| 产出方式 | 系统 / Agent 自动产出 / 人工补充 |
+| Ant Design 版本 | v6 |
+
+## 2. AntD CLI 校验证据
+
+| 校验项 | 命令 / 记录路径 | 结论 |
+|---|---|---|
+| 设计语言 | `antd design.md --version 6.0.0 --format json` |  |
+| 组件 API | `antd info <Component> --version 6.0.0 --format json` |  |
+| 组件 demo | `antd demo <Component> <demo> --version 6.0.0 --format json` |  |
+| 组件 token | `antd token <Component> --version 6.0.0 --format json` |  |
+| semantic | `antd semantic <Component> --version 6.0.0 --format json` |  |
+| lint / 替代校验 | `antd lint <prototype path> --format json` |  |
+
+## 3. 用户确认
+
+| 项目 | 内容 |
+|---|---|
+| 确认人 |  |
+| 确认时间 |  |
+| 确认方式 | 口头 / 评论 / Issue / 会议纪要 / 其他 |
+| 确认结论 | 通过 / 需调整 / 暂缓 |
+| 是否允许进入 PRD 校准 | 是 / 否 |
+| 是否允许进入 API 影响分析 / OpenAPI Draft | 是 / 否 |
+
+## 4. 调整项
+
+| 序号 | 调整内容 | 优先级 | 负责人 | 状态 |
+|---|---|---|---|---|
+| 1 |  | P0 / P1 / P2 |  |  |
+
+## 5. 结论
+
+```text
+确认结论：
+允许进入下一阶段：是 / 否
+阻断原因：
+- 
+补充说明：
+- 
+```

package/template/docs/design/templates/prototype-review-checklist.md

@@ -1,6 +1,6 @@
 # <功能名称> 原型评审清单
 
-> 适用时机：配合 `prototype-review` 使用。评审采用 fail-closed：有阻断项时必须回到产品设计阶段，不能进入 PRD 校准或 API 影响分析 / 契约草案。
+> 适用时机：配合 `prototype-review` 使用。评审采用 fail-closed：有阻断项时必须回到产品设计阶段；产品原型产出以 `product-design:index` 路由到 Product Design focused skill 为主；低保真评审通过后必须产出高保真 HTML 原型，可由系统 / Agent 自动产出；产出后必须获得用户确认，确认前不能直接进入 PRD 校准或 API 影响分析 / 契约草案。
 
 ## 评审输入
 
@@ -10,6 +10,8 @@
 | 交互说明 | `docs/design/<feature>-interaction-spec.md` |  |
 | 原型 / 线框图 | `<链接或导出图片路径>` |  |
 | 状态矩阵 | `docs/design/<feature>-state-matrix.md` |  |
+| Product Design 路由记录 | `product-design:index -> <focused skill>` |  |
+| AntD CLI 校验证据 | `<命令输出或记录路径>` |  |
 | 现有 API 草案 | `docs/api/specs/<feature>.yaml` | 可选 |
 
 ## 门禁清单
@@ -24,7 +26,9 @@
 | 权限行为能区分隐藏、禁用和调用后拒绝 |  |  |
 | 校验错误能区分模型级和字段级展示位置 |  |  |
 | 能从界面需求反推出 API 影响和契约草案 |  |  |
-| 前端验收、Storybook / Histoire 或 mock 数据需要已明确 |  |  |
+| AntD v6 设计语言、组件 API、demo、token 和 semantic 已用 `antd` CLI 查询并记录 |  |  |
+| 高保真 HTML 原型未使用旧原型技能作为主入口，已通过 `product-design:index` 路由产出或记录例外原因 |  |  |
+| 前端验收、组件状态和数据依赖已明确 |  |  |
 | 安全红线已标记人工审查 |  |  |
 
 ## PRD 校准就绪度
@@ -59,5 +63,5 @@
 非阻断建议：
 - 
 下一步：
-- PRD 校准 / API 影响分析 / 契约草案 / 回到 product-design-prototype / component-story-prototype / mock-api-prototype
+- product-design:index 路由高保真 HTML 原型产出 / 回到 Product Design focused skill 补齐原型 / 进入用户确认
 ```

package/template/docs/design/templates/state-matrix-template.md

@@ -1,6 +1,6 @@
 # <功能名称> 状态矩阵模板
 
-> 适用时机：配合 `product-design-prototype` 使用，在 PRD 校准和 API 影响分析 / 契约草案之前补齐页面状态。
+> 适用时机：配合 `product-design:index` 路由后的 Product Design focused skill 使用，在 PRD 校准和 API 影响分析 / 契约草案之前补齐页面状态。
 
 | 页面 / 组件 | 状态 | 触发条件 | 界面行为 | API / 数据要求 | 验收点 |
 |---|---|---|---|---|---|

package/template/docs/process/harness-executive-blueprint.md

@@ -13,7 +13,7 @@ AI 不能只作为一次性辅助工具使用。Harness 工程的目标，是把
 ```text
 机会 / 问题收集
 → 需求澄清
-→ PRD + 原型并行
+→ PRD -> 产品总体设计 -> 原型校准
 → SDD 研发规范基线
 → DDD 领域建模
 → 架构设计
@@ -31,6 +31,7 @@ AI 不能只作为一次性辅助工具使用。Harness 工程的目标，是把
 ## 哪些门禁不能跳
 
 - API 变化必须先有 API 影响记录和契约草案 / review-only OpenAPI Draft，并在实现或生成客户端前完成 Freeze 或记录无 API 影响。
+- 进入 PRD 初稿 / 需求基线流程后，必须先有产品总体设计 / 功能架构，才能进入页面 / 原型 / 交互设计、OpenAPI Draft、PRD 校准、需求冻结或实现；不进入 PRD 生命周期的小改动才可记录不适用原因。
 - 正式垂直切片前必须有 active Issue change 和完整 change 资产。
 - 架构、数据、ADR、工程基线和安全红线必须进入 Build Architecture Checklist。
 - 支付、迁移、认证授权、加密、SQL、公共基础库 API 等安全红线必须人工审查。
@@ -43,6 +44,10 @@ AI 不能只作为一次性辅助工具使用。Harness 工程的目标，是把
 
 ```text
 PRD
+→ 产品总体设计 / 功能架构
+→ 页面 / 原型 / 交互设计与 prototype-review（有 UI 时）
+→ product-design:index 路由 Product Design focused skill 产出 Ant Design v6 高保真 HTML 原型（有 UI 时）
+→ antd CLI 校验证据与用户确认记录（有 UI 时）
 → API 影响分析 / 契约草案
 → review-only OpenAPI Draft（如需要）
 → Issue Change

package/template/docs/process/harness-process-tailoring.md

@@ -16,9 +16,9 @@
 
 | 当前输入 / 变更事实 | 最近可信阶段 | 需要补齐的下游 |
 |---|---|---|
-| 只有模糊想法、业务机会或竞品输入 | 2. 机会与 Discovery | Discovery、`grill-with-docs`、PRD、业务 / 功能架构 |
-| 已有清晰 PRD，但用户、痛点、MVP 或非目标不稳 | 3. 业务 / PRD / 功能架构 | PRD Review、功能架构、必要的产品设计 |
-| 有 UI 变更但缺页面流、状态矩阵或原型评审 | 4. 产品设计与需求冻结 | 交互说明、状态矩阵、Prototype Review、PRD 回填 |
+| 只有模糊想法、业务机会或竞品输入 | 2. 机会与 Discovery | Discovery、`grill-with-docs`、PRD、产品总体设计 / 功能架构 |
+| 已有清晰 PRD，但用户、痛点、MVP 或非目标不稳 | 3. 业务 / PRD / 功能架构 | PRD Review、产品总体设计 / 功能架构、必要的页面 / 原型 / 交互设计 |
+| 有 UI 变更但缺页面流、状态矩阵、原型评审、高保真 HTML 原型、AntD CLI 校验证据或用户确认记录 | 4. 产品设计与需求冻结 | 交互说明、状态矩阵、Prototype Review、Ant Design v6 高保真 HTML 原型（可在低保真评审通过后由系统 / Agent 自动产出）、AntD CLI 校验证据、用户确认记录、PRD 回填 |
 | API 路径、schema、错误结构、分页或权限发生变化 | 5. 系统 / 数据架构与工程契约设计审查 | API 影响记录、契约草案 / OpenAPI Draft Review、必要时 Spec Delta、系统 / 数据架构反审、Freeze、`to-issues` |
 | 服务边界、集成、部署、性能、可靠性或运维变化 | 5. 系统 / 数据架构与工程契约设计审查 | 系统架构、Design Review、必要时 Spec Delta、Build Architecture Checklist |
 | 持久化、元数据、版本、血缘、搜索、索引或迁移变化 | 5. 系统 / 数据架构与工程契约设计审查 | 数据架构、必要时 Spec Delta、人审点、Repository / MyBatis 前置审查 |

package/template/docs/process/harness-work-unit-map.md

@@ -14,7 +14,7 @@
 |---|---|---|---|---|---|---|
 | 0. 机会 / 问题收集 | 1. 入口分诊；2. 机会与 Discovery | 0. 入口分诊；1. 机会探索 | 分诊结论、Discovery 收敛、MVP 边界 | `yss-product-lifecycle`、`competitive-intelligence`、Discovery 模板 | 小改动可跳过；新产品 / 新模块必需 | 半自动生成分诊清单、竞品情报简报和 Discovery 模板 |
 | 1. 需求澄清 | 3. 业务 / PRD / 功能架构 | 3. 需求澄清 | 澄清记录、用户 / 痛点 / 验收标准 | `grill-with-docs`、`to-prd` | 小文案 / 单点 bug 可轻量化 | 半自动生成澄清问题和缺口清单 |
-| 2. PRD + 原型并行 | 3. 业务 / PRD / 功能架构；4. 产品设计与需求冻结 | 4. 需求基线 / 功能架构；5. 页面 / 原型 / 交互设计；6. 原型评审；7. PRD 校准 / 需求冻结 | PRD、页面清单、状态矩阵、原型评审、需求冻结 | `yss-design-system`、`product-design-prototype`、`prototype-review` | 无 UI 可省略原型；中等变更只补受影响页面 | 半自动检查 PRD 字段、状态矩阵和原型评审项 |
+| 2. PRD -> 产品总体设计 -> 原型校准 | 3. 业务 / PRD / 功能架构；4. 产品设计与需求冻结 | 4. 需求基线 / 功能架构；5. 页面 / 原型 / 交互设计；6. 原型评审；7. PRD 校准 / 需求冻结 | PRD、产品总体设计 / 功能架构、低保真原型、页面清单、状态矩阵、原型评审、Ant Design v6 高保真 HTML 原型、AntD CLI 校验证据、用户确认记录、需求冻结 | `yss-design-system`、`product-design:index`、Product Design focused skills（`$get-context` / `$ideate` / `$prototype` / `$image-to-code` / `$url-to-code`）、`antd`、`prototype-review` | 无 UI 可省略后续交互原型；进入 PRD 初稿 / 需求基线流程时不得省略产品总体设计及其低保真原型；有 UI 时产品原型产出以 `product-design:index` 路由为主，低保真评审通过后不得省略高保真 HTML 原型，可由系统 / Agent 自动产出，产出前后必须使用 `antd` CLI 校验并在产出后获得用户确认；中等变更只补受影响页面 | 半自动检查 PRD 字段、产品总体设计、低保真原型、状态矩阵、原型评审、高保真 HTML 原型、AntD CLI 校验证据和用户确认记录 |
 | 3. SDD 研发规范基线 | 5. 系统 / 数据架构与工程契约设计审查；6. 契约冻结与 Issue | 8. API 影响分析 / 契约草案；9. 工程基线；13. 契约冻结；14. Issue formalization | API 影响记录、契约草案 / OpenAPI Draft / Freeze、Spec Delta、工程基线、垂直切片 Issue、实施路由、验证证据 | `to-issues`、`yss-router` | 无 API / 无工程边界变化时记录无影响结论；低风险小改动跳过 Spec Delta | 自动检查 OpenAPI Freeze / no API impact / Spec Delta / vertical slice Issue / implementation routing |
 | 4. DDD 领域建模 | 3. 业务 / PRD / 功能架构；5. 系统 / 数据架构与工程契约设计审查 | 2. 业务架构；10. 系统总体架构；11. 数据架构 | CONTEXT 术语、业务能力、领域边界、聚合 / 状态规则 | `domain-modeling`、`yss-domain-modeling`、`yss-domain` | 小改动只校验是否影响既有术语或边界 | 半自动检查术语回填和领域边界审查项 |
 | 5. 架构设计 | 5. 系统 / 数据架构与工程契约设计审查 | 8. API 影响分析 / 契约草案；9. 工程基线；10. 系统总体架构；11. 数据架构；12. 设计审查 | API 影响记录、工程基线、系统概要设计、数据架构、ADR 候选、架构评审 | `codebase-design`、`improve-codebase-architecture`、YSS 架构模板 | 不触碰 API、工程边界、服务边界、数据、NFR、部署时可轻量记录无影响 | 半自动生成 Architecture Review checklist |

package/template/docs/process/lifecycle-artifact-map.md

@@ -22,8 +22,8 @@ owner: ai
 |---|---|---|---|---|
 | 1. 入口分诊 | 判断任务类型、风险等级、最近可信阶段和最小技能集 | 分诊结论或 issue 备注 | `yss-product-lifecycle` 路由结果、Git checkpoint 判断 | 是否需要 Discovery / PRD / API / 架构 / Issue |
 | 2. 机会与 Discovery | 收敛用户、痛点、为什么现在做、MVP、非目标、成功标准、产品功能指引和下游影响信号 | `docs/discovery/<feature>-discovery.md` 或等价说明 | `competitive-intelligence` 竞品情报、竞品矩阵、机会说明、产品功能指引、下游影响清单、市场分析、用户痛点文档 | 是否足以进入业务架构和 PRD |
-| 3. 业务 / PRD / 功能架构 | 明确产品边界、用户旅程、功能域、模块边界、优先级和验收标准 | `docs/requirements/<feature>-prd.md` | `grill-with-docs` 澄清记录、业务架构、功能架构、CONTEXT 术语回填 | PRD Review / 产品设计准备度 |
-| 4. 产品设计与需求冻结 | 对 UI、页面流、状态矩阵、异常路径和 PRD 回填做闭环 | 有 UI 时：交互说明和原型评审结论；无 UI 时：需求冻结记录 | 状态矩阵、页面地图、原型链接 | PRD 校准 / 工程契约与架构设计准备度 |
+| 3. 业务 / PRD / 功能架构 | 明确产品边界、用户旅程、功能域、模块边界、优先级、低保真原型和验收标准 | `docs/requirements/<feature>-prd.md`；`docs/design/<feature>-product-overview-design.md` | `grill-with-docs` 澄清记录、业务架构、CONTEXT 术语回填；不进入 PRD 生命周期的小改动可记录不适用原因 | PRD Review / 产品总体设计评审 / 产品设计准备度 |
+| 4. 产品设计与需求冻结 | 基于 PRD 初稿和产品总体设计，对 UI、页面流、状态矩阵、异常路径、高保真体验和 PRD 回填做闭环 | 有 UI 时：交互说明、低保真原型评审结论、Ant Design v6 高保真 HTML 原型（可由系统 / Agent 在低保真评审通过后自动产出）、AntD CLI 校验证据和用户确认记录；无 UI 时：需求冻结记录 | 状态矩阵、页面地图、原型链接 | PRD 校准 / 工程契约与架构设计准备度 |
 | 5. 系统 / 数据架构与工程契约设计审查 | 合并 API 影响分析、契约草案、工程基线、系统架构、数据架构和 Design Review；Draft 仅用于评审，Freeze 前不得作为实现或生成客户端契约 | 系统概要设计或等价架构记录；Design Review 结论；有 API 时：API 影响记录和契约草案 / review-only OpenAPI Draft；有后端结构影响时：工程基线审查 | OpenAPI Draft Review、OpenSpec-style Spec Delta、工程基线审查、无 API 影响记录、数据架构、ADR、架构图 | OpenAPI Freeze 准备度 |
 | 6. 契约冻结与 Issue formalization | 冻结契约并把交付范围转成可执行 Issue，并明确受影响前后端工程是否已存在 | OpenAPI Freeze 记录或无 API 影响记录；垂直切片 Issue 入口 | `to-issues` 输出、实施路由记录、实现仓库 / 脚手架判定、Issue tracker 同步 | 垂直切片准备度 |
 | 7. 垂直切片与 TDD 实现 | 将冻结范围拆成端到端切片并按 TDD 实现 | 垂直切片 Issue、实施计划、Build Architecture Checklist、测试 / 验证记录 | YSS skill routing、前后端脚手架初始化记录、`implement` / `tdd` 证据、`code-review` 报告、清理简化记录、Architecture Re-check | Fresh verification / Release Review |
@@ -37,9 +37,9 @@ owner: ai
 | 1. 机会探索 | 2. 机会与 Discovery | 机会输入、MVP 边界、非目标范围 | 新产品 / 新模块必需 |
 | 2. 业务架构 | 3. 业务 / PRD / 功能架构 | 业务架构或 PRD 中等价章节 | 新产品 / 新业务域必需 |
 | 3. 需求澄清 | 3. 业务 / PRD / 功能架构 | `grill-with-docs` 结论或等价澄清记录 | 新功能 / 较大改动必需 |
-| 4. 需求基线 / 功能架构 | 3. 业务 / PRD / 功能架构 | PRD、功能域、模块边界、验收标准 | 新功能 / 较大改动必需 |
-| 5. 页面 / 原型 / 交互设计 | 4. 产品设计与需求冻结 | 交互说明、页面清单、状态矩阵 | 有 UI 时必需 |
-| 6. 原型评审 | 4. 产品设计与需求冻结 | Prototype Review 结论 | 有 UI 时必需 |
+| 4. 需求基线 / 功能架构 | 3. 业务 / PRD / 功能架构 | PRD；产品总体设计 / 功能架构资产；功能域、模块边界、低保真原型、验收标准 | 进入 PRD 初稿 / 需求基线流程时必需 |
+| 5. 页面 / 原型 / 交互设计 | 4. 产品设计与需求冻结 | 基于 PRD 初稿和产品总体设计 / 功能架构产出的交互说明、页面清单、状态矩阵 | 有 UI 时必需；缺产品总体设计时阻断 |
+| 6. 原型评审 | 4. 产品设计与需求冻结 | Prototype Review 结论；通过后必须产出 Ant Design v6 高保真 HTML 原型，可由系统 / Agent 自动生成；必须记录 AntD CLI 校验证据；产出后必须获得用户确认 | 有 UI 时必需 |
 | 7. PRD 校准 / 需求冻结 | 4. 产品设计与需求冻结 | 需求冻结记录或校准后的 PRD | 必需；无 UI 可轻量化 |
 | 8. API 影响分析 / 契约草案 | 5. 系统 / 数据架构与工程契约设计审查 | API 影响记录、契约草案 / OpenAPI Draft 或无 API 影响记录；Draft 在 Freeze 前仅可评审；中高风险变更补 OpenSpec-style Spec Delta | 有 API 影响时必需；Spec Delta 条件必需 |
 | 9. 工程基线 | 5. 系统 / 数据架构与工程契约设计审查 | 工程基线 / YSS DDD Review | 新服务 / 新模块 / 后端结构变化时必需 |
@@ -69,6 +69,8 @@ owner: ai
 | 交互说明 | `docs/design/<feature>-interaction-spec.md` | `docs/design/templates/interaction-spec-template.md` |
 | 状态矩阵 | `docs/design/<feature>-state-matrix.md` | `docs/design/templates/state-matrix-template.md` |
 | 原型评审 | `docs/design/<feature>-prototype-review.md` | `docs/design/templates/prototype-review-checklist.md` |
+| 高保真 HTML 原型 | `docs/design/prototypes/<feature>/index.html` | `product-design:index` 路由到 Product Design focused skill 产出 |
+| 高保真原型确认记录 | `docs/design/<feature>-prototype-confirmation.md` | `docs/design/templates/prototype-confirmation-template.md` |
 | 需求冻结 | `docs/requirements/<feature>-requirement-freeze.md` | `docs/templates/requirement-freeze-template.md` |
 | API 影响分析 / 契约草案 / OpenAPI Draft | API 影响记录、issue note 或 `docs/api/specs/<feature>.yaml` | `docs/templates/openapi-spec-template.yaml` |
 | OpenSpec-style Spec Delta | `docs/specs/<feature>-spec-delta.md` | `docs/templates/spec-delta-template.md` |

package/template/docs/process/product-prototype-workflow.md

@@ -0,0 +1,82 @@
+# 产品原型工作流
+
+本文定义 YSS Harness 中有 UI 功能的最小产品原型链路。目标是用 `grill-with-docs` 问清需求，用 `product-design:index` 统一原型产出入口，用 `antd` CLI 固化 Ant Design v6 事实校验，并由 YSS 生命周期负责评审、用户确认和 PRD / OpenAPI 回填。
+
+## 适用范围
+
+- 新产品、新模块或较大 UI 功能。
+- 影响主流程、权限状态、异常状态、页面导航或 OpenAPI 反推清单的 UI 变更。
+- 已进入 PRD 初稿 / 需求基线流程，且存在用户界面的功能。
+
+小文案、局部样式、配置微调或不进入 PRD 生命周期的低风险变更，可在影响面评估中说明不适用。
+
+## 标准链路
+
+```text
+grill-with-docs
+-> PRD / 产品总体设计
+-> yss-design-system
+-> product-design:index
+-> Product Design focused skills
+-> antd CLI 校验
+-> prototype-review
+-> 用户确认
+-> PRD 校准 / OpenAPI Draft
+```
+
+## 职责边界
+
+| 环节 | 主入口 | 职责 |
+|---|---|---|
+| 需求质询 | `grill-with-docs` | 澄清用户、痛点、边界、反例、验收标准和领域术语 |
+| 设计系统基线 | `yss-design-system` | 固定 YSS / Ant Design 企业级设计风格、token 和组件使用约束 |
+| 原型路由 | `product-design:index` | 根据输入路由到 Product Design focused skill；不直接承担产出 |
+| 原型产出 | `$get-context` / `$ideate` / `$prototype` / `$image-to-code` / `$url-to-code` | 产出低保真 / 高保真页面、交互说明、可演示原型和可分享资产 |
+| AntD 事实校验 | `antd` CLI | 查询 Ant Design v6 设计语言、组件 API、demo、token 和 semantic 信息 |
+| 阶段评审 | `prototype-review` | Fail-closed 评审页面流、状态矩阵、权限、异常、OpenAPI 反推和验收标准 |
+| 用户确认 | `docs/design/templates/prototype-confirmation-template.md` | 记录高保真 HTML 原型是否被用户确认，并决定能否进入 PRD 校准 / OpenAPI Draft |
+
+## 产物要求
+
+有 UI 的功能至少沉淀：
+
+- PRD 初稿：`docs/requirements/<feature>-prd.md`
+- 产品总体设计 / 功能架构：`docs/design/<feature>-product-overview-design.md`
+- 交互说明：`docs/design/<feature>-interaction-spec.md`
+- 状态矩阵：`docs/design/<feature>-state-matrix.md`
+- 原型评审：`docs/design/<feature>-prototype-review.md`
+- 高保真 HTML 原型：`docs/design/prototypes/<feature>/index.html`
+- 用户确认记录：`docs/design/<feature>-prototype-confirmation.md`
+
+高保真 HTML 原型必须使用 Ant Design v6。系统 / Agent 可以自动产出，但产出后必须获得用户确认并记录确认结果；未确认前不得进入 PRD 校准、需求冻结或 UI 驱动 OpenAPI Draft。
+
+## AntD CLI 门禁
+
+原型产出前，必须按涉及组件查询 Ant Design v6 事实，不得凭记忆写组件 API：
+
+```bash
+antd design.md --version 6.0.0 --format json
+antd info <Component> --version 6.0.0 --format json
+antd demo <Component> <demo> --version 6.0.0 --format json
+antd token <Component> --version 6.0.0 --format json
+antd semantic <Component> --version 6.0.0 --format json
+```
+
+原型产出后，必须记录：
+
+- 查询过的组件和命令。
+- 采用的 demo / token / semantic 结论。
+- `antd lint <prototype path> --format json` 的结果；若原型目录不支持 lint，记录不适用原因和替代人工校验。
+
+## 回退规则
+
+- 需求边界不清：回到 `grill-with-docs`。
+- 缺产品总体设计 / 功能架构：回到 `docs/design/<feature>-product-overview-design.md`。
+- 没有视觉目标且需要新 UI：按 Product Design 规则先走 `$get-context`，再走 `$ideate`，展示 3 个视觉方向并等待用户选择。
+- 原型评审阻断：回到 Product Design focused skill 补齐页面流、状态矩阵、权限或异常路径。
+- 用户未确认：不得进入 PRD 校准 / OpenAPI Draft。
+- 触碰安全红线：标记 `TODO-HUMAN-REVIEW`，不得直接交付生产实现。
+
+## 兼容策略
+
+`product-design-prototype`、`wireframe-prototype`、`high-fidelity-html-prototype` 暂不物理删除，只作为历史兼容入口或产物门禁名称保留。新的产品原型产出默认使用 `product-design:index`。跑通 2 到 3 个真实 UI 功能后，再评估是否删除 legacy 技能。

package/template/docs/templates/requirement-freeze-template.md

@@ -7,7 +7,7 @@ owner: ai
 
 # <功能名称>需求冻结记录
 
-> 适用场景：PRD 初稿经过业务架构、功能架构、产品设计 / 原型评审后，需要冻结可进入 API 影响分析 / 契约草案和工程设计的范围。
+> 适用场景：PRD 初稿经过产品总体设计 / 功能架构、产品设计 / 原型评审后，需要冻结可进入 API 影响分析 / 契约草案和工程设计的范围。
 > 本文记录最终范围、回填项、非目标和开放问题，不替代 PRD。
 
 ## 1. 输入材料
@@ -15,8 +15,9 @@ owner: ai
 | 资产 | 路径 / 链接 | 状态 | 备注 |
 |------|-------------|------|------|
 | PRD 初稿 |  |  |  |
-| 业务 / 功能架构 |  |  |  |
+| 产品总体设计 / 功能架构 |  |  | 必需 |
 | 产品设计 / 交互说明 |  |  |  |
+| 高保真 HTML 原型 | `docs/design/prototypes/<feature>/index.html` |  | 有 UI 时必需；Ant Design v6 |
 | Prototype Review |  |  |  |
 | CONTEXT 术语 |  |  |  |
 
@@ -50,7 +51,7 @@ owner: ai
 
 ## 6. 完成标准
 
-- [ ] PRD 已吸收产品设计、原型评审和功能架构暴露的阻断项。
+- [ ] PRD 已吸收产品总体设计 / 功能架构、产品设计、低保真原型评审和高保真 HTML 原型暴露的阻断项。
 - [ ] 本轮做什么、不做什么、延后什么已经明确。
 - [ ] OpenAPI、工程基线、系统架构、数据架构、安全红线影响已有明确结论。
 - [ ] 可进入 API 影响分析 / 契约草案 / 工程基线，或阻断项已列出。