create-yss-spec 1.1.2 → 1.1.3

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

@@ -23,7 +23,7 @@ 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`；`docs/design/<feature>-product-overview-design.md` | `grill-with-docs` 澄清记录、业务架构、CONTEXT 术语回填；不进入 PRD 生命周期的小改动可记录不适用原因 | PRD Review / 产品总体设计评审 / 产品设计准备度 |
-| 4. 产品设计与需求冻结 | 基于 PRD 初稿和产品总体设计，对 UI、页面流、状态矩阵、异常路径、高保真体验和 PRD 回填做闭环 | 有 UI 时：交互说明、低保真原型评审结论、Ant Design v6 高保真 HTML 原型；无 UI 时：需求冻结记录 | 状态矩阵、页面地图、原型链接 | PRD 校准 / 工程契约与架构设计准备度 |
+| 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 |
@@ -39,7 +39,7 @@ owner: ai
 | 3. 需求澄清 | 3. 业务 / PRD / 功能架构 | `grill-with-docs` 结论或等价澄清记录 | 新功能 / 较大改动必需 |
 | 4. 需求基线 / 功能架构 | 3. 业务 / PRD / 功能架构 | PRD；产品总体设计 / 功能架构资产；功能域、模块边界、低保真原型、验收标准 | 进入 PRD 初稿 / 需求基线流程时必需 |
 | 5. 页面 / 原型 / 交互设计 | 4. 产品设计与需求冻结 | 基于 PRD 初稿和产品总体设计 / 功能架构产出的交互说明、页面清单、状态矩阵 | 有 UI 时必需；缺产品总体设计时阻断 |
-| 6. 原型评审 | 4. 产品设计与需求冻结 | Prototype Review 结论；通过后必须产出 Ant Design v6 高保真 HTML 原型 | 有 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,7 +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` | `high-fidelity-html-prototype` |
+| 高保真 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/user-guide/product-lifecycle-workflow.md

@@ -172,7 +172,7 @@ docs/process/lifecycle-artifact-map.md
 
 ### 6.3 设计产品和契约
 
-有 UI 时先走设计系统、产品设计、低保真原型评审和 Ant Design v6 高保真 HTML 原型。涉及 API 时，先生成 review-only OpenAPI Draft：
+有 UI 时先走设计系统、`product-design:index` 路由的产品设计、低保真原型评审、Ant Design v6 高保真 HTML 原型、AntD CLI 校验证据和用户确认记录。涉及 API 时，先生成 review-only OpenAPI Draft：
 
 ```text
 基于 PRD 和产品设计，生成 OpenAPI 3.1 Draft。
@@ -206,7 +206,7 @@ OpenAPI Freeze 或无 API 影响记录完成后使用 `to-issues`：
 
 - Draft 阶段允许调整接口，但不能被当成稳定实现契约。
 - Freeze 后的契约变更必须回到 API 影响分析、架构 / 数据设计和 Design Review，不能边写代码边悄悄改接口。
-- OpenAPI 不得只基于 PRD 反推：必须结合产品总体设计 / 功能架构；有 UI 时还必须结合页面 / 原型 / 交互说明、状态矩阵、低保真原型评审和 Ant Design v6 高保真 HTML 原型。
+- OpenAPI 不得只基于 PRD 反推：必须结合产品总体设计 / 功能架构；有 UI 时还必须结合页面 / 原型 / 交互说明、状态矩阵、低保真原型评审、Ant Design v6 高保真 HTML 原型、AntD CLI 校验证据和用户确认记录。
 - OpenAPI Freeze 后进入 `to-issues`，再进入前后端实现和契约测试。
 
 ## 8. 验证、发布和复盘

package/template/docs/user-guide/product-rd-lifecycle-best-practices.md

@@ -147,9 +147,9 @@ skills 是让 AI 按规程工作的“操作手册”，不是关键词装饰。
 | 模糊需求追问 | `grill-with-docs` | 先问清，不让 AI 猜规则；稳定术语写 `CONTEXT.md` |
 | 生成 PRD 初稿 / 需求基线 | `to-prd` 或 PRD 模板 | 只基于已确认事实，不把待确认项写成需求 |
 | 产品总体设计 / 功能架构 | `docs/design/templates/product-overview-design-template.md` | PRD 初稿后的必要产物；必须包含低保真原型 / 页面草图；进入页面 / 原型 / 交互设计、PRD 校准或 OpenAPI Draft 前必须完成 |
-| 页面和交互设计 | `product-design-prototype`、`wireframe-prototype`、`docs/design/` | 基于 PRD 初稿和产品总体设计细化页面流、状态和交互，再回填 PRD 并反推 API |
+| 页面和交互设计 | `product-design:index`、Product Design focused skills、`docs/design/` | 基于 PRD 初稿和产品总体设计细化页面流、状态和交互，再回填 PRD 并反推 API |
 | 原型评审 | `prototype-review` | 未通过时回到产品设计；通过后进入高保真 HTML 原型，不直接进入 PRD 校准 / API 影响分析 / 契约草案 |
-| 高保真 HTML 原型 | `high-fidelity-html-prototype` | 低保真评审通过后的强制产物；必须使用 Ant Design v6，并基于官方 `@ant-design/cli` / Ant Design For Agents 指引，输出 `docs/design/prototypes/<feature>/index.html` |
+| 高保真 HTML 原型 | `product-design:index` 路由到 Product Design focused skill；`antd` CLI | 低保真评审通过后的强制产物；必须使用 Ant Design v6，输出 `docs/design/prototypes/<feature>/index.html`，记录 AntD CLI 校验证据并获得用户确认 |
 | API 契约 | API 影响分析 / 契约草案 / OpenAPI Freeze 流程 | Draft 可讨论，Freeze 才可开发 |
 | 正式变更设计 | `to-issues` / Matt skills | 复用 PRD，聚焦技术方案、风险和测试 seam |
 | 拆切片 | `to-issues` | 必须是端到端垂直切片 |
@@ -471,17 +471,19 @@ docs/design/data-modeling-state-matrix.md
 docs/design/data-modeling-prototype-review.md
 ```
 
-推荐使用 `product-design-prototype` 作为入口，并按需要追加专项 skill：
+推荐使用 `product-design:index` 作为产品原型主入口，并按 Product Design plugin 规则路由到 focused skill：
 
 | 目标 | 推荐技能 / 工具 | 说明 |
 |---|---|---|
-| 页面清单、用户流、状态矩阵、PRD 回填项、OpenAPI 反推 | `product-design-prototype` | 基于 PRD 初稿和产品总体设计后的原型入口 |
-| 低保真线框、流程草图 | `wireframe-prototype`；Excalidraw / Markdown wireframe | 适合快速讨论，不绑定工程依赖 |
+| 页面清单、用户流、状态矩阵、PRD 回填项、OpenAPI 反推 | `product-design:index` -> `$get-context` / `$prototype` | 基于 PRD 初稿和产品总体设计后的原型入口 |
+| 低保真线框、流程草图 | `product-design:index` -> `$ideate` / `$prototype`；Excalidraw / Markdown wireframe | 适合快速讨论，不绑定工程依赖 |
 | 高保真或设计系统协作 | Figma / Penpot，必要时使用 `figma` / `figma-use` | 适合设计团队和组件规范沉淀 |
-| 高保真可交互 HTML 原型 | `high-fidelity-html-prototype`；Ant Design v6 | 低保真原型评审通过后的必需产物，用于 PRD 校准和 API 反推前的体验确认 |
+| 高保真可交互 HTML 原型 | `product-design:index` -> `$prototype` / `$image-to-code` / `$url-to-code`；`antd` CLI；Ant Design v6 | 低保真原型评审通过后的必需产物，用于 PRD 校准和 API 反推前的体验确认 |
 | 图谱、血缘、流程编排画布 | tldraw / xyflow | 适合数据血缘、任务流、关系图等画布型体验 |
 | 进入高保真前门禁 | `prototype-review` | 未通过则回到原型阶段 |
 
+`product-design-prototype`、`wireframe-prototype`、`high-fidelity-html-prototype` 仅作为历史兼容入口或产物门禁名称保留；新的产品原型产出默认使用 `product-design:index`。
+
 如果团队使用 Figma、即时设计、Axure 或其它原型工具，可以在 `docs/design/data-modeling-interaction-spec.md` 中保存链接、版本、评审记录和关键截图说明。第一版不强制引入 Excalidraw、Figma、Penpot、tldraw 或 xyflow 作为项目依赖。
 
 数据建模 MVP 的页面清单示例：
@@ -531,9 +533,10 @@ docs/design/data-modeling-prototype-review.md
 推荐提示词：
 
 ```text
-使用 product-design-prototype。
+使用 product-design:index。
 基于 docs/requirements/data-modeling-prd.md 和 docs/design/data-modeling-product-overview-design.md，
 为“数据中台数据建模 MVP”输出页面 / 原型 / 交互设计资产。
+请先按 Product Design plugin 规则路由到合适的 focused skill：$get-context / $ideate / $prototype / $image-to-code / $url-to-code。
 请生成页面清单、用户主路径、异常路径、低保真线框说明、交互状态矩阵、权限状态、空态/加载态/错误态，
 并明确这些设计如何反推 OpenAPI 字段、错误结构、分页筛选和前端验收标准。
 保存到 docs/design/data-modeling-interaction-spec.md。
@@ -1022,9 +1025,10 @@ docs/user-guide/
 ### 20.4 页面 / 原型 / 交互设计
 
 ```text
-使用 product-design-prototype。
+使用 product-design:index。
 基于 <PRD 路径> 和 docs/design/<feature>-product-overview-design.md，为 <功能名> 输出页面 / 原型 / 交互设计资产。
 如果缺少产品总体设计 / 功能架构，先阻断并要求补齐；不要直接继续生成交互设计。
+请先按 Product Design plugin 规则路由到合适的 focused skill：$get-context / $ideate / $prototype / $image-to-code / $url-to-code。
 请生成页面清单、用户主路径、异常路径、低保真线框说明、交互状态矩阵、权限状态、空态/加载态/错误态。
 请明确这些设计如何反推 OpenAPI 字段、错误结构、分页筛选、权限和前端验收标准。
 请同时列出需要回填 PRD 的需求缺口、验收标准或非目标范围。
@@ -1044,12 +1048,13 @@ docs/user-guide/
 ### 20.6 高保真 HTML 原型
 
 ```text
-使用 high-fidelity-html-prototype。
+使用 product-design:index，并路由到合适的 Product Design focused skill。
 基于 <PRD 路径>、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，
 为 <功能名> 生成 Ant Design v6 高保真可交互 HTML 原型。
 输出路径必须是 docs/design/prototypes/<feature>/index.html。
+产出前必须使用 `antd` CLI 查询设计语言、组件 API、demo、token 和 semantic 信息，不要凭记忆写 Ant Design v6 组件。
 请覆盖主流程、关键异常、loading/empty/error/no-permission/readonly/disabled/conflict/success 状态、表单校验、弹窗/抽屉、响应式断点。
-完成后给出 Ant Design v6 版本依据、`@ant-design/cli` 查询过的组件 / token / demo 和本地浏览器验证证据。
+完成后给出 Ant Design v6 版本依据、`antd` CLI 查询过的组件 / token / demo / semantic、本地浏览器验证证据，并使用 docs/design/templates/prototype-confirmation-template.md 记录用户确认。
 ```
 
 ### 20.7 PRD 校准 / 需求冻结