create-yss-spec 3.3.8 → 3.4.3

package/template/docs/agents/digital-human-roles.yaml

@@ -88,10 +88,10 @@ roles:
     title: YSS 产品经理
     stages: [ stage.plan, stage.spec-architecture, stage.product-design, stage.verification-release-retrospective ]
     draft_artifact_ids: [ artifact.product-overview, artifact.functional-architecture, artifact.interaction-spec, artifact.state-matrix, artifact.prototype-confirmation ]
-    core_skills: [ yss-design-system, yss-prototype-stage, prototype-review, yss-antdv-next-design, yss-research, competitive-intelligence ]
+    core_skills: [ yss-design-system, yss-prototype-stage, prototype-review, yss-research, competitive-intelligence ]
     forbidden_skills: [ yss-ui, yss-domain, yss-repository, yss-web-controller, yss-ddd-scaffold-generator, yss-layered-mvc-scaffold-generator, implement, tdd ]
     description: >-
-      Own priority, product-design impact, interaction, state matrix, prototype confirmation recommendation, and the commercial constraints, delivery commitments, release window, and commercial non-goals for Plan and release. May reject Spec scope. Do not write production code or freeze OpenAPI alone. Do not independently approve external commercial contracts or formal commitments; those require biological-human approval. Frontend implementation uses the frontend-engineer role and yss-ui, not yss-antdv-next-design. Explicit React/AntD compatibility prototypes use yss-antd-design conditionally.
+      Own priority, product-design impact, interaction, state matrix, prototype confirmation recommendation, and the commercial constraints, delivery commitments, release window, and commercial non-goals for Plan and release. May reject Spec scope. Do not write production code or freeze OpenAPI alone. Do not independently approve external commercial contracts or formal commitments; those require biological-human approval. Frontend implementation uses the frontend-engineer role and yss-ui. Prototypes use offline HTML/CSS/JavaScript and project DESIGN.md; production component facts remain downstream.
 
   - id: role.project-manager
     name: 项目经理
@@ -112,7 +112,7 @@ roles:
     title: YSS 前端工程师
     stages: [ stage.product-design, stage.system-data-engineering, stage.ticket-formalization, stage.vertical-slice-implementation, stage.verification-release-retrospective ]
     draft_artifact_ids: [ artifact.frontend-implementation-plan ]
-    core_skills: [ yss-ui, yss-ui-business-page-generation, yss-components, yss-formily, formily-foundation, formily-linkage-effects, formily-mode-slot-detail, formily-step-flow, ytable-usage, ytree-usage, yedit-table-usage, yss-api-integration, yss-hook, theme-token-usage, page-skeleton, page-list-module, page-form-module, component-selection-imports, vue3-best-practices, tdd ]
+    core_skills: [ yss-ui, yss-ui-business-page-generation, yss-formily, ytable-usage, ytree-usage, yedit-table-usage, yss-api-integration, yss-hook, theme-token-usage, page-skeleton, page-list-module, page-form-module, component-selection-imports, vue3-best-practices, tdd ]
     forbidden_skills: [ yss-domain, yss-application, yss-repository, yss-mybatis, yss-web-controller, yss-ddd-scaffold-generator, yss-layered-mvc-scaffold-generator, java-backend-commit ]
     description: >-
       Own Vue page modules, frontend tests, and frontend_implementation_plan. Review OpenAPI Draft for client fit and prototype feasibility. Write only contract-allowed frontend paths. Verify with pnpm. Do not freeze API, own backend domain, or countersign your own merge.
@@ -125,7 +125,7 @@ roles:
     stages: [ stage.system-data-engineering, stage.ticket-formalization, stage.vertical-slice-implementation, stage.verification-release-retrospective ]
     draft_artifact_ids: [ artifact.openapi-draft, artifact.data-architecture, artifact.technical-design ]
     core_skills: [ yss-implementation-contract-compiler, yss-technical-design, yss-tactical-design, yss-mvc-design, yss-domain, yss-application, yss-repository, yss-mybatis, yss-web-controller, yss-dto, mapstruct, lombok, alibaba-java-code-style, yss-exception, yss-validation, tdd, yss-ddd-scaffold-generator, yss-layered-mvc-scaffold-generator ]
-    forbidden_skills: [ yss-ui, yss-ui-business-page-generation, yss-formily, yss-frontend-scaffold-generator, yss-antd-design, yss-antdv-next-design, page-list-module, page-form-module ]
+    forbidden_skills: [ yss-ui, yss-ui-business-page-generation, yss-formily, yss-frontend-scaffold-generator, page-list-module, page-form-module ]
     description: >-
       Own OpenAPI Draft, data-architecture contributions, and backend tests. Write only contract-allowed backend paths. Verify with ./mvnw. Do not Freeze OpenAPI, treat UI copy as requirements, or countersign your own implementation.
 
@@ -173,6 +173,20 @@ stage_groups:
     members: [ role.lifecycle-orchestrator, role.project-manager, role.test-engineer, role.product-manager ]
 
 gate_policy:
+  # countersigners 是可胜任该边界的候选角色，不是必须集齐的签字名单。
+  review_execution:
+    default_owner_count: 1
+    default_independent_reviewer_count: 1
+    additional_reviewers: uncovered-expertise-or-external-requirement
+    adjacent_checks: one-review-with-per-check-conclusions
+    suggestions: backlog-without-blocking
+    violations_or_missing_evidence: blocking
+  continuation_reviews:
+    gate.plan-approved: [role.product-manager]
+    gate.spec-baseline-approved: [role.product-manager]
+    gate.product-design-approved: [role.frontend-engineer, role.test-engineer]
+    gate.engineering-contract-approved: [role.backend-engineer, role.test-engineer]
+    implementation-scope: [role.test-engineer]
   default_if_unlisted: biological-human
   evidence_only: []
   orchestrator:
@@ -198,8 +212,9 @@ gate_policy:
     - gate: gate.engineering-contract-approved
       drafter: role.backend-engineer
       countersigners:
-        - role.product-manager
         - role.test-engineer
+        # 保留既有合法记录的角色兼容；并非要求再增加一次产品会签。
+        - role.product-manager
   product_digital_human_with_biological_veto: []
   biological_human:
     - gate.product-design-approved
@@ -250,6 +265,15 @@ user_decision_policy:
   schema_version: 1
   default_responder: requester
   delegate_requires_requester_evidence: true
+  # 专业批准仍逐项核验；已有明确授权通过延续证明复用，不再重复询问用户。
+  continuation:
+    capability: approved-scope-continuation-v1
+    source_boundary: delivery-scope
+    boundaries: [gate.plan-approved, gate.spec-baseline-approved, gate.product-design-approved, gate.engineering-contract-approved, implementation-scope]
+    material_changes: [business-scope, acceptance, contract-commitments, authorization, risk-acceptance, quality, external-commitments]
+    unknown_change: blocked
+    external_requirements: preserve-project-policy
+    external_policy_unconfirmed: no-automatic-continuation
   source_kinds: [ platform-message, session-export, user-confirmation-file ]
   gates:
     - gate.plan-approved

package/template/docs/agents/issue-tracker.md

@@ -34,6 +34,8 @@ tracker:
 4. 多个持久化配置声明不同平台时返回 `conflict`，暂停并要求迁移，不覆盖任何配置。
 5. 选定 GitHub / GitLab 但凭据或平台暂不可用时，先在 `docs/.scratch/<feature>/` 生成“待发布平台”草案；`parent-ticket.md` 保留目标平台、标记 `publication: pending` 和 `pending_publication_to`；不得自动改投另一远程平台。
 
+Slice v3 声明冻结需求时，合同绑定的 Ticket 文件只保留冻结时状态。当前状态、验收结果和执行记录继续进入主 tracker；Local Markdown 使用现有父 Ticket / 任务包记录进度，远程平台不可用时沿用待发布记录。需求文件版本不得作为当前执行状态读取，也不得因更新进度而改写。协议见 [Slice 合同](../../.agents/skills/yss-implementation-contract-compiler/references/slice-implementation-contract.md#第二轮增量规则)。
+
 ## Local Markdown 主 tracker
 
 Local 主 tracker 的完整功能包结构如下：

package/template/docs/agents/skill-migrations.md

@@ -2,6 +2,20 @@
 
 本文记录已退役技能入口的迁移路径。退役技能不保留物理目录、投影或 lock 条目；本文件是历史名称的唯一持久兼容说明。
 
+## DDD 分层包装与前端组件总入口收敛（2026-09-15）
+
+以下入口已硬退役，不保留 alias、物理目录、投影或 lock 条目：
+
+- DDD 嵌套包装：`yss-backend-scaffold-adapter`、`yss-application-layer-reference`、`yss-domain-layer-reference`、`yss-infrastructure-layer-reference`、`yss-web-layer-reference`。
+- 旧数据分析初始化器：`yss-mvc-scaffold-generator`，新工作使用 `yss-mvc-data-analysis-project-initializer`；通用 MVC 使用 `yss-layered-mvc-scaffold-generator`。
+- 前端组件总入口：`yss-components`。
+
+DDD 脚手架只保留已登记并被生成合同消费的 `yss-backend-scaffold-parent`。生成后的 Application、Domain、Infrastructure、Web 和 Adapter 实现从 `yss-ddd-scaffold-generator/references/layer-skill-routing.md` 路由到顶层权威 Skill，不再把普通参考目录暴露为可发现 Skill。
+
+前端页面统一从 `yss-ui` 路由：页面骨架使用 `page-skeleton`，组件选型使用 `component-selection-imports`，表格、树、Formily、Hook 和高度使用各自专项 Skill；没有独立 Skill 的复杂组件契约集中在 `yss-ui/references/specialized-components.md`。`yss-formily` 保留为薄路由器，不再复制表单代码骨架和专项规则。
+
+旧 ID 只允许存在于本迁移记录、retired/obsolete 清单、负向测试和不可变历史证据中。
+
 ## 技能面收敛与前端入口合并（2026-09-05）
 
 以下 Skill 已一次性硬退役，不保留 alias、兼容目录、投影或 lock 条目：
@@ -39,8 +53,7 @@
 - 阶段合同：`yss-prototype-stage`
 - 原型档位与主入口：`yss-prototype-stage` 的 H1/H2 路由
 - Codex 产品设计能力：按档位条件使用 `product-design:index`
-- Antdv Next 精确版本事实：默认 H2 使用 `yss-antdv-next-design`
-- Ant Design v6 事实与 CLI：仅显式 React 兼容 H2 使用 `yss-antd-design`
+- 当前 H1/H2：根 `DESIGN.md` 驱动的离线 HTML/CSS/JS；旧 Provider 路线见下方退役记录
 - 真实组件核验：不属于原型档位；进入已批准切片后由 `yss-ui` 基于目标 lockfile 执行，并写入前端实现验证
 - 独立低保真评审：`prototype-review`
 

package/template/docs/agents/yss-skill-registry.yaml

@@ -144,8 +144,6 @@ skill_dependencies:
     - { skill: i-have-adhd, type: context-conditional, when: lifecycle-document-output }
     - { skill: prototype-review, type: review-only }
     - { skill: yss-design-system, type: coordination-only }
-    - { skill: yss-antdv-next-design, type: context-conditional, when: h2-vue-antdv-next-default }
-    - { skill: yss-antd-design, type: context-conditional, when: h2-react-antd-explicit-compatibility }
   yss-ddd-scaffold-generator:
     - { skill: yss-backend-scaffold-parent, type: context-required }
     - { skill: alibaba-java-code-style, type: context-required }
@@ -195,10 +193,15 @@ skill_dependencies:
   yss-exception:
     - { skill: yss-dto, type: context-required }
   yss-ui-business-page-generation:
-    - { skill: yss-components, type: context-conditional, when: components }
+    - { skill: component-selection-imports, type: context-conditional, when: components }
     - { skill: yss-hook, type: context-conditional, when: hooks }
     - { skill: yss-formily, type: context-conditional, when: form }
     - { skill: yss-api-integration, type: context-conditional, when: api }
+  yss-formily:
+    - { skill: formily-foundation, type: context-required }
+    - { skill: formily-linkage-effects, type: context-conditional, when: formily-linkage }
+    - { skill: formily-mode-slot-detail, type: context-conditional, when: formily-mode-detail }
+    - { skill: formily-step-flow, type: context-conditional, when: formily-step-flow }
   yss-api-integration:
     - { skill: yss-openapi-governance, type: context-conditional, when: regeneration }
 invocation_contract:
@@ -237,16 +240,6 @@ invocation_contract:
       trigger_conditions: [impact:prototype]
       exclusion_conditions: [no-product-design-impact]
       primary_output: artifact.prototype-deliverable
-    yss-antd-design:
-      invocation_mode: model
-      trigger_conditions: [prototype-profile:H2, component-basis:react-antd]
-      exclusion_conditions: [prototype-profile:H1, component-basis:not-antd]
-      primary_output: versioned-antd-facts
-    yss-antdv-next-design:
-      invocation_mode: model
-      trigger_conditions: [prototype-profile:H2, component-basis:vue-antdv-next]
-      exclusion_conditions: [prototype-profile:H1, component-basis:not-antdv-next, production-frontend-implementation]
-      primary_output: versioned-antdv-next-facts
 agent_runtime_roots:
   codex: .codex/skills
   cursor: .cursor/skills
@@ -451,18 +444,6 @@ skills:
     instance_default_discoverable: false
     aliases: []
     impacts: [writing]
-  - id: yss-antd-design
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [prototype]
-  - id: yss-antdv-next-design
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [prototype]
   - id: yss-api-integration
     layer: specialist
     maturity: supported
@@ -487,12 +468,6 @@ skills:
     instance_default_discoverable: false
     aliases: []
     impacts: [backend]
-  - id: yss-components
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [frontend]
   - id: yss-ddd-scaffold-generator
     layer: specialist
     maturity: supported
@@ -583,15 +558,6 @@ skills:
     instance_default_discoverable: false
     aliases: []
     impacts: [frontend]
-  - id: yss-mvc-scaffold-generator
-    layer: specialist
-    maturity: deprecated
-    replaced_by: yss-mvc-data-analysis-project-initializer
-    migration_deadline: explicit-lifecycle-reapproval-before-next-generation
-    cleanup_status: read-only-entrypoint-and-historical-sources-retained
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [backend]
   - id: yss-mvc-data-analysis-project-initializer
     layer: specialist
     maturity: draft

package/template/docs/design/README.md

@@ -8,7 +8,7 @@
 - `docs/design/design-system-sync.yaml`：主模板与可独立分发的战略设计模板之间的共享章节版本与 SHA-256 同步摘要。
 - `docs/design/design.md`：YSS 设计治理、双轨运行时、生命周期和验证说明；不与规范源重复定义 token。
 - `docs/design/tokens/`：随仓库保存的主题、亮色 / 暗色 / 紧凑 token 和 CSS 变量快照，后续实现不得依赖本机 Downloads 目录或原始 Less。
-- 默认工作界面密度：`theme.json` 的 seed 叠加一次 compact algorithm，计算结果以 `tokens.compact.json` 和根 `DESIGN.md` 组件变体为准；暗色紧凑模式组合 dark 与 compact algorithm，禁止重复压缩。
+- 默认工作界面密度：`theme.json` 使用 default algorithm，与 Data Quality 的 32px 控件、14px 正文、20px Card 内距一致；仅显式紧凑模式叠加一次 compact algorithm；暗色紧凑模式组合 dark 与 compact algorithm，禁止重复压缩。
 
 Token 或组件视觉变体变更必须先修改 `DESIGN.md`，再更新派生快照；治理说明不得复制具体值。业务状态、API、权限和交互验收继续使用 Spec、交互说明及状态矩阵。
 
@@ -25,7 +25,7 @@ Token 或组件视觉变体变更必须先修改 `DESIGN.md`，再更新派生
 - 表单、表格、弹窗、抽屉、步骤流等交互说明。
 - loading、empty、error、readonly、disabled、no-permission、conflict 等状态矩阵。
 - 页面字段、筛选条件、操作按钮和权限规则。
-- 原型交付物默认路径为 `docs/.scratch/<feature>/design/prototypes/index.html`，也可为稳定 URL。H1 无 Node/AntD 依赖；H2 默认使用 Vue/Vite + Antdv Next，React/Vite + AntD 只作为显式兼容路线。真实 Vue 3 + YSS UI/AntDV 组件只在批准后的前端实现和实现还原验证中使用。产出后必须记录 Prototype Evidence schema v4、Visual Baseline schema v1、根 `DESIGN.md` digest 与 Token digest，并获得用户确认。
+- 原型交付物默认路径为 `docs/.scratch/<feature>/design/prototypes/index.html`，交付为离线资源包。H1/H2 默认采用 HTML/CSS/JavaScript；H2 的复杂交互影响评审结论时，可按集成说明选择真实 AntD 预构建，接收者无需 Node。真实 Vue 3 + YSS UI/AntDV 组件只在批准后的前端实现和实现还原验证中使用。产出后必须记录 Prototype Evidence schema v4、Visual Baseline schema v1、根 `DESIGN.md` digest 与 Token digest，并获得用户确认。
 
 这些资产用于反推 API 影响、契约草案、OpenAPI 请求 / 响应字段、错误结构、分页筛选、权限状态和前端验收标准。
 
@@ -45,8 +45,8 @@ Token 或组件视觉变体变更必须先修改 `DESIGN.md`，再更新派生
 - `yss-prototype-stage`：跨 Agent 的原型阶段主合同，固定资产、证据、设计优先级与生命周期回流；其 `references/product-design-adapter.md` 把 Codex `product-design:index` 通用产出接入 YSS 双轨版本、项目主题和证据合同。
 - `product-design:index`：Codex 产品原型产出的主路由；根据输入是否有 URL、截图、Figma、代码目标或视觉方向，进入 `$get-context`、`$ideate`、`$prototype`、`$image-to-code`、`$url-to-code`、`$share` 或 `$design-qa` 等 focused skill。
 - Product Design focused skills：按 H1/H2 的问题边界产出视觉或流程设计资产；ideation 只在新/不确定视觉方向时强制。
-- `yss-antdv-next-design`：用于默认 H2 Vue/Antdv Next 原型的精确版本事实；不替换生产 `yss-ui` 路线。
-- `yss-antd-design`：仅用于显式 H2 React/AntD 兼容原型的版本事实或 fact pack 增量更新；H1 不适用。
+当前原型使用 `yss-prototype-stage` 的离线 HTML 适配器；历史 Provider 证据保持只读。
+当前原型使用 `yss-prototype-stage` 的离线 HTML 适配器；历史 Provider 证据保持只读。
 - `prototype-review`：原型阶段评审门禁；未通过则不要进入 Spec 校准 / API 影响分析 / 契约草案。
 - 兼容入口：`product-design-prototype`、`high-fidelity-html-prototype` 只读迁移；新资产统一使用 `artifact.prototype-deliverable`、`yss-prototype-stage`、Prototype Evidence schema v4 与 Visual Baseline schema v1。
 

package/template/docs/design/design-system-sync.yaml

@@ -3,7 +3,8 @@ design_system_sync:
   baseline: yss-spec-project-template
   baseline_version: alpha
   baseline_commit: 36af9ac3895162cefc5da8889af8141c2dfce2cd
-  baseline_sha256: 59a9f90f7dd62d5e1d4c398e7b8ab8fae595622d0d5fea7bc0d43fe63802f5d5
+  baseline_sha256: e84a6c175840efe9663a2d0aba37f5635c053f47452bb146d1025d65665b1bec
+  baseline_state: worktree
   synchronized_sections:
     - Colors
     - Typography

package/template/docs/design/design.md

@@ -18,7 +18,6 @@
 | 来源 | 作用 | 采用结论 |
 | --- | --- | --- |
 | Ant Design v6 官方主题与迁移文档 | semantic token、CSS variables、theme algorithm 组合与 DOM 兼容边界 | **上游机制权威**；项目覆盖不得改变其算法语义 |
-| `docs/design/facts/antdv-next/1.5.2/manifest.json` | Antdv Next 精确版本的 Design.md、组件 API 与示例事实 | **默认 H2 Provider 事实源**；仅在版本和 digest 新鲜时使用 |
 | 历史 `Product-Design-System` 包 | 首次引入 Ant Design 企业级语义、状态矩阵和验收习惯 | 仅保留原则、组件规则和审查清单 |
 | 项目 Ant Design 5 Less / `:root` 变量 | 品牌主色、运行时切换别名、色板与布局 token 的历史项目覆盖 | 保留经批准的品牌覆盖；不作为 v6 / Antdv Next API 事实 |
 | `yss-meta` 的 `packages/src/styles` | 已落地的紧凑间距、Card 圆角、CSS 变量桥接和客户主题案例 | 只提取稳定语义；utility class、客户覆盖和兼容补丁不进入默认规范 |
@@ -42,15 +41,11 @@
 
 Codex `$design-qa` 的 Colors/tokens 与 Fonts/typography 对照必须以根 `DESIGN.md` 为 source visual truth，并用 `docs/design/tokens/*` 复核实际投影；不得回退到上游默认或历史品牌值。执行清单见 `.agents/skills/yss-design-system/references/design-qa-theme.md`。
 
-版本边界按原型档位处理：H1 直接消费项目 Token；H2 默认通过 `yss-antdv-next-design` 消费 Vue/Antdv Next 精确版本 fact pack；显式 `react-antd-6` 兼容路线才通过 `yss-antd-design` 消费 Ant Design v6 事实。两条原型路线都不替换生产实现路线。原型阶段不得调用 `yss-ui`；生产实现进入批准切片后才从目标实现仓 lockfile 中读取 Vue 3、YSS UI 与 Ant Design Vue 的真实 API。原型到生产只迁移视觉角色、项目 Token、状态和验收行为，禁止在 React/Vue 间搬运 hook、props、JSX、静态 API 或事件模型。
+原型 H1/H2 统一使用 `html-css-js`，以本地 Token CSS 保留 YSS 企业后台视觉语言。生产实现只在目标工程按 lockfile 核验组件 API；原型阶段不调用 `yss-ui`。已冻结的组件库原型和 fact pack 保留历史只读，不再生成新的 Provider 事实包。
 
-### Ant Design v6 / Antdv Next 视觉映射
+### HTML 与生产主题的映射
 
-- Ant Design v6 是以 CSS variables、现代浏览器与内部实现更新为主的技术升级，不应被误解为一套脱离 semantic token 的新皮肤。
-- `defaultAlgorithm`、`darkAlgorithm`、`compactAlgorithm` 可以组合。项目的默认工作界面采用 compact；暗色紧凑模式按 `[darkAlgorithm, compactAlgorithm]` 的等价顺序组合，不手工反色。
-- 基础 seed 从 `docs/design/tokens/theme.json` 读取，compact 结果从 `tokens.compact.json` 读取。禁止把计算结果反写为 seed 后再叠加 compact，避免重复压缩。
-- v6 内部 DOM 和生成类名不是稳定合同；原型和实现只依赖公开组件 API、semantic token、组件 token 与项目 CSS variables。
-- React Ant Design 与 Vue Antdv Next 可共享视觉角色和验收口径，但组件 props、事件、插槽、静态 API 与上下文机制必须分别从精确版本事实读取。
+HTML 直接使用 DESIGN.md 当前默认尺寸与主题 CSS，不要求 ConfigProvider 或组件库算法。生产库若使用 `defaultAlgorithm`、`darkAlgorithm`、`compactAlgorithm`，仍按其版本合同执行，避免把 compact 结果当 seed 再压缩。暗色能力只在派生 Token 和浏览器状态均核验后声明。
 
 ## 设计原则
 
@@ -133,9 +128,9 @@ Codex `$design-qa` 的 Colors/tokens 与 Fonts/typography 对照必须以根 `DE
 - 表单、筛选区、工具栏、表格和详情页应优先使用密集但有节奏的布局。
 - 不使用任意 magic number；如确需新增尺寸，应先判断是否要扩展 token。
 
-### 紧凑密度（默认原型规格）
+### 默认密度与可选紧凑密度
 
-原型交付物和中后台数据密集页面默认使用紧凑密度。紧凑密度不是把所有间距机械缩小，而是使用 `docs/design/tokens/tokens.compact.json` 和下表控制页面节奏；没有明确的展示型或触屏场景时，不切回宽松密度。
+原型和前端工程默认采用 Data Quality 全局主题：浅色、14px 正文、32px 控件、20px Card 内距，不默认开启 compact。下表仅用于明确选择紧凑模式的页面；紧凑模式消费 `tokens.compact.json`，不得再次压缩。
 
 | 场景 | Padding | Margin / Gap | 说明 |
 | --- | --- | --- | --- |
@@ -154,7 +149,7 @@ Margin 使用规则：组件自身默认不声明外部 margin，兄弟元素之
 
 | 角色 | 值来源 | 用途 |
 | --- | --- | --- |
-| 顶栏 / 侧栏 / 页面背景 | `docs/design/tokens/theme.json` 的 `layout*` | 应用壳布局 |
+| 顶栏 / 侧栏 / 页面背景 | `DESIGN.md` 的 `colors.surface` / `colors.canvas-layout` | 应用壳布局 |
 | Provider 断点 | 目标组件库精确版本的公开 Grid Token | 栅格和布局折叠 |
 | 截图视口 | 本文件“响应式与多端验收”矩阵 | 浏览器验收，不反写为组件 Token |
 
@@ -169,7 +164,7 @@ Margin 使用规则：组件自身默认不声明外部 margin，兄弟元素之
 | `borderRadius` | 6 | 默认控件圆角 |
 | `borderRadiusLG` | 8 | Card、大容器 / 浮层 |
 
-保持“控件圆角小于或等于容器圆角”：控件使用 `rounded.sm/md`，Card 与普通容器使用 `rounded.lg`。更大的 panel 圆角属于局部产品扩展，不作为紧凑型默认值；确需使用时必须先登记规范角色，不能让同一页面任意混用。实现时以根 `DESIGN.md` 与 `docs/design/tokens/tokens.compact.json` 为基线。
+保持“控件圆角小于或等于容器圆角”：控件使用 `rounded.sm/md`，Card 与普通容器使用 `rounded.lg`。更大的 panel 圆角属于局部产品扩展，不作为紧凑型默认值；确需使用时必须先登记规范角色，不能让同一页面任意混用。实现时以根 `DESIGN.md` 与 `docs/design/tokens/tokens.default.json` 为默认基线。
 
 ### 动效
 
@@ -223,17 +218,17 @@ Margin 使用规则：组件自身默认不声明外部 margin，兄弟元素之
 | 档位 | 用途 | 技术边界 | 最低验证 |
 |---|---|---|---|
 | H1 `visual-review` | 布局、密度、层级、文案和少量关键交互 | 语义 HTML/CSS/最小 JS 或设计工具导出；无需 Node、package、lockfile 或 AntD CLI | desktop/narrow 非空渲染、项目 Token、console、关键交互、基础键盘/焦点/对比度；zoom/reduced-motion 按影响 |
-| H2 `flow-review` | 主流程、权限、失败恢复、复杂联动和冲突 | 浏览器可运行流程；React/Vite + AntD v6 是受支持默认而非强制 | H1 共同证据 + 主流程、关键异常、zoom/reduced-motion；视觉回归按风险 |
+| H2 `flow-review` | 主流程、权限、失败恢复、复杂联动和冲突 | 浏览器可运行流程；默认 HTML/CSS/JavaScript 离线资源包，场景可重复触发和重置 | H1 共同证据 + 主流程、关键异常、zoom/reduced-motion；视觉回归按风险 |
 
 - H1 不得为了“显得完整”创建空 `package.json`、lockfile 或 AntD 证据。H2 不得声明真实目标组件已验证。
 - 原型中识别出的生产组件假设与待验行为写入 `implementation_handoff`，由 `frontend_implementation_plan` 和 `frontend_implementation_verification` 承接；不得在原型阶段引入 `yss-ui`、目标 lockfile 或 Storybook。
 - 新视觉方向、信息架构不确定或有多个合理方案时执行三方案 ideation；复用已批准视觉模式时记录 source visual 与 `not-applicable` 理由。
-- 默认启用紧凑密度；页面 padding、gap、Card 圆角、Card padding 和控件高度必须在浏览器计算样式中可复核。
+- 默认使用 Data Quality 的32px控件与20px Card内距，紧凑模式显式选择；页面 padding、gap、Card 圆角、Card padding 和控件高度必须在浏览器计算样式中可复核。
 - Design QA、浏览器验证和视觉目标使用同一视口与同一状态；默认 desktop `1440×900`、narrow `390×844`。
 - Design QA 统一覆盖 visual、layout、interaction、content、accessibility、cross-platform 六轴，不再复制第二份检查清单。
-- AntD fact pack 仅在精确版本、组件集合、项目 Token baseline digest 相同且没有新 API 疑问时复用；否则做增量查询。`lint/doctor` 只在存在相关 React 源时执行。
+- 交付包包含所有实际使用的本地资源和 Token 副本，登记摘要；复制到独立目录后以 `file://` 无网络复验。模板结构检查不替代浏览器证据。
 - 原型源码默认 throwaway；项目 Token、组件语义映射、状态、测试场景和验收标准可以进入下游，源码复用仍需 实现合同编译器、Slice Contract 与 TDD。
-- 用户确认只覆盖原型确认的决定、可操作范围、模拟/gap 与接受结论；HTML、story 或截图存在都不代表三个产品设计门禁已经通过。
+- 用户确认只覆盖原型确认的决定、可操作范围、模拟/gap 与接受结论；HTML、story 或截图存在都不代表产品设计聚合门禁已经通过。
 
 ### 无障碍覆盖
 
@@ -271,17 +266,17 @@ Margin 使用规则：组件自身默认不声明外部 margin，兄弟元素之
 如果前端使用 React + Ant Design：
 
 - 使用 `ConfigProvider` 注入 `docs/design/tokens/theme.json` 中的 theme 配置。
-- 默认工作界面使用 `compactAlgorithm`；暗色工作界面组合 `darkAlgorithm` 与 `compactAlgorithm`。seed 与计算结果分别从 `theme.json`、`tokens.compact.json` 读取。
+- 默认采用 Data Quality 浅色与 32px 控件；仅显式紧凑模式使用 `compactAlgorithm`；暗色工作界面组合 `darkAlgorithm` 与 `compactAlgorithm`。seed 与计算结果分别从 `theme.json`、`tokens.compact.json` 读取。
 - 组件样式优先通过 Ant Design token、component token、CSS variables 或主题算法表达。
 - 消息、通知、Modal 静态方法应使用 `App`、hook API 或 context holder，避免主题上下文丢失。
 - 暗色模式使用 `darkAlgorithm` 或 `docs/design/tokens/variables.dark.css`，不要手工反转颜色。本轮只同步了暗色的字体栈和圆角 seed；完整暗色色板仍是历史算法结果，启用暗色前应再派生一次。
-- 紧凑模式默认使用 `compactAlgorithm` 或 `docs/design/tokens/tokens.compact.json`，不要逐组件压缩高度；原型交付物必须按紧凑 token 验收实际 padding、gap、Card 圆角和控件高度。
+- 紧凑模式默认使用 `compactAlgorithm` 或 `docs/design/tokens/tokens.compact.json`，不要逐组件压缩高度；选择紧凑模式的原型交付物按紧凑 token 验收实际 padding、gap、Card 圆角和控件高度。
 
-H2 默认使用 Vue + Antdv Next：
+H1/H2 原型使用 HTML/CSS/JavaScript：
 
-- 先由 `yss-antdv-next-design` 校验精确版本、组件集合和项目 baseline digest，再消费 fact pack；不得把在线最新版示例直接当成本地版本合同。
-- 视觉层沿用本文件的 semantic token、紧凑密度和状态规则；Vue props、events、slots、ConfigProvider 主题结构从 Antdv Next fact pack 读取。
-- `yss-antd-design` 只保留为显式 React/AntD 兼容路线；两者都不替代生产 `yss-ui` 路线。
+- 使用根 `DESIGN.md` 派生的本地 Token CSS，保留来源摘要。
+- 规范直出按 Token、状态矩阵和页面模式验收；已有批准视觉稿时按相同视口与状态比对。首版截图通过审查与用户确认后冻结，不能自我比较作为质量证明。
+- 提供场景入口和重置，覆盖关键异常恢复、代表性业务内容、长文本与窄屏。复杂控件的生产能力假设进入既有 handoff。
 
 如果前端不是 Ant Design：
 
@@ -305,18 +300,15 @@ H2 默认使用 Vue + Antdv Next：
 
 ## 后续落地 TODO
 
-- 将 `docs/design/tokens/theme.json` 作为 compact 默认主题接入原型主题配置。
+- 将 `docs/design/tokens/theme.json` 作为 Data Quality 默认主题接入原型主题配置。
 - 将 `docs/design/tokens/variables.css` 中的 `--brand-*` 与运行时别名纳入项目 token 管理。
 - 如果项目启用暗色模式，用 `darkAlgorithm` 按新 seed 重派生 `docs/design/tokens/tokens.dark.json`，并补充截图验收。
 - 让 H1/H2 原型适配器默认接入项目 Token，并在浏览器证据中记录实际计算后的 padding、gap、Card 圆角和控件高度。
 
-## Ant Design v6 原型补充基线
+## HTML 原型补充基线
 
-本节根据官方 `https://ant.design/design.md` 与目标版本的 `antd design.md --format json` 提炼，仅用于采用 React AntD 的 H2 和语义映射，不替代项目 token，也不提供 Ant Design Vue API。
+参见 `.agents/skills/yss-prototype-stage/references/html-prototype-practices.md`。复用现有六轴 QA 与 Visual Baseline，新增能力只补充其执行方式，不另建交接文档。原生语义优先，弹窗与自定义控件的 ARIA 属性必须对应真实键盘/焦点行为。样式采用项目 Token，关键反馈保留可读文本，场景重置后再采集浏览器证据。
 
-- 先按 `bg-layout`、`bg-container`、`bg-elevated`、文本、边框、状态、圆角和阴影等 semantic token 角色设计，再映射到 `ConfigProvider`、组件 token 或 CSS variables；不得用页面局部色值替代主题层。
-- 默认亮色工作界面使用 `compactAlgorithm`；需要宽松展示态时才使用 `defaultAlgorithm`。暗色紧凑模式组合 `darkAlgorithm` 与 `compactAlgorithm`，禁止手工反色或逐控件压缩。
-- seed `controlHeight` 与 compact 计算值分别读取 `theme.json` 和 `tokens.compact.json`；不得同时下调 seed 和叠加 compact algorithm。
-- Alert、状态标签和选中态使用浅色语义面、边框与可读文本共同表达，避免把成功、警告、错误色铺成高饱和整块背景。
-- 每个决策区域只保留一个 single primary action。保存、提交、审批、发布、导出和重试等动作必须提供 interaction feedback；不可逆或高风险动作使用确认弹窗。
-- 对实际字号、图标和背景复核 accessibility contrast。默认 token 不足时，通过种子 token 或组件 token 调整，不引入单页特例色。
+## AntD 条件预构建
+
+高保真默认原生 HTML；简化模拟影响关键评审结论时，按原型技能的 `references/antd-integration.md` 条件使用 `react-antd-prebuilt`。交付格式与视觉权威不变；React 仅作为随包浏览器运行时，作者依赖与构建工具不交付给接收者。

package/template/docs/design/preview-dark.html

@@ -14,9 +14,9 @@
         <div class="eyebrow">YSS DESIGN SYSTEM</div>
         <div class="title-line">
           <h1>组件与状态预览</h1>
-          <span class="density-chip">暗色紧凑 · 28px</span>
+          <span class="density-chip">暗色 · 32px</span>
         </div>
-        <p class="page-description">darkAlgorithm + compactAlgorithm · YSS 项目主题覆盖</p>
+        <p class="page-description">darkAlgorithm · YSS 项目主题覆盖</p>
       </div>
       <div class="heading-actions">
         <nav class="mode-switch" aria-label="主题预览">
@@ -59,7 +59,7 @@
           </div>
         </form>
         <div class="notice notice-info filter-feedback" role="status">
-          <span>暗色与紧凑算法组合使用，仍保留 14px 正文、28px 控件和清晰的状态层级。</span>
+          <span>显式暗色模式，仍保留 14px 正文、32px 控件和清晰的状态层级。</span>
         </div>
       </div>
     </section>

package/template/docs/design/preview.css

@@ -2,7 +2,7 @@
 
 :root {
   color-scheme: light;
-  --preview-control-height: 28px;
+  --preview-control-height: 32px;
   --preview-primary-control: #245bdb;
   --preview-primary-control-hover: #2f68eb;
   --preview-panel-padding: 16px;

package/template/docs/design/preview.html

@@ -14,7 +14,7 @@
         <div class="eyebrow">YSS DESIGN SYSTEM</div>
         <div class="title-line">
           <h1>组件与状态预览</h1>
-          <span class="density-chip">紧凑模式 · 28px</span>
+          <span class="density-chip">默认模式 · 32px</span>
         </div>
         <p class="page-description">Ant Design v6 语义 Token · YSS 项目主题覆盖</p>
       </div>
@@ -59,7 +59,7 @@
           </div>
         </form>
         <div class="notice notice-info filter-feedback" role="status">
-          <span>紧凑模式保留 14px 正文，以 28px 控件、8px 控件间距和 12px 区域节奏提升扫描效率。</span>
+          <span>默认模式保留 14px 正文，以 32px 控件、8px 控件间距和 12px 区域节奏提升扫描效率。</span>
         </div>
       </div>
     </section>

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

@@ -10,9 +10,9 @@
 | 产品总体设计 / 功能架构 | `docs/.scratch/<feature>/design/<feature>-product-overview-design.md` | 必需；缺失时先返回产品总体设计阶段 |
 | 领域术语 | `CONTEXT.md` | 核心名词、状态和业务规则 |
 | Plan | `docs/.scratch/<feature>/plan/<feature>-discovery.md` | 可选 |
-| 原型阶段合同 / Product Design 路由 | `yss-prototype-stage -> product-design:index -> <focused skill>` | 必需；记录 `$get-context`、`$ideate`、`$prototype`、`$image-to-code` 或 `$url-to-code` |
+| 原型阶段合同 / 视觉来源 | `yss-prototype-stage`；`source_visual.kind=design-system` 或 `visual-reference` | 默认 DESIGN.md 规范直出；独立视觉稿才条件使用 Product Design focused skill |
 | 原型 / 线框图 | `<链接或导出图片路径>` | Excalidraw / Figma / Penpot / tldraw / Axure / Markdown |
-| 原型交付物 | `docs/.scratch/<feature>/design/prototypes/index.html` 或稳定 URL | 低保真评审后按 H1/H2 档位补齐；H2 AntD 条件取事实；真实组件待验事项交接到前端实现计划，产出后必须获得用户确认 |
+| H1/H2 原型交付物 | `docs/.scratch/<feature>/design/prototypes/index.html` 与本地资源 | 低保真评审后按档位补齐；默认原生 HTML，复杂控件影响评审结论时选择 AntD 预构建；产出后须用户确认 |
 | 原型验证清单 | `docs/.scratch/<feature>/verification/prototype-evidence.yaml` | 记录 schema v4 档位、浏览器、统一 Design QA、Visual Baseline case、条件组件证据和阻塞项 |
 | 现有 API 草案 | `docs/.scratch/<feature>/api/<feature>.yaml` | 可选；通常应先完成产品设计和 Spec 校准 |
 

package/template/docs/design/templates/prototype-evidence-template.yaml

@@ -26,16 +26,19 @@ upstream_refs:
   state_matrix_ref: docs/.scratch/<feature>/design/<feature>-state-matrix.md
   prototype_review_ref: docs/.scratch/<feature>/design/<feature>-prototype-review.md
 source_visual:
-  ideation_status: required
-  selected_ref: <selected-source-visual-ref>
-  reuse_reason: not-applicable
+  kind: design-system # 有独立视觉稿时用 visual-reference
+  ideation_status: not-applicable
+  selected_ref: DESIGN.md
+  reuse_reason: <说明规范及已有页面模式足以支持设计的依据>
 design_baseline:
   canonical_design_ref: DESIGN.md
   canonical_design_digest: <sha256>
   project_design_ref: docs/design/design.md
   project_token_refs:
+    # 默认 Data Quality 浅色；显式暗色 / 紧凑模式改为实际消费的对应快照，并同步摘要和视觉基线 cases[].theme。
     - docs/design/tokens/theme.json
-    - docs/design/tokens/tokens.compact.json
+    - docs/design/tokens/tokens.default.json
+    - docs/design/tokens/variables.css
   project_token_baseline_digest: <sha256>
   project_override_reviewed: false
 visual_baseline:
@@ -46,6 +49,10 @@ visual_baseline:
   status: approved
   case_ids: [primary-desktop, primary-narrow]
 browser_delivery:
+  delivery_contract: offline-html-v1
+  resource_manifest_ref: docs/.scratch/<feature>/design/prototypes/yss-prototype-adapter.json
+  offline_verification_ref: <file-url-offline-browser-evidence>
+  offline_verification_result: pending
   delivery_kind: static-directory
   entry_ref: docs/.scratch/<feature>/design/prototypes/index.html
   rendered_nonblank: false
@@ -62,6 +69,7 @@ browser_delivery:
   console_result: pending
   console_ref: <path-to-console-output-or-none>
 design_qa:
+  mode: design-contract # visual-reference 对应 visual-comparison
   report_ref: docs/.scratch/<feature>/verification/design-qa.md
   result: pending
   axes:
@@ -83,13 +91,10 @@ profile_evidence:
   #   reduced_motion: {applicable: false, result: not-applicable, evidence_ref: not-applicable}
   flow_review:
     implementation:
-      framework: vue
-      runtime_build_required: true
-      package_manager: pnpm
-      package_manifest_ref: docs/.scratch/<feature>/design/prototypes/package.json
-      lockfile_ref: docs/.scratch/<feature>/design/prototypes/pnpm-lock.yaml
-      build_command: pnpm build
-      build_result: pending
+      framework: html-css-js
+      runtime_build_required: false
+    scenario_replay_ref: <case-id-and-data-scenario-action-evidence>
+    scenario_reset_result: pending
     main_flow_result: pending
     exceptional_state_result: pending
     exceptional_state_ref: <failure-permission-or-conflict-ref>
@@ -103,17 +108,8 @@ profile_evidence:
       result: pending
       evidence_ref: <snapshot-result-ref>
     prototype_library_facts:
-      applicable: true
-      component_basis: vue-antdv-next
-      source: fact-pack
-      library_package: antdv-next
-      library_version: 1.5.2
-      manifest_ref: docs/design/facts/antdv-next/1.5.2/manifest.json
-      manifest_digest: <sha256>
-      components_covered: [<Component>]
-      canonical_design_digest: <same-as-design-baseline>
-      project_token_baseline_digest: <same-as-design-baseline>
-      new_api_uncertainty: false
+      applicable: false
+      component_basis: html-css-js
 implementation_handoff:
   prototype_code_reusable: false
   production_component_assumptions:

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

@@ -10,7 +10,8 @@
 | 交互说明 | `docs/.scratch/<feature>/design/<feature>-interaction-spec.md` |  |
 | 原型 / 线框图 | `<链接或导出图片路径>` |  |
 | 状态矩阵 | `docs/.scratch/<feature>/design/<feature>-state-matrix.md` |  |
-| 原型阶段合同 / Product Design 路由记录 | `yss-prototype-stage -> product-design:index -> <focused skill>` |  |
+| 视觉规范与主题快照 | 根 `DESIGN.md`、`docs/design/design.md`、实际消费的 Token 快照 | 默认 Data Quality 浅色；显式暗色 / 紧凑模式注明选择依据 |
+| 原型阶段合同 / Product Design 路由记录 | `yss-prototype-stage`；规范直出或条件独立视觉稿路线 |  |
 | 原型验证清单 | `docs/.scratch/<feature>/verification/prototype-evidence.yaml` | 档位确定后补齐 schema v4 共同与档位证据，并引用 Visual Baseline Bundle v1 |
 | 现有 API 草案 | `docs/.scratch/<feature>/api/<feature>.yaml` | 可选 |
 
@@ -28,6 +29,7 @@
 | 能从界面需求反推出 API 影响和契约草案 |  |  |
 | 已列出原型需要回答的决定、风险触发及 H1/H2 推荐档位；无充分证据时回退 H2 |  |  |
 | 状态矩阵中的每个状态均有事件、转换、guard、动作和退出路径 |  |  |
+| 高保真证据的 `design_baseline` 绑定当前规范与 Token 摘要，视觉基线的 `cases[].theme` 与实际截图一致 |  |  |
 | 前端验收、组件状态和数据依赖已明确 |  |  |
 | 风险 / 回滚约束和人工确认项已记录 |  |  |
 

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

@@ -1,6 +1,6 @@
 # <功能名称> 状态矩阵模板
 
-> 适用时机：配合 `product-design:index` 路由后的 Product Design focused skill 使用，在 Spec 校准和 API 影响分析 / 契约草案之前补齐页面状态。
+> 适用时机：由 `yss-prototype-stage` 统一消费；规范直出与条件独立视觉稿使用同一状态矩阵，在 Spec 校准和 API 影响分析 / 契约草案之前补齐页面状态。
 
 状态矩阵同时承担轻量状态机合同：每个可进入状态都必须有触发事件、允许转换、guard、动作与退出路径。不要另建第二份 state-machine 资产。
 

package/template/docs/design/templates/visual-baseline-template.yaml

@@ -33,13 +33,14 @@ capture_environment:
   capture_script_digest: <sha256>
   capture_result_ref: capture/result.json
   capture_result_digest: <sha256>
+# 默认 Data Quality 浅色；显式选择暗色 / 紧凑模式时按实际渲染修改 theme，并与原型证据中的 Token 快照保持一致。
 cases:
   - case_id: primary-desktop
     route: /<route>
     page: <PageName>
     state: normal
     viewport: {name: desktop, width: 1440, height: 900, scroll_mode: viewport, scroll_position: 0}
-    theme: compact-light
+    theme: default-light
     locale: zh-CN
     data_scenario: primary
     image_ref: images/primary-desktop.png
@@ -56,7 +57,7 @@ cases:
     page: <PageName>
     state: normal
     viewport: {name: narrow, width: 390, height: 844, scroll_mode: viewport, scroll_position: 0}
-    theme: compact-light
+    theme: default-light
     locale: zh-CN
     data_scenario: primary
     image_ref: images/primary-narrow.png

package/template/docs/design/tokens/.design-md-projection.json

@@ -1,13 +1,13 @@
 {
   "schema_version": 1,
   "source": "DESIGN.md",
-  "source_sha256": "59a9f90f7dd62d5e1d4c398e7b8ab8fae595622d0d5fea7bc0d43fe63802f5d5",
+  "source_sha256": "e84a6c175840efe9663a2d0aba37f5635c053f47452bb146d1025d65665b1bec",
   "files": {
-    "docs/design/tokens/theme.json": "aab648fa655c9d6f6d3932081a035543fd6481902c873dd218b50f9e550bedac",
-    "docs/design/tokens/tokens.default.json": "bf89486a8730a68673473fa7d5afe40b158e833b10df7da75d505bc53f8f6167",
-    "docs/design/tokens/tokens.dark.json": "79b93203f305d26f2f230a8af1f4b7e77c9bdb7997efa0746eed1508c928f85b",
-    "docs/design/tokens/tokens.compact.json": "afa4ae457a3db81d4b8a4b103ed9d6baa897daa1bbc23c96ee7d9182d2b4b992",
-    "docs/design/tokens/variables.css": "157dd6300e34be53f93196357c97125b77e00f980011db920d2964d46b12600d",
-    "docs/design/tokens/variables.dark.css": "b8ebb18f304831ee5c86cf6e5563702b2cc0ce2f51b055036e437a385226cd99"
+    "docs/design/tokens/theme.json": "740f80c2c55763564ac5e1cf4159e0d5f0965548d53e0eb0de0ff380e74f0a93",
+    "docs/design/tokens/tokens.default.json": "4e6446ee85195e3a75676a763cb8be2c625dc86b2b0676cbc8b45b2221135a71",
+    "docs/design/tokens/tokens.dark.json": "826391c5dafaef4d924003052bcfa9b38943e589120b0ff740214a12c9981ae1",
+    "docs/design/tokens/tokens.compact.json": "1a943c1354487addc67e399ededc122337d278a9ff61cb12d36a2f8202e26d9c",
+    "docs/design/tokens/variables.css": "028c24f9e935f5c4b1392d131a4cd13482e6572a2ced4360ffa833aa3fbeaf66",
+    "docs/design/tokens/variables.dark.css": "38132db701cd1e9793b6320baba20645a2cf577edc75b25aadb211f65bf05767"
   }
 }