create-yss-spec 1.1.0 → 1.1.2

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-review-checklist.md

@@ -1,6 +1,6 @@
 # <功能名称> 原型评审清单
 
-> 适用时机：配合 `prototype-review` 使用。评审采用 fail-closed：有阻断项时必须回到产品设计阶段，不能进入 PRD 校准或 API 影响分析 / 契约草案。
+> 适用时机：配合 `prototype-review` 使用。评审采用 fail-closed：有阻断项时必须回到产品设计阶段；低保真评审通过后必须进入 `high-fidelity-html-prototype`，不能直接进入 PRD 校准或 API 影响分析 / 契约草案。
 
 ## 评审输入
 
@@ -24,7 +24,7 @@
 | 权限行为能区分隐藏、禁用和调用后拒绝 |  |  |
 | 校验错误能区分模型级和字段级展示位置 |  |  |
 | 能从界面需求反推出 API 影响和契约草案 |  |  |
-| 前端验收、Storybook / Histoire 或 mock 数据需要已明确 |  |  |
+| 前端验收、组件状态和数据依赖已明确 |  |  |
 | 安全红线已标记人工审查 |  |  |
 
 ## PRD 校准就绪度
@@ -59,5 +59,5 @@
 非阻断建议：
 - 
 下一步：
-- PRD 校准 / API 影响分析 / 契约草案 / 回到 product-design-prototype / component-story-prototype / mock-api-prototype
+- high-fidelity-html-prototype / 回到 product-design-prototype
 ```

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,9 @@ AI 不能只作为一次性辅助工具使用。Harness 工程的目标，是把
 
 ```text
 PRD
+→ 产品总体设计 / 功能架构
+→ 页面 / 原型 / 交互设计与 prototype-review（有 UI 时）
+→ Ant Design v6 高保真 HTML 原型（有 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 原型 | 4. 产品设计与需求冻结 | 交互说明、状态矩阵、Prototype Review、Ant Design v6 高保真 HTML 原型、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 原型、需求冻结 | `yss-design-system`、`product-design-prototype`、`prototype-review`、`high-fidelity-html-prototype` | 无 UI 可省略后续交互原型；进入 PRD 初稿 / 需求基线流程时不得省略产品总体设计及其低保真原型；有 UI 时低保真评审通过后不得省略高保真 HTML 原型；中等变更只补受影响页面 | 半自动检查 PRD 字段、产品总体设计、低保真原型、状态矩阵、原型评审和高保真 HTML 原型 |
 | 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 原型；无 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 原型 | 有 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,7 @@ 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` |
 | 需求冻结 | `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/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 影响分析 / 契约草案 / 工程基线，或阻断项已列出。

package/template/docs/user-guide/product-lifecycle-workflow.md

@@ -172,7 +172,7 @@ docs/process/lifecycle-artifact-map.md
 
 ### 6.3 设计产品和契约
 
-有 UI 时先走设计系统、产品设计和原型评审。涉及 API 时，先生成 review-only OpenAPI Draft：
+有 UI 时先走设计系统、产品设计、低保真原型评审和 Ant Design v6 高保真 HTML 原型。涉及 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，不能边写代码边悄悄改接口。
-- 有 UI 的功能不得只基于 PRD 反推 OpenAPI，必须结合产品总体设计、页面/原型/交互说明和状态矩阵。
+- OpenAPI 不得只基于 PRD 反推：必须结合产品总体设计 / 功能架构；有 UI 时还必须结合页面 / 原型 / 交互说明、状态矩阵、低保真原型评审和 Ant Design v6 高保真 HTML 原型。
 - OpenAPI Freeze 后进入 `to-issues`，再进入前后端实现和契约测试。
 
 ## 8. 验证、发布和复盘

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

@@ -146,8 +146,10 @@ skills 是让 AI 按规程工作的“操作手册”，不是关键词装饰。
 | 不知道当前该做什么 | `yss-product-lifecycle` | 先阶段判断和资产检查，不写业务代码 |
 | 模糊需求追问 | `grill-with-docs` | 先问清，不让 AI 猜规则；稳定术语写 `CONTEXT.md` |
 | 生成 PRD 初稿 / 需求基线 | `to-prd` 或 PRD 模板 | 只基于已确认事实，不把待确认项写成需求 |
-| 页面和交互设计 | `product-design-prototype`、`wireframe-prototype`、`component-story-prototype`、`mock-api-prototype`、`docs/design/` | 基于 PRD 初稿细化页面流、状态和交互，再回填 PRD 并反推 API |
-| 原型评审 | `prototype-review` | 未通过时回到产品设计，不进入 PRD 校准 / API 影响分析 / 契约草案 |
+| 产品总体设计 / 功能架构 | `docs/design/templates/product-overview-design-template.md` | PRD 初稿后的必要产物；必须包含低保真原型 / 页面草图；进入页面 / 原型 / 交互设计、PRD 校准或 OpenAPI Draft 前必须完成 |
+| 页面和交互设计 | `product-design-prototype`、`wireframe-prototype`、`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` |
 | API 契约 | API 影响分析 / 契约草案 / OpenAPI Freeze 流程 | Draft 可讨论，Freeze 才可开发 |
 | 正式变更设计 | `to-issues` / Matt skills | 复用 PRD，聚焦技术方案、风险和测试 seam |
 | 拆切片 | `to-issues` | 必须是端到端垂直切片 |
@@ -208,7 +210,7 @@ Agent brief 最少包含：
 适合并行：
 
 - Discovery Agent 做竞品矩阵，Ideation Agent 基于同一主题做机会假设，最后由主 Agent 收敛。
-- API Contract Agent 和 Architecture Agent 分别审查 Draft 与 DDD 边界，前提是校准后的 PRD 已稳定，且 UI 功能的产品总体设计 / 功能架构、页面 / 原型 / 交互设计已评审或明确无 UI 影响。
+- API Contract Agent 和 Architecture Agent 分别审查 Draft 与 DDD 边界，前提是校准后的 PRD、产品总体设计 / 功能架构已稳定；有 UI 时，页面 / 原型 / 交互设计也已评审，或已明确无 UI 影响。
 - 多个独立垂直切片，且不会修改同一批文件。
 
 不适合并行：
@@ -363,7 +365,7 @@ docs/discovery/data-modeling-opportunity.md
 
 ## 6. 阶段 3：PRD 初稿 / 需求基线
 
-PRD 把追问结论变成可交付需求，不写实现代码。这里的 PRD 先形成“需求基线”，不等于最终冻结版本；有用户界面的功能，还需要先形成产品总体设计 / 功能架构，再经过页面 / 原型 / 交互设计校准后，回填 PRD 并进入 API 影响分析 / 契约草案。
+PRD 把追问结论变成可交付需求，不写实现代码。这里的 PRD 先形成“需求基线”，不等于最终冻结版本；进入 PRD 初稿 / 需求基线流程后，必须先形成产品总体设计 / 功能架构，再按是否有 UI 决定是否进入页面 / 原型 / 交互设计，最后回填 PRD 并进入 API 影响分析 / 契约草案。
 
 建议资产：
 
@@ -408,17 +410,17 @@ PRD 片段示例：
 - [ ] 非目标范围清晰。
 - [ ] 测试 seam 已明确。
 - [ ] 待人工确认问题没有伪装成已确认需求。
-- [ ] 有用户界面的功能已明确需要进入产品总体设计 / 功能架构，并在其后进入页面 / 原型 / 交互设计；简单文案或纯后端能力可记录跳过原因。
+- [ ] 产品总体设计 / 功能架构已作为 PRD 初稿后的必要产物进入下一阶段；不进入 PRD 生命周期的小文案、低风险 Bug 或局部配置变更已记录不适用原因。
 
 ## 7. 阶段 4：产品总体设计 / 功能架构
 
-产品总体设计 / 功能架构是 PRD 初稿到页面原型之间的过渡层。它回答“产品由哪些功能域和业务对象支撑”“MVP 做什么和不做什么”“哪些页面、状态、权限、API、数据会被影响”。它不是交互说明，也不替代页面原型，而是页面 / 原型 / 交互设计的上游输入。
+产品总体设计 / 功能架构是 PRD 初稿到页面 / 原型 / 交互设计之间的过渡层。它回答“产品由哪些功能域和业务对象支撑”“MVP 做什么和不做什么”“哪些页面、状态、权限、API、数据会被影响”，并用低保真原型 / 页面草图先验证页面结构、关键操作和主流程。它不是详细交互说明，也不替代后续交互设计，而是页面 / 原型 / 交互设计的上游输入。
 
 正确关系是先结构化、再原型化：
 
 ```text
 PRD 初稿定义目标、范围、用户故事和验收
--> 产品总体设计 / 功能架构明确功能域、模块边界、页面/API/数据影响和 PRD 回填项
+-> 产品总体设计 / 功能架构明确功能域、模块边界、低保真原型、页面/API/数据影响和 PRD 回填项
 -> 页面 / 原型 / 交互设计验证用户如何完成任务
 -> 交互发现遗漏后回填 PRD
 -> PRD、产品总体设计和交互设计一起作为 API 影响分析 / 契约草案输入
@@ -440,6 +442,7 @@ docs/design/templates/product-overview-design-template.md
 
 - [ ] 用户主流程、异常路径、业务对象和状态已足以支撑原型设计。
 - [ ] 功能域、模块边界、优先级、依赖和非目标范围清楚。
+- [ ] 低保真原型 / 页面草图已覆盖 P0 页面、主流程、关键操作和关键异常路径。
 - [ ] 页面、API、数据、权限、审计影响已显式标注。
 - [ ] PRD 回填项、开放问题和阻断项已记录。
 - [ ] 可进入页面 / 原型 / 交互设计，或明确阻断原因。
@@ -475,12 +478,11 @@ docs/design/data-modeling-prototype-review.md
 | 页面清单、用户流、状态矩阵、PRD 回填项、OpenAPI 反推 | `product-design-prototype` | 基于 PRD 初稿和产品总体设计后的原型入口 |
 | 低保真线框、流程草图 | `wireframe-prototype`；Excalidraw / Markdown wireframe | 适合快速讨论，不绑定工程依赖 |
 | 高保真或设计系统协作 | Figma / Penpot，必要时使用 `figma` / `figma-use` | 适合设计团队和组件规范沉淀 |
-| 工程态页面状态原型 | `component-story-prototype`；Storybook / Histoire | 适合验证 loading、empty、error、权限、冲突等状态 |
-| API 未冻结前的交互数据 | `mock-api-prototype`；MSW / JSON fixtures | 适合支撑 Storybook 或前端原型 |
+| 高保真可交互 HTML 原型 | `high-fidelity-html-prototype`；Ant Design v6 | 低保真原型评审通过后的必需产物，用于 PRD 校准和 API 反推前的体验确认 |
 | 图谱、血缘、流程编排画布 | tldraw / xyflow | 适合数据血缘、任务流、关系图等画布型体验 |
-| 进入 PRD 校准前门禁 | `prototype-review` | 未通过则回到原型阶段 |
+| 进入高保真前门禁 | `prototype-review` | 未通过则回到原型阶段 |
 
-如果团队使用 Figma、即时设计、Axure 或其它原型工具，可以在 `docs/design/data-modeling-interaction-spec.md` 中保存链接、版本、评审记录和关键截图说明。第一版不强制引入 Storybook、MSW、Excalidraw、Figma、Penpot、tldraw 或 xyflow 作为项目依赖。
+如果团队使用 Figma、即时设计、Axure 或其它原型工具，可以在 `docs/design/data-modeling-interaction-spec.md` 中保存链接、版本、评审记录和关键截图说明。第一版不强制引入 Excalidraw、Figma、Penpot、tldraw 或 xyflow 作为项目依赖。
 
 数据建模 MVP 的页面清单示例：
 
@@ -1006,11 +1008,23 @@ docs/user-guide/
 最后输出：已确认、待确认、非目标、建议写入 CONTEXT 的术语、需要 ADR 的取舍。
 ```
 
-### 20.3 页面 / 原型 / 交互设计
+### 20.3 产品总体设计 / 功能架构
+
+```text
+基于 <PRD 路径>，为 <功能名> 生成产品总体设计 / 功能架构。
+请使用 docs/design/templates/product-overview-design-template.md。
+重点输出：设计目标、用户主流程、业务对象与状态、功能域与模块边界、Strategic DDD Check、低保真原型 / 页面草图、页面/API/数据/权限/审计影响、PRD 回填项、开放问题和评审结论。
+边界：不要写交互细节、不要生成 OpenAPI Draft、不要实现代码；只判断是否足以进入页面 / 原型 / 交互设计。
+保存到 docs/design/<feature>-product-overview-design.md。
+结论必须明确：Approved 可进入页面 / 原型 / 交互设计或 PRD 校准；Blocked 需先补齐产品边界、业务对象、模块边界、低保真原型、页面/API/数据/权限影响或 PRD 回填项。
+```
+
+### 20.4 页面 / 原型 / 交互设计
 
 ```text
 使用 product-design-prototype。
-基于 <PRD 路径>，为 <功能名> 输出页面 / 原型 / 交互设计资产。
+基于 <PRD 路径> 和 docs/design/<feature>-product-overview-design.md，为 <功能名> 输出页面 / 原型 / 交互设计资产。
+如果缺少产品总体设计 / 功能架构，先阻断并要求补齐；不要直接继续生成交互设计。
 请生成页面清单、用户主路径、异常路径、低保真线框说明、交互状态矩阵、权限状态、空态/加载态/错误态。
 请明确这些设计如何反推 OpenAPI 字段、错误结构、分页筛选、权限和前端验收标准。
 请同时列出需要回填 PRD 的需求缺口、验收标准或非目标范围。
@@ -1018,24 +1032,35 @@ docs/user-guide/
 完成后输出 prototype-review 评审输入清单。
 ```
 
-### 20.4 原型评审
+### 20.5 原型评审
 
 ```text
 使用 prototype-review。
-输入资产：<PRD 路径>、docs/design/<feature>-interaction-spec.md、docs/design/<feature>-state-matrix.md、<原型链接或线框说明>。
+输入资产：<PRD 路径>、docs/design/<feature>-product-overview-design.md、docs/design/<feature>-interaction-spec.md、docs/design/<feature>-state-matrix.md、<原型链接或线框说明>。
 请审查页面覆盖、主路径、异常路径、loading/empty/error/no-permission/readonly/conflict/dirty-form 状态、权限行为、字段级错误、PRD 回填项和 OpenAPI 反推清单。
-输出：通过/阻断、阻断项、非阻断建议、PRD 校准就绪度、Contract Draft / OpenAPI Draft 就绪度、前端原型就绪度和下一步。
+输出：通过/阻断、阻断项、非阻断建议、高保真 HTML 原型输入就绪度、Contract Draft / OpenAPI Draft 输入风险和下一步。
+```
+
+### 20.6 高保真 HTML 原型
+
+```text
+使用 high-fidelity-html-prototype。
+基于 <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。
+请覆盖主流程、关键异常、loading/empty/error/no-permission/readonly/disabled/conflict/success 状态、表单校验、弹窗/抽屉、响应式断点。
+完成后给出 Ant Design v6 版本依据、`@ant-design/cli` 查询过的组件 / token / demo 和本地浏览器验证证据。
 ```
 
-### 20.5 PRD 校准 / 需求冻结
+### 20.7 PRD 校准 / 需求冻结
 
 ```text
-基于 <PRD 路径> 和 <交互设计路径>，执行 PRD 校准。
+基于 <PRD 路径>、<产品总体设计路径>、<交互设计路径> 和 <高保真 HTML 原型路径>，执行 PRD 校准。
 请检查页面流、状态矩阵、异常路径、权限状态和验收标准是否已经回填 PRD。
 输出：需要更新的 PRD 条目、仍待确认的问题、可以冻结的范围、不能进入 API 影响分析 / 契约草案的风险。
 ```
 
-### 20.6 技能路由
+### 20.8 技能路由
 
 ```text
 使用 yss-router。

package/template.manifest.json

@@ -22,13 +22,18 @@
     ".codex/skills/.DS_Store",
     ".pi/settings.json",
     "docs/discovery/yss-spec-cli-init-discovery.md",
+    "docs/discovery/yss-spec-cli-template-sync-discovery.md",
     "docs/implementation/yss-spec-cli-init-build-checklist.md",
     "docs/implementation/yss-spec-cli-init-routing.md",
     "docs/requirements/issues/yss-spec-cli-init-slice-01-main-path.md",
     "docs/requirements/issues/yss-spec-cli-init-slice-02-safety-controls.md",
     "docs/requirements/issues/yss-spec-cli-init-slice-03-template-manifest.md",
     "docs/requirements/issues/yss-spec-cli-init-slice-04-delivery-verification.md",
+    "docs/requirements/issues/yss-spec-cli-template-sync-slice-01-main-path.md",
+    "docs/requirements/issues/yss-spec-cli-template-sync-slice-02-safety-controls.md",
+    "docs/requirements/issues/yss-spec-cli-template-sync-slice-03-delivery-verification.md",
     "docs/requirements/yss-spec-cli-init-prd.md",
+    "docs/requirements/yss-spec-cli-template-sync-prd.md",
     "scripts/sync-cli-template.js"
   ],
   "renderPaths": [

package/template/.codex/skills/component-story-prototype/SKILL.md

@@ -1,55 +0,0 @@
----
-name: component-story-prototype
-description: Use when Storybook, Histoire, component stories, page-state demos, or engineering prototypes are needed to validate UI states before full frontend implementation.
----
-
-# Component Story Prototype
-
-Use this skill when design decisions need executable UI states. It plans engineering prototypes; it does not require adding Storybook or Histoire to a repo unless the frontend project chooses that dependency.
-
-## When To Use
-
-- Page behavior depends on many states: loading, empty, error, permission, conflict, readonly, dirty form.
-- Product/design review needs a clickable or inspectable UI before API Freeze.
-- Existing frontend already uses Storybook/Histoire, or the team wants a temporary engineering prototype.
-
-If the repo has no story tooling and the task only needs low-fidelity flow decisions, use `wireframe-prototype` instead.
-
-## Story Plan
-
-For each page or interaction, define:
-
-- Component/page name and route context.
-- Mock inputs and visible data.
-- Actions demonstrated.
-- State variants.
-- OpenAPI or mock fixture dependency.
-- Acceptance notes that later become frontend tests or E2E paths.
-
-Recommended variants:
-
-```text
-Default
-Loading
-Empty
-ValidationError
-NoPermission
-ReadonlyPublishedVersion
-ConflictOnPublish
-DirtyFormLeavePrompt
-```
-
-## Data Modeling Example
-
-For model field editing, plan stories for:
-
-- `ModelList.Default`, `ModelList.Empty`, `ModelList.NoPermission`.
-- `ModelDetail.DraftFields`, `ModelDetail.PublishedReadonly`.
-- `FieldEditor.Valid`, `FieldEditor.FieldLevelErrors`.
-- `PublishModel.ValidationFailed`, `PublishModel.Success`, `PublishModel.Conflict`.
-
-Use `mock-api-prototype` when these stories need stable mock responses before OpenAPI Freeze.
-
-## Handoff
-
-Record the story plan in the interaction spec. Do not treat stories as a replacement for PRD, OpenAPI, or design review.

package/template/.codex/skills/component-story-prototype/agents/openai.yaml

@@ -1,4 +0,0 @@
-interface:
-  display_name: "Component Story Prototype"
-  short_description: "Storybook or Histoire state prototype plans"
-  default_prompt: "Use $component-story-prototype to plan component stories for UI state validation."

package/template/.codex/skills/mock-api-prototype/SKILL.md

@@ -1,48 +0,0 @@
----
-name: mock-api-prototype
-description: Use when MSW, mock service worker, mock fixtures, fake API responses, or prototype data contracts are needed before OpenAPI Freeze or generated API clients are available.
----
-
-# Mock API Prototype
-
-Use this skill to make prototypes exercise realistic data and error states before the formal API contract is frozen.
-
-## Guardrail
-
-Mock contracts are provisional. They may inform OpenAPI Draft, but they are not the source of truth after OpenAPI Freeze. Once the API is frozen, regenerate or align mocks from the frozen contract.
-
-## Fixture Contract
-
-For each mocked interaction, capture:
-
-- Operation name and screen/action that uses it.
-- Request params/body fields.
-- Success response shape.
-- Error response shape, including field-level validation errors when relevant.
-- Permission and conflict responses.
-- Pagination/filtering/sorting behavior when present.
-
-## Tool Choices
-
-| Situation | Suggested approach |
-|---|---|
-| Frontend prototype with network-like behavior | MSW handlers |
-| Storybook/Histoire state-only demo | JSON fixtures or static module mocks |
-| API design discussion | Markdown examples in interaction spec |
-| Contract has been frozen | Generate or align from OpenAPI via `api-integration` / `yss-openapi` |
-
-## Data Modeling Example
-
-Prototype these responses:
-
-- Model list success with draft/published statuses.
-- Empty model list.
-- Field editor save success.
-- Field editor validation error with `fieldCode`, `message`, and `severity`.
-- Publish validation failed with model-level and field-level errors.
-- Publish conflict when version changed since page load.
-- No-permission response for publish action.
-
-## Handoff
-
-Write mock examples into `docs/design/<feature>-interaction-spec.md` or the story plan. Then use `prototype-review` to confirm the mock data can drive PRD calibration and OpenAPI Draft.

package/template/.codex/skills/mock-api-prototype/agents/openai.yaml

@@ -1,4 +0,0 @@
-interface:
-  display_name: "Mock API Prototype"
-  short_description: "Mock responses for prototype validation"
-  default_prompt: "Use $mock-api-prototype to design mock API fixtures before OpenAPI Freeze."