create-yss-spec 3.0.0 → 3.1.0

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

@@ -1,19 +1,169 @@
-schema_version: 1
+schema_version: 2
 registry_id: yss.skill-routing
 status: active
 description: >-
-  技能分层、别名、默认可发现性和 Agent 运行时入口的可执行路由注册表。
-  invocation_contract 提供低成本的调用模式、触发条件、排除条件、主要输出与依赖元数据；不执行三层行为评估，也不替代 skills-lock.json 的来源、hash 与投影完整性职责。
-  Router 与生命周期编排器只消费通过本表校验的 canonical 技能。
+  技能身份、capability、任务模式、类型化依赖、分层、别名和默认可发现性的
+  单一可执行注册表。实现合同编译器与生命周期编排器只消费通过本表校验的
+  canonical 技能；skills-lock.json 继续独立持有来源、hash 与投影完整性。
 canonical_content_root: .agents/skills
+architecture_profiles:
+  target-domain-model:
+    architecture_family: domain-driven
+    generator_skill: yss-ddd-scaffold-generator
+    maturity: draft
+    core_modules: [domain, application, infrastructure, adapter, bootstrap]
+    capability_modules: {}
+    application_module: application
+    persistence_module: infrastructure
+    web_module: adapter/web
+    dto_modules: [web]
+  layered-mvc-service:
+    architecture_family: layered-mvc
+    generator_skill: yss-layered-mvc-scaffold-generator
+    maturity: draft
+    core_modules: [server, service, repository]
+    capability_modules:
+      external-integration: [adapter]
+      published-client: [client]
+      feign-client: [client, feign-client]
+    application_module: service
+    persistence_module: repository
+    web_module: server
+    dto_modules: [server, client]
+  mvc-data-analysis-v1:
+    architecture_family: layered-mvc
+    generator_skill: yss-mvc-data-analysis-project-initializer
+    maturity: draft
+    core_modules: [server, core, client, repository, adapter, feign-client]
+    capability_modules: {}
+    application_module: core
+    persistence_module: repository
+    web_module: server
+    dto_modules: [client]
 runtime_policy:
-  consumed_by_router: true
+  consumed_by_compiler: true
   consumed_by_lifecycle: true
   discovery_enforced: true
+capability_contract:
+  schema_version: 2
+  id_pattern: "^[a-z][a-z0-9-]*(?:\\.[a-z][a-z0-9-]*)+$"
+  dependency_types: [context-required, context-conditional, coordination-only, review-only, component-dependency]
+  task_modes: [guidance, integration, slice-implementation, troubleshooting, component-maintenance, review-input, contract-compilation, reroute, result-validation, source-index-refresh]
+  closure:
+    recursive_types: [context-required]
+    conditional_type: context-conditional
+    non_expanding_types: [coordination-only, review-only, component-dependency]
+    deduplicate_skills: true
+    preserve_all_reasons: true
+  deterministic_order: [recipe-declaration, dependency-topology, skill-id]
+capabilities:
+  - { id: layer.mvc-service, primary_skill: yss-application, architecture_family: layered-mvc, task_modes: [guidance, integration, slice-implementation, troubleshooting, review-input] }
+  - { id: layer.mvc-persistence, primary_skill: yss-repository, architecture_family: layered-mvc, task_modes: [guidance, integration, slice-implementation, troubleshooting, review-input] }
+  - { id: layer.mvc-web, primary_skill: yss-web-controller, architecture_family: layered-mvc, task_modes: [guidance, integration, slice-implementation, troubleshooting, review-input] }
+  - { id: governance.implementation-contract, primary_skill: yss-implementation-contract-compiler, task_modes: [contract-compilation, reroute, result-validation] }
+  - { id: maintenance.skill-source-index, primary_skill: yss-skill-source-index-refresh, task_modes: [component-maintenance, source-index-refresh] }
+  - { id: architecture.tactical-domain, primary_skill: yss-tactical-design, task_modes: [guidance, integration, slice-implementation, review-input] }
+  - { id: layer.domain, primary_skill: yss-domain, task_modes: [guidance, integration, slice-implementation, troubleshooting, review-input] }
+  - { id: layer.application, primary_skill: yss-application, task_modes: [guidance, integration, slice-implementation, troubleshooting, review-input] }
+  - { id: layer.persistence, primary_skill: yss-repository, task_modes: [guidance, integration, slice-implementation, troubleshooting, review-input] }
+  - { id: layer.web-adapter, primary_skill: yss-web-controller, task_modes: [guidance, integration, slice-implementation, troubleshooting, review-input] }
+  - { id: contract.dto-wire, primary_skill: yss-dto, task_modes: [guidance, integration, slice-implementation, troubleshooting, review-input] }
+  - { id: contract.request-validation, primary_skill: yss-validation, task_modes: [guidance, integration, slice-implementation, troubleshooting, review-input] }
+  - { id: contract.error-mapping, primary_skill: yss-exception, task_modes: [guidance, integration, slice-implementation, troubleshooting, review-input] }
+  - { id: framework.mybatis, primary_skill: yss-mybatis, task_modes: [guidance, integration, slice-implementation, troubleshooting, review-input] }
+  - { id: quality.java-code-style, primary_skill: alibaba-java-code-style, task_modes: [guidance, slice-implementation, review-input] }
+  - { id: codegen.mapstruct, primary_skill: mapstruct, task_modes: [integration, slice-implementation, troubleshooting, review-input] }
+  - { id: codegen.lombok, primary_skill: lombok, task_modes: [integration, slice-implementation, troubleshooting, review-input] }
+  - { id: component.cache, primary_skill: yss-cache, task_modes: [guidance, integration, slice-implementation, troubleshooting, component-maintenance, review-input] }
+  - { id: component.current-user-context, primary_skill: yss-userinfo, task_modes: [guidance, integration, slice-implementation, troubleshooting, component-maintenance, review-input] }
+  - { id: component.audit-log, primary_skill: yss-audit-log, task_modes: [guidance, integration, slice-implementation, troubleshooting, component-maintenance, review-input] }
+  - { id: component.excel-import-export, primary_skill: yss-excel-mvc, task_modes: [guidance, integration, slice-implementation, troubleshooting, component-maintenance, review-input] }
+  - { id: component.distributed-id, primary_skill: yss-distributed-id, task_modes: [guidance, integration, slice-implementation, troubleshooting, component-maintenance, review-input] }
+  - { id: component.security-algorithm, primary_skill: yss-security-algorithm, task_modes: [guidance, integration, slice-implementation, troubleshooting, component-maintenance, review-input] }
+  - { id: component.gateway-resilience, primary_skill: yss-resilience4j, task_modes: [guidance, integration, slice-implementation, troubleshooting, component-maintenance, review-input] }
+  - { id: scaffold.ddd, primary_skill: yss-ddd-scaffold-generator, task_modes: [integration, component-maintenance] }
+  - { id: scaffold.layered-mvc, primary_skill: yss-layered-mvc-scaffold-generator, task_modes: [integration, component-maintenance] }
+  - { id: project-init.mvc-data-analysis, primary_skill: yss-mvc-data-analysis-project-initializer, task_modes: [component-maintenance] }
+  - { id: migration.springboot3, primary_skill: yss-up-springboot3, task_modes: [guidance, integration, troubleshooting, component-maintenance, review-input] }
+recipes:
+  - { id: backend.ddd-domain-behavior, architecture_family: domain-driven, capabilities: [layer.domain, layer.application, quality.java-code-style] }
+  - { id: backend.ddd-persistence-mybatis, architecture_family: domain-driven, capabilities: [layer.persistence, framework.mybatis, codegen.mapstruct, codegen.lombok, quality.java-code-style] }
+  - { id: backend.ddd-http-api, architecture_family: domain-driven, capabilities: [layer.web-adapter, contract.dto-wire, contract.request-validation, contract.error-mapping, codegen.mapstruct, codegen.lombok, quality.java-code-style] }
+  - { id: backend.mvc-service-behavior, architecture_family: layered-mvc, capabilities: [layer.mvc-service, quality.java-code-style] }
+  - { id: backend.mvc-persistence-mybatis, architecture_family: layered-mvc, capabilities: [layer.mvc-persistence, framework.mybatis, codegen.mapstruct, codegen.lombok, quality.java-code-style] }
+  - { id: backend.mvc-http-api, architecture_family: layered-mvc, capabilities: [layer.mvc-web, contract.dto-wire, contract.request-validation, contract.error-mapping, codegen.mapstruct, codegen.lombok, quality.java-code-style] }
+  - { id: backend.domain-behavior, maturity: deprecated, capabilities: [layer.domain, layer.application, quality.java-code-style] }
+  - { id: backend.persistence-mybatis, maturity: deprecated, capabilities: [layer.persistence, framework.mybatis, codegen.mapstruct, codegen.lombok, quality.java-code-style] }
+  - { id: backend.http-api, maturity: deprecated, capabilities: [layer.web-adapter, contract.dto-wire, contract.request-validation, contract.error-mapping, codegen.mapstruct, codegen.lombok, quality.java-code-style] }
+  - { id: backend.current-user-context, capabilities: [component.current-user-context, contract.dto-wire] }
+  - { id: backend.cached-current-user, capabilities: [component.current-user-context, component.cache, contract.dto-wire] }
+  - { id: backend.audit-event, capabilities: [component.audit-log, component.current-user-context, contract.dto-wire] }
+  - { id: backend.excel-import-export, capabilities: [component.excel-import-export, contract.dto-wire, contract.request-validation, contract.error-mapping] }
+  - { id: backend.gateway-resilience, capabilities: [component.gateway-resilience, contract.error-mapping] }
+  - { id: backend.security-algorithm, capabilities: [component.security-algorithm, contract.error-mapping] }
+  - { id: backend.distributed-id, capabilities: [component.distributed-id] }
+  - { id: backend.ddd-scaffold, capabilities: [scaffold.ddd, quality.java-code-style] }
+  - { id: backend.mvc-scaffold, capabilities: [scaffold.layered-mvc, quality.java-code-style] }
+  - { id: backend.springboot3-migration, capabilities: [migration.springboot3, quality.java-code-style] }
+skill_dependencies:
+  yss-prototype-stage:
+    - { 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 }
+  yss-layered-mvc-scaffold-generator:
+    - { skill: alibaba-java-code-style, type: context-required }
+  yss-domain:
+    - { skill: alibaba-java-code-style, type: context-required }
+    - { skill: domain-modeling, type: coordination-only }
+    - { skill: yss-tactical-design, type: context-conditional, when: tactical-domain }
+    - { skill: lombok, type: context-conditional, when: pojo }
+  yss-tactical-design:
+    - { skill: domain-modeling, type: coordination-only }
+    - { skill: yss-openapi-draft-review, type: review-only, when: api-impact }
+    - { skill: yss-repository, type: component-dependency, when: data-impact }
+  yss-application:
+    - { skill: alibaba-java-code-style, type: context-required }
+    - { skill: mapstruct, type: context-conditional, when: conversion }
+    - { skill: lombok, type: context-conditional, when: pojo }
+  yss-repository:
+    - { skill: yss-mybatis, type: context-conditional, when: mybatis }
+    - { skill: mapstruct, type: context-conditional, when: conversion }
+    - { skill: lombok, type: context-conditional, when: pojo }
+    - { skill: alibaba-java-code-style, type: context-required }
+  yss-web-controller:
+    - { skill: yss-dto, type: context-required }
+    - { skill: yss-validation, type: context-conditional, when: request-validation }
+    - { skill: yss-exception, type: context-conditional, when: error-mapping }
+    - { skill: mapstruct, type: context-conditional, when: conversion }
+    - { skill: lombok, type: context-conditional, when: pojo }
+    - { skill: alibaba-java-code-style, type: context-required }
+  yss-userinfo:
+    - { skill: yss-dto, type: component-dependency }
+    - { skill: yss-cache, type: context-conditional, when: cache-lookup }
+  yss-audit-log:
+    - { skill: yss-userinfo, type: component-dependency }
+    - { skill: yss-dto, type: component-dependency }
+  yss-validation:
+    - { skill: yss-exception, type: component-dependency }
+  yss-security-algorithm:
+    - { skill: yss-exception, type: component-dependency }
+  yss-exception:
+    - { skill: yss-dto, type: context-required }
+  yss-ui-business-page-generation:
+    - { skill: yss-components, 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-api-integration:
+    - { skill: yss-openapi-governance, type: context-conditional, when: regeneration }
 invocation_contract:
-  schema_version: 1
-  scope: routing-and-dependencies-only
-  required_fields: [invocation_mode, trigger_conditions, exclusion_conditions, primary_output, required_dependencies, optional_dependencies]
+  schema_version: 2
+  scope: discovery-only
+  required_fields: [invocation_mode, trigger_conditions, exclusion_conditions, primary_output]
   allowed_invocation_modes: [user, model, both]
   trigger_source: impacts
   trigger_encoding: "impact:<impact>"
@@ -22,8 +172,6 @@ invocation_contract:
     trigger_conditions: [registered-skill-request]
     exclusion_conditions: [no-trigger-match]
     primary_output: skill-guidance
-    required_dependencies: []
-    optional_dependencies: []
   layer_defaults:
     core:
       invocation_mode: both
@@ -38,26 +186,25 @@ invocation_contract:
       invocation_mode: user
       primary_output: maintenance-operation
   overrides:
-    yss-ddd-scaffold-generator:
-      required_dependencies: [yss-backend-scaffold-parent, alibaba-java-code-style]
-      optional_dependencies: []
-    yss-domain:
-      required_dependencies: [alibaba-java-code-style]
-      optional_dependencies: [domain-modeling, yss-tactical-design, lombok]
-    yss-application:
-      required_dependencies: [alibaba-java-code-style]
-      optional_dependencies: [mapstruct, lombok]
-    yss-repository:
-      required_dependencies: [yss-mybatis, mapstruct, lombok, alibaba-java-code-style]
-      optional_dependencies: []
-    yss-web-controller:
-      required_dependencies: [yss-dto, yss-validation, mapstruct, lombok, alibaba-java-code-style]
-      optional_dependencies: [yss-exception]
+    yss-prototype-stage:
+      invocation_mode: both
+      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:
   claude: .claude/skills
   codex: .codex/skills
   cursor: .cursor/skills
-  hermes: .hermes/skills
   pi: .pi/skills
   qoder: .qoder/skills
   trae: .trae/skills
@@ -74,12 +221,6 @@ skills:
     instance_default_discoverable: false
     aliases: []
     impacts: [quality]
-  - id: ask-matt
-    layer: compatibility
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [lifecycle]
   - id: code-review
     layer: core
     maturity: supported
@@ -110,12 +251,6 @@ skills:
     instance_default_discoverable: true
     aliases: []
     impacts: [quality]
-  - id: dispatching-parallel-agents
-    layer: maintainer-only
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [lifecycle]
   - id: domain-modeling
     layer: core
     maturity: supported
@@ -176,12 +311,6 @@ skills:
     instance_default_discoverable: false
     aliases: []
     impacts: [backend]
-  - id: loop-me
-    layer: maintainer-only
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [setup]
   - id: maintaining-skills
     layer: core
     maturity: supported
@@ -194,12 +323,6 @@ skills:
     instance_default_discoverable: false
     aliases: []
     impacts: [backend]
-  - id: migrate-to-shoehorn
-    layer: maintainer-only
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [setup]
   - id: prototype
     layer: maintainer-only
     maturity: supported
@@ -224,42 +347,18 @@ skills:
     instance_default_discoverable: true
     aliases: []
     impacts: [quality]
-  - id: scaffold-exercises
-    layer: maintainer-only
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [setup]
   - id: setup-matt-pocock-skills
     layer: compatibility
     maturity: supported
     instance_default_discoverable: false
     aliases: []
     impacts: [setup]
-  - id: setup-pre-commit
-    layer: maintainer-only
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [setup]
-  - id: setup-ts-deep-modules
-    layer: maintainer-only
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [setup]
   - id: tdd
     layer: core
     maturity: supported
     instance_default_discoverable: true
     aliases: []
     impacts: [quality]
-  - id: teach
-    layer: maintainer-only
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [writing]
   - id: to-questionnaire
     layer: maintainer-only
     maturity: supported
@@ -302,31 +401,19 @@ skills:
     instance_default_discoverable: false
     aliases: []
     impacts: [lifecycle]
-  - id: writing-beats
-    layer: maintainer-only
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [writing]
   - id: writing-for-agents
     layer: maintainer-only
     maturity: supported
     instance_default_discoverable: false
     aliases: []
     impacts: [writing]
-  - id: writing-fragments
-    layer: maintainer-only
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [writing]
-  - id: writing-shape
-    layer: maintainer-only
+  - id: yss-antd-design
+    layer: specialist
     maturity: supported
     instance_default_discoverable: false
     aliases: []
-    impacts: [writing]
-  - id: yss-antd-design
+    impacts: [prototype]
+  - id: yss-antdv-next-design
     layer: specialist
     maturity: supported
     instance_default_discoverable: false
@@ -368,6 +455,12 @@ skills:
     instance_default_discoverable: false
     aliases: []
     impacts: [backend]
+  - id: yss-layered-mvc-scaffold-generator
+    layer: specialist
+    maturity: supported
+    instance_default_discoverable: false
+    aliases: []
+    impacts: [backend]
   - id: yss-design-system
     layer: core
     maturity: supported
@@ -434,12 +527,21 @@ skills:
     instance_default_discoverable: false
     aliases: []
     impacts: [frontend]
-  - id: yss-microapp-commit
-    layer: maintainer-only
-    maturity: supported
+  - 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: [microapp-commit]
-    impacts: [frontend]
+    aliases: []
+    impacts: [backend]
+  - id: yss-mvc-data-analysis-project-initializer
+    layer: specialist
+    maturity: draft
+    instance_default_discoverable: false
+    aliases: []
+    impacts: [backend]
   - id: yss-mybatis
     layer: specialist
     maturity: supported
@@ -458,12 +560,6 @@ skills:
     instance_default_discoverable: true
     aliases: []
     impacts: [api]
-  - id: yss-page-module-development
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: [page-module-development]
-    impacts: [frontend]
   - id: yss-product-lifecycle
     layer: core
     maturity: supported
@@ -488,7 +584,7 @@ skills:
     instance_default_discoverable: false
     aliases: []
     impacts: [backend]
-  - id: yss-router
+  - id: yss-implementation-contract-compiler
     layer: core
     maturity: supported
     instance_default_discoverable: true
@@ -506,7 +602,7 @@ skills:
     instance_default_discoverable: false
     aliases: []
     impacts: [backend]
-  - id: yss-source-index
+  - id: yss-skill-source-index-refresh
     layer: maintainer-only
     maturity: supported
     instance_default_discoverable: false
@@ -626,12 +722,6 @@ skills:
     instance_default_discoverable: false
     aliases: []
     impacts: [frontend]
-  - id: prototype-page-acceptance
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [prototype, frontend]
   - id: theme-token-usage
     layer: specialist
     maturity: supported

package/template/docs/agents/yss-ui-skills-integration.md

@@ -4,10 +4,10 @@
 
 ## 范围
 
-- 只集成 yss-ui `skills.config.json` 中 `categories.app` 的业务项目 skills，并排除后端 `java-backend-commit`，当前共 22 个。
+- 从 yss-ui `skills.config.json` 的 `categories.app` 中按 YSS capability 白名单集成业务项目 skills；排除后端 `java-backend-commit`、已由统一业务页面入口替代的 `page-module-development`，以及已由 Visual Baseline 和前端实现验证替代的 `prototype-page-acceptance`，当前共 20 个。
 - `categories.library` 的 10 个组件库内部维护 skills 全部不进入模板；该分组同时位于上游 `excludeFromDefaultSync`。
-- `api-integration`、`page-module-development`、`use-table-height`、`use-tree-height` 在模板中分别映射为 `yss-api-integration`、`yss-page-module-development`、`yss-use-table-height`、`yss-use-tree-height`，旧名称只作为 registry alias。
-- `java-backend-commit` 明确不属于本合同；其内容、路由与锁定信息不随本前端同步更新。
+- `api-integration`、`use-table-height`、`use-tree-height` 在模板中分别映射为 `yss-api-integration`、`yss-use-table-height`、`yss-use-tree-height`，旧名称只作为 registry alias。
+- `java-backend-commit`、`page-module-development`、`prototype-page-acceptance` 明确不属于本合同；其内容、路由与锁定信息不随本前端同步更新。
 - 允许模板基于生命周期、组件路由和证据门禁做受控适配；适配后的 `effectiveHash` 与上游 `upstreamHash` 同时进入 `skills-lock.json`。
 
 ## 更新步骤

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

@@ -16,8 +16,8 @@
 | 原型 / 线框图 |  |  |
 | 状态矩阵 | `docs/.scratch/<feature>/design/<feature>-state-matrix.md` |  |
 | 原型评审结论 | `docs/.scratch/<feature>/design/<feature>-prototype-review.md` |  |
-| 高保真 HTML 原型 | `docs/.scratch/<feature>/design/prototypes/index.html` | 有 UI 时必需；主题/视觉标准必须为 Ant Design v6，并通过 YSS Product Design adapter + `product-design:index` 路由产出或记录例外原因；生产 API 为 YSS UI + Ant Design Vue 4.x |
-| AntD CLI 校验证据 | `docs/.scratch/<feature>/design/<feature>-prototype-confirmation.md` 或评审记录 | 有 UI 时必需；记录 design.md / info / demo / token / semantic 查询 |
+| 原型交付物 | `docs/.scratch/<feature>/design/prototypes/index.html` 或稳定 URL | 有产品设计影响时必需；必须引用 Prototype Evidence schema v4、Visual Baseline schema v1 档位决策与交付物验证 |
+| 条件 AntD 事实 | `prototype-evidence.yaml` 的档位证据 | H1 不适用；H2 使用 AntD 时引用新鲜 fact pack 或增量 CLI；不得作为生产 YSS/AntDV 组件事实 |
 | 用户确认记录 | `docs/.scratch/<feature>/design/<feature>-prototype-confirmation.md` | 有 UI 时必需；未确认前不得进入 OpenAPI Draft 评审 |
 | YSS 工程基线 | `.codex/skills/yss-ddd-scaffold-generator/references/yss-backend-scaffold-parent/SKILL.md` |  |
 | YSS DTO wire profile | `.agents/skills/yss-dto/references/openapi-wire-profile.yaml`；`scripts/verify-yss-dto-openapi-profile` |  |
@@ -37,7 +37,7 @@
 | YAML 权威性 | 单一 OAS 3.1 document；未混入生命周期 frontmatter / 根字段；`operationId` 稳定 |  |  |
 | P0 覆盖 | 每个 P0 需求有 endpoint/schema/error/test 或明确非目标 |  |  |
 | 产品总体设计完整 | Draft 已依据 Spec 和产品总体设计 / 功能架构；缺产品总体设计时返回上游补齐 |  |  |
-| 交互输入完整 | 有 UI 时，Draft 已同时依据交互说明、原型/线框、状态矩阵、prototype-review、Ant Design v6 主题/视觉标准高保真 HTML 原型、schema v2 AntD/语义映射/浏览器/无障碍证据和用户确认记录；无 UI 时需说明页面 / 交互资产不适用原因 |  |  |
+| 交互输入完整 | 有产品设计影响时，Draft 已同时依据交互说明、低保真、状态矩阵、prototype-review、H1/H2 原型交付物、Prototype Evidence schema v4、Visual Baseline schema v1、浏览器/Design QA/条件 AntD 事实和用户确认；无产品设计影响时说明不适用原因 |  |  |
 | DDD 契约边界 | Endpoint/schema 归属的限界上下文清楚；术语与 `CONTEXT.md` 和功能架构一致；契约不直接暴露内部聚合、Repository 或持久化表结构 |  |  |
 | 页面动作覆盖 | 每个按钮 / 抽屉 / 弹窗动作有 endpoint/non-goal、`actionKey` 和错误码；Spec 明确认认证 / 授权变化时同时映射该行为 |  |  |
 | 对象生命周期 | manage/maintain/configure/create/update/archive/retry/cancel/publish/export/create-draft 语义闭环 |  |  |

package/template/docs/architecture/templates/engineering-baseline-review-template.md

@@ -5,10 +5,10 @@ status: draft
 owner: ai
 ---
 
-# <功能名称>工程基线 / YSS DDD Review
+# <功能名称>工程基线 / YSS 后端架构 Review
 
-> 适用场景：新后端服务、新模块、DDD 分层、Gateway / Repository、统一响应、MapStruct 或工程结构受影响时。
-> 本文确认本次变更是否符合 YSS DDD 工程基线，不替代系统概要设计、数据架构或代码审查。
+> 适用场景：新后端服务、新模块、DDD / Layered MVC 分层、Repository、统一响应、MapStruct 或工程结构受影响时。
+> 本文确认本次变更是否符合已选择的 YSS 后端工程基线，不替代系统概要设计、数据架构或代码审查。
 
 ## 1. 输入材料
 
@@ -21,6 +21,7 @@ owner: ai
 | YSS skill 路由 |  |  |  |
 | `prototype_confirmation` |  |  | UI 影响时必须是已确认；无 UI 影响记录 `not-applicable` 及原因 |
 | 后端脚手架登记 / 生成结果 |  |  | 记录 `scaffold_status`、目标目录、生成器输入、预期文件和 Execution Result |
+| 后端脚手架架构选择 |  |  | `scaffold-architecture-decisions.yaml` 的 decision_id、用户确认引用和 digest |
 
 ## 2. 工程影响判断
 
@@ -33,6 +34,14 @@ owner: ai
 | 是否影响统一响应 / DTO / VO / Query / CMD | 是 / 否 |  |
 | 是否存在高风险变更、人工确认项或回滚约束 | 是 / 否 |  |
 
+## 2.2 脚手架架构选择
+
+| 项目 | Agent 推荐及依据 | 继承来源 | 用户确认 | architecture_family | Profile / 模块闭包 | decision_id / digest |
+|---|---|---|---|---|---|---|
+|  |  |  |  | `domain-driven` / `layered-mvc` |  |  |
+
+> 聚合不变量、复杂状态机、跨聚合一致性、Domain Event 或复杂并发任一强信号命中时推荐 DDD；强信号均不存在且以 CRUD、报表、数据转换或外部编排为主时推荐 MVC。用户可覆盖软性推荐，但必须记录原因；不支持的 Profile 直接阻断。
+
 ## 2.1 质量基线与高风险反证
 
 | 字段 | 内容 |
@@ -50,7 +59,7 @@ owner: ai
 
 > Doubt-Driven 只在命中的高风险决策中启用，不新增生命周期阶段；缺少反证、证据不足或残余风险未处理时不得通过工程基线。
 
-## 3. YSS DDD 分层检查
+## 3. YSS 后端分层检查
 
 | 层级 | 职责 | 本次影响 | 约束 / 结论 |
 |------|------|----------|-------------|
@@ -59,12 +68,15 @@ owner: ai
 | Domain | 领域模型、领域服务、Gateway 接口 |  |  |
 | Infrastructure | GatewayImpl、Repository、外部系统适配 |  |  |
 | Bootstrap | 启动、配置、依赖组装 |  |  |
+| MVC Server | 启动、Controller 与 Web 装配；仅 layered-mvc |  |  |
+| MVC Service | 事务脚本、用例编排与业务服务；仅 layered-mvc |  |  |
+| MVC Repository | PO、Mapper、SQL 与数据库访问；仅 layered-mvc |  |  |
 
 ## 4. 推荐 YSS skills
 
 | 场景 | 推荐 skill | 是否需要 | 备注 |
 |------|-------------|----------|------|
-| 新服务骨架 | `yss-ddd-scaffold-generator` | 是 / 否 |  |
+| 新服务骨架 | `yss-ddd-scaffold-generator` / `yss-layered-mvc-scaffold-generator` | 是 / 否 | 按批准的 architecture_family 选择 |
 | 后端基线检查 | `yss-backend-scaffold-parent` | 是 / 否 |  |
 | 领域建模 | `yss-domain` | 是 / 否 |  |
 | Application 用例编排 / 事务边界 | `yss-application` | 是 / 否 |  |
@@ -76,10 +88,10 @@ owner: ai
 | 检查项 | 结论 | 证据 / 备注 |
 |---|---|---|
 | 原型确认已完成，或已记录 `not-applicable` 原因 | 是 / 否 / 不适用 | `prototype_confirmation` |
-| `scaffold_status=required` 时先由 Router 编译脚手架合同并经生命周期批准，再使用 `yss-ddd-scaffold-generator` | 是 / 否 / 不适用 | 结构化 `contract_id` / `contract_version`、Router draft、批准引用、持久化引用和生成结果 |
+| `scaffold_status=required` 时已由 Agent 推荐、用户确认并持久化 architecture decision，随后由实现合同编译器编译 schema v3 合同并经生命周期批准，再使用对应 DDD / MVC 生成器 | 是 / 否 / 不适用 | decision_id / digest、contract_id / contract_version、实现合同编译器 draft、批准引用、持久化引用和 Manifest v3 |
 | 脚手架生成结果只包含工程结构、配置和机械模板 | 是 / 否 | 禁止生成业务行为 |
 | 生成器输入、预期文件和实际 `./mvnw validate` / `./mvnw test` / `./mvnw package` 已留证 | 是 / 否 | 每条命令记录 `exit_code`、`duration_ms`、stdout/stderr 引用和执行时间；打印命令不算证据 |
-| `yss-backend-scaffold-parent` 基线校验已完成并重新进入 `yss-router` | 是 / 否 / 不适用 |  |
+| `yss-backend-scaffold-parent` 基线校验已完成并重新进入 `yss-implementation-contract-compiler` | 是 / 否 / 不适用 |  |
 | 脚手架后所有业务代码均绑定批准 Slice Implementation Contract 和 YSS Skill Execution Result | 是 / 否 |  |
 
 ## 5. 完成标准
@@ -92,7 +104,7 @@ owner: ai
 - [ ] `baseline_id` / `baseline_version` 已登记，后续切片和审查只引用该质量基线，未重复定义。
 - [ ] 命中高风险影响时已完成 Doubt-Driven 主张、反证、证据和残余风险记录；未命中时已记录 `not-applicable` 原因。
 - [ ] 风险影响、验证证据和责任人已记录。
-- [ ] 原型确认后已按脚手架顺序完成工程基线、生成器、`yss-backend-scaffold-parent` 和 Router 重编译；脚手架未生成业务行为。
+- [ ] 原型确认后已按脚手架顺序完成工程基线、生成器、`yss-backend-scaffold-parent` 和 实现合同编译器 重编译；脚手架未生成业务行为。
 
 ## 6. 下一步门禁
 

package/template/docs/design/README.md

@@ -8,6 +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，禁止重复压缩。
 
 模板源维护工具（仅在 `template-source` 仓库执行）：
 
@@ -16,9 +17,9 @@ node .template-source/tooling/node/scripts/design-md.mjs lint DESIGN.md
 node .template-source/tooling/node/scripts/design-md.mjs drift
 ```
 
-令牌变更必须先修改 `DESIGN.md`，再更新派生快照；业务状态、API、权限和交互验收继续使用 Spec、交互说明及状态矩阵。
+Token 或组件视觉变体变更必须先修改 `DESIGN.md`，再更新派生快照；治理说明不得复制具体值。业务状态、API、权限和交互验收继续使用 Spec、交互说明及状态矩阵。
 
-产品原型产出默认以 `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 校验证据、用户确认和 Spec / OpenAPI 回填。
+产品原型由 `yss-prototype-stage` 持有阶段合同：先评审低保真/状态矩阵，再选择 H1 视觉或 H2 流程，并按需调用 `product-design:index` focused workflow。YSS 生命周期负责校验档位选择、Prototype Evidence schema v4、Visual Baseline schema v1、统一 Design QA、用户确认和 Spec / OpenAPI 回填。原型阶段不得调用生产实现技能 `yss-ui`。
 
 进入 Spec 初稿 / 需求基线流程后，必须先沉淀产品总体设计 / 功能架构，再进入页面 / 原型 / 交互设计、Spec 校准、API 影响分析 / 契约草案或实现。产品总体设计文档必须包含低保真原型 / 页面草图，用于验证页面结构、关键操作和主流程。无 UI 的功能也需要产品总体设计 / 功能架构来说明功能域、业务对象、模块边界、API / 数据影响和不适用的页面状态；只有不进入 Spec 生命周期的小改动可在影响面评估中记录不适用原因。
 
@@ -31,7 +32,7 @@ node .template-source/tooling/node/scripts/design-md.mjs drift
 - 表单、表格、弹窗、抽屉、步骤流等交互说明。
 - loading、empty、error、readonly、disabled、no-permission、conflict 等状态矩阵。
 - 页面字段、筛选条件、操作按钮和权限规则。
-- 低保真原型评审通过后的 Ant Design v6 主题/视觉标准高保真可交互 HTML 原型，默认路径为 `docs/.scratch/<feature>/design/prototypes/index.html`；标准 React 原型组件精确锁定与 CLI 一致的 `antd@6.x`，通过 YSS Product Design adapter 消费项目 token、pnpm、同视口 QA 和无障碍证据。生产组件/API 仍是 Vue 3 + YSS UI + 实现仓 lockfile 的 Ant Design Vue 4.x。产出后必须记录 schema v2 原型证据并获得用户确认。
+- 原型交付物默认路径为 `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，并获得用户确认。
 
 这些资产用于反推 API 影响、契约草案、OpenAPI 请求 / 响应字段、错误结构、分页筛选、权限状态和前端验收标准。
 
@@ -41,18 +42,20 @@ node .template-source/tooling/node/scripts/design-md.mjs drift
 - `docs/design/templates/interaction-spec-template.md`：页面、流程、交互、Spec 回填项和 OpenAPI 反推清单。
 - `docs/design/templates/state-matrix-template.md`：loading、empty、error、readonly、no-permission、conflict 等状态。
 - `docs/design/templates/prototype-review-checklist.md`：进入 Spec 校准 / API 影响分析 / 契约草案前的原型评审门禁。
-- `docs/design/templates/prototype-confirmation-template.md`：高保真 HTML 原型产出后的用户确认记录。
-- `docs/design/templates/prototype-evidence-template.yaml`：原型阶段的 AntD CLI、浏览器验证、评审和确认的机器可读证据清单。
+- `docs/design/templates/prototype-confirmation-template.md`：原型交付物验证后的用户确认记录。
+- `docs/design/templates/prototype-evidence-template.yaml`：Prototype Evidence schema v4 原型档位、浏览器、统一 Design QA、Visual Baseline 引用、条件组件事实、评审和确认的机器可读证据清单。
+- `docs/design/templates/visual-baseline-template.yaml`：Visual Baseline schema v1 页面语义、视口、状态、图片、mask、来源和采集环境的可移植清单。
 
 推荐技能：
 
 - `yss-design-system`：项目设计系统与 Ant Design 企业级 UI 风格基线；页面设计、原型评审、UI 实现和主题 token 落地时默认先引用。Codex `$design-qa` 的 token / 字体对照读该技能的 `references/design-qa-theme.md`，以项目覆盖为准，不改上游 `design-qa` 插件。
 - `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：基于 Spec 初稿和产品总体设计 / 功能架构，产出低保真 / 高保真页面、原型、交互设计资产和可分享原型；高保真 HTML 原型默认由该路由链路产出。
-- `yss-antd-design`：仅用于原型设计构建的 Ant Design v6 事实技能；生成或修改高保真 HTML 原型前后必须留下 CLI 校验证据。前端代码落地改用 `yss-ui`。
+- 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 不适用。
 - `prototype-review`：原型阶段评审门禁；未通过则不要进入 Spec 校准 / API 影响分析 / 契约草案。
-- 兼容入口：`product-design-prototype`、`high-fidelity-html-prototype` 仅作为历史兼容或产物门禁名称保留；新的产品原型产出默认使用 `product-design:index`，已退休技能不再提供兼容路由。
+- 兼容入口：`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,7 @@ design_system_sync:
   baseline: yss-spec-project-template
   baseline_version: alpha
   baseline_commit: 36af9ac3895162cefc5da8889af8141c2dfce2cd
-  baseline_sha256: 976d74b4af85b5062f9c5a365591809ff240159f0f4445ce05e7a4dcb76d0185
+  baseline_sha256: 59a9f90f7dd62d5e1d4c398e7b8ab8fae595622d0d5fea7bc0d43fe63802f5d5
   synchronized_sections:
     - Colors
     - Typography