create-yss-spec 3.0.1 → 3.1.3

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

@@ -69,7 +69,7 @@ orchestrator:
   default_dual_hat: [role.project-manager]
   stages: [stage.entry-triage, stage.discovery, stage.spec-architecture, stage.product-design, stage.system-data-engineering, stage.ticket-formalization, stage.vertical-slice-implementation, stage.verification-release-retrospective]
   core_skills: [yss-product-lifecycle, yss-implementation-contract-compiler]
-  forbidden_skills: [yss-domain, yss-ui, yss-page-module-development, yss-web-controller, yss-repository, implement]
+  forbidden_skills: [yss-domain, yss-ui, yss-ui-business-page-generation, yss-web-controller, yss-repository, implement]
   description: >-
     Own YSS lifecycle routing. Read yss-project.yaml and CONTEXT.md first.
     Select the next unblocked work unit, compile a task package, and assign
@@ -87,7 +87,7 @@ roles:
     stages: [stage.discovery, stage.spec-architecture]
     draft_artifact_ids: [artifact.discovery-record, artifact.spec]
     core_skills: [grilling, domain-modeling, yss-research, competitive-intelligence, grill-with-docs]
-    forbidden_skills: [yss-ui, yss-domain, yss-web-controller, yss-repository, yss-ddd-scaffold-generator, yss-frontend-scaffold-generator, implement, tdd]
+    forbidden_skills: [yss-ui, yss-domain, yss-web-controller, yss-repository, yss-ddd-scaffold-generator, yss-layered-mvc-scaffold-generator, yss-frontend-scaffold-generator, implement, tdd]
     description: >-
       Own Discovery language, users, MVP, non-goals, success criteria, test
       seams, and Spec prose. Propose CONTEXT.md glossary entries. Do not freeze
@@ -101,8 +101,8 @@ roles:
     title: YSS 产品经理
     stages: [stage.discovery, 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-antd-design, yss-research, competitive-intelligence]
-    forbidden_skills: [yss-ui, yss-domain, yss-repository, yss-web-controller, yss-ddd-scaffold-generator, implement, tdd]
+    core_skills: [yss-design-system, yss-prototype-stage, prototype-review, yss-antdv-next-design, 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
@@ -111,7 +111,8 @@ roles:
       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-antd-design.
+      yss-antdv-next-design. Explicit React/AntD compatibility prototypes use
+      yss-antd-design conditionally.
 
   - id: role.project-manager
     name: 项目经理
@@ -137,8 +138,8 @@ 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-page-module-development, 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]
-    forbidden_skills: [yss-domain, yss-application, yss-repository, yss-mybatis, yss-web-controller, yss-ddd-scaffold-generator, java-backend-commit]
+    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]
+    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
@@ -152,8 +153,8 @@ roles:
     title: YSS 后端工程师
     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]
-    core_skills: [yss-implementation-contract-compiler, yss-tactical-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]
-    forbidden_skills: [yss-ui, yss-page-module-development, yss-formily, yss-frontend-scaffold-generator, yss-antd-design, page-list-module, page-form-module]
+    core_skills: [yss-implementation-contract-compiler, yss-tactical-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]
     description: >-
       Own OpenAPI Draft, data-architecture contributions, and backend tests.
       Write only contract-allowed backend paths. Verify with ./mvnw. Do not
@@ -168,8 +169,8 @@ roles:
     stages: [stage.spec-architecture, stage.vertical-slice-implementation, stage.verification-release-retrospective]
     draft_artifact_ids: [artifact.frontend-implementation-verification]
     owned_evidence_ids: [evidence.fresh-verification, evidence.frontend-implementation-verification]
-    core_skills: [tdd, diagnosing-bugs, code-review, alibaba-java-code-style, yss-ui, yss-design-system, yss-page-module-development, yss-domain, yss-application, yss-repository, yss-web-controller, yss-dto, mapstruct, lombok]
-    forbidden_skills: [yss-ddd-scaffold-generator, yss-frontend-scaffold-generator, implement, to-spec]
+    core_skills: [tdd, diagnosing-bugs, code-review, alibaba-java-code-style, yss-ui, yss-design-system, yss-ui-business-page-generation, yss-domain, yss-application, yss-repository, yss-web-controller, yss-dto, mapstruct, lombok]
+    forbidden_skills: [yss-ddd-scaffold-generator, yss-layered-mvc-scaffold-generator, yss-frontend-scaffold-generator, implement, to-spec]
     description: >-
       Own test code, defect records, fresh verification, and frontend
       implementation verification evidence. Review every implementation slice
@@ -214,6 +215,7 @@ gate_policy:
     - gate.design-reviewed
     - gate.architecture-reviewed
   evidence_only:
+    - gate.frontend-delivery-inputs-verified
     - gate.repository-identity-valid
     - gate.prototype-verified
   orchestrator:
@@ -248,9 +250,41 @@ gate_policy:
     - gate: gate.openapi-frozen
       drafter: role.backend-engineer
       countersigners: [role.product-manager, role.test-engineer]
-  product_digital_human_with_biological_veto:
-    - gate.user-confirmation
+  product_digital_human_with_biological_veto: []
   biological_human:
+    - gate.user-confirmation
     - gate.release-ready
   runtime_side_effect_approval: biological-human
   commercial_contract: biological-human
+
+# 用户决定是关键业务/授权条件；不替代数字人专业审查，不新增 gate。
+user_decision_policy:
+  schema_version: 1
+  default_responder: requester
+  delegate_requires_requester_evidence: true
+  source_kinds: [platform-message, session-export, user-confirmation-file]
+  gates:
+    - gate.domain-strategy-approved
+    - gate.stage-decision-package-approved
+    - gate.spec-baseline-approved
+    - gate.user-confirmation
+    - gate.openapi-frozen
+    - gate.design-reviewed
+    - gate.architecture-reviewed
+    - gate.release-ready
+  work_units:
+    work-unit.discovery-requirements: discovery-conclusion
+    work-unit.service-project-initialization: scaffold-choice
+    work-unit.slice-implementation: implementation-scope
+    work-unit.release-and-retrospective: gate.release-ready
+  work_unit_gates:
+    work-unit.domain-strategy-design: [gate.domain-strategy-approved]
+    work-unit.stage-decision: [gate.stage-decision-package-approved]
+    work-unit.spec-synthesis: [gate.spec-baseline-approved]
+    work-unit.prototype-design: [gate.user-confirmation]
+    work-unit.technical-analysis: [gate.design-reviewed, gate.openapi-frozen, gate.architecture-reviewed]
+  conditional_decisions: [scaffold-choice, external-input, new-authorization, risk-acceptance]
+  waiting_allows: independent-work-only
+  expiry: basis-change-or-revocation-only
+  record_schema: docs/process/schemas/user-decision.schema.json
+  verifier: scripts/verify-user-decision

package/template/docs/agents/domain.md

@@ -1,10 +1,10 @@
-# 领域文档
+# 业务词汇与决策文档
 
-本文规定 Engineering Skills 在探索仓库、起草 Ticket、设计架构或实施代码前，如何读取和使用领域文档。
+本文规定 Engineering Skills 在探索仓库、起草 Ticket、设计架构或实施代码前，如何读取和使用业务词汇与决策文档。
 
 ## 文档布局
 
-本仓库采用单上下文布局：
+本仓库只维护一份根业务词汇表：
 
 ```text
 /
@@ -17,14 +17,15 @@
 
 根据任务影响范围读取：
 
-- `CONTEXT.md`：领域术语和统一语言。
+- 根目录唯一的 `CONTEXT.md`：流程术语、业务术语和统一业务词汇；禁止按业务责任区重复创建。
 - `docs/adr/`：与当前任务相关的架构决策。
 
-如果文件尚不存在，继续执行即可，不需要将缺失本身报告为问题。`domain-modeling` skill 会在形成稳定术语或架构决策时按需创建或更新领域文档。
+`CONTEXT.md` 缺失时必须先恢复该合同；`domain-modeling` skill 会在形成稳定术语或关键决策时按需更新业务词汇或 ADR。
 
 ## 使用规则
 
 - 在 Spec、Ticket 标题、测试、架构说明和实施总结中使用 `CONTEXT.md` 定义的中文术语。
 - 业务术语必须同时有 PascalCase `英文标识`；代码类型 / 字段与契约 property 使用该词干按 `CONTEXT.md` 文首规则变形。不把具体类全名、表名或接口路径写入词汇表。
-- `CONTEXT.md` 是领域词汇表，不是需求或实现规格；临时计划和未确认猜测不写入。
+- `CONTEXT.md` 是业务词汇表，不是需求或实现规格；临时计划和未确认猜测不写入。
+- 业务术语身份固定为 `<ContextId>/<EnglishIdentifier>`；`ContextId` 来自已确认的业务责任区，跨责任区共享才使用 `Global`。生命周期资产只保存结构化 snapshot 与双摘要，不使用 Markdown 标题锚点冒充可解析引用。
 - 如果提案与现有 ADR 或已冻结术语冲突，必须在继续执行前明确指出冲突。

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

@@ -2,6 +2,23 @@
 
 本文记录已退役技能入口的迁移路径。退役技能不保留物理目录、投影或 lock 条目；本文件是历史名称的唯一持久兼容说明。
 
+## 技能面收敛与前端入口合并（2026-09-05）
+
+以下 Skill 已一次性硬退役，不保留 alias、兼容目录、投影或 lock 条目：
+
+- 通用路由与维护工具：`ask-matt`、`dispatching-parallel-agents`、`loop-me`、`migrate-to-shoehorn`、`scaffold-exercises`、`setup-pre-commit`、`setup-ts-deep-modules`、`teach`、`writing-beats`、`writing-fragments`、`writing-shape`。
+- 前端重复或失效入口：`prototype-page-acceptance`、`yss-page-module-development`（及旧名 `page-module-development`）、`yss-microapp-commit`（及旧名 `microapp-commit`）。
+
+新工作迁移到：
+
+- 通用生命周期路由直接使用 `yss-product-lifecycle`；并行执行遵循 `docs/process/subagent-collaboration.md` 和运行时原生协调能力。
+- 前端业务页面统一使用 `yss-ui` + `yss-ui-business-page-generation`，按影响面加载组件、Formily、表格、树、API、主题和高度专项 Skill。
+- 原型还原使用批准且摘要当前的 Visual Baseline、`frontend_implementation_plan` 与 `frontend_implementation_verification`；只做 type-check 不构成还原通过。
+- 前端与微应用提交统一使用 `frontend-commit`，scope 以仓库真实规则和业务模块为准，不再按目录机械映射。
+- 已退役的个人工作流、教学、练习、写作实验和 Shoehorn 专项迁移能力不再随 YSS 模板分发；需要时由使用者在目标仓库单独安装。
+
+历史冻结证据和候选快照继续只读保留。活跃 Registry、Recipe、任务包、模板、脚本和文档不得再把这些 ID 作为正向输入。
+
 ## 实现合同与源码索引技能硬替换（2026-09-04）
 
 `yss-router` 已由 `yss-implementation-contract-compiler` 硬替换；`yss-source-index` 已由 `yss-skill-source-index-refresh` 硬替换。两个旧 ID 不保留 alias、兼容目录、投影或 lock 条目，也不能作为 Recipe、合同、模板或脚本的正向输入。
@@ -22,8 +39,9 @@
 - 阶段合同：`yss-prototype-stage`
 - 原型档位与主入口：`yss-prototype-stage` 的 H1/H2 路由
 - Codex 产品设计能力：按档位条件使用 `product-design:index`
-- Ant Design v6 事实与 CLI：仅相关 H2 使用 `yss-antd-design`
+- Antdv Next 精确版本事实：默认 H2 使用 `yss-antdv-next-design`
+- Ant Design v6 事实与 CLI：仅显式 React 兼容 H2 使用 `yss-antd-design`
 - 真实组件核验：不属于原型档位；进入已批准切片后由 `yss-ui` 基于目标 lockfile 执行，并写入前端实现验证
 - 独立低保真评审：`prototype-review`
 
-已关闭的 schema v1/v2、旧 artifact ID、AntD CLI、浏览器验证和确认记录只读保留。在途工作迁移到 schema v3 与 `artifact.prototype-deliverable` 后再关闭门禁；不得创建同名兼容目录或删除历史证据。
+已关闭的 Prototype Evidence schema v1/v2/v3、旧 artifact ID、AntD CLI、浏览器验证和确认记录只读保留。在途 UI 工作迁移到 Prototype Evidence schema v4、Visual Baseline schema v1 与 `artifact.prototype-deliverable` 后再关闭门禁；无 UI 影响不创建空包。不得创建同名兼容目录或删除历史证据。

package/template/docs/agents/skills-maintenance.md

@@ -29,9 +29,9 @@
 
 项目允许按 YSS 流程适配上游 skill，但必须同时保留可追溯的上游信息和适配后的有效哈希。
 
-当前 Matt 快照为 `0ab1b63a410a03d3627979a109c8695de27af954`。`ask-matt` 的关联入口包括 `to-questionnaire`、`wait-what`、`writing-for-agents` 和 `PHASE-BOUNDARIES.md`；这些支持文件随共享 skill 目录一起计算 `effectiveHash`，不得单独投影或维护。
+当前 Matt 快照为 `0ab1b63a410a03d3627979a109c8695de27af954`。模板按 YSS capability 白名单收录上游 Skill；已退役的通用路由、个人工作流、教学、练习、写作实验和专项迁移 Skill 不再随 project-instance 分发。
 
-本轮升级还将生命周期适配固定为：阶段边界只写可选 `phase_boundary` 证据；`to-questionnaire` 使用 `external-input-required` 暂停并在答案回流后重新分类影响面；Matt `prototype` 的单文件 HTML 只作为回流输入，YSS 原型仍须完成低保真评审、H1/H2 档位路由、schema v3 验证和用户确认。人工 checkpoint 与 `diagnosing-bugs` 的输出必须脱敏，`wait-what` 不改变生命周期状态。
+本轮升级还将生命周期适配固定为：阶段边界只写可选 `phase_boundary` 证据；`to-questionnaire` 使用 `external-input-required` 暂停并在答案回流后重新分类影响面；Matt `prototype` 的单文件 HTML 只作为回流输入，YSS 原型仍须完成低保真评审、H1/H2 档位路由、Prototype Evidence schema v4、Visual Baseline schema v1 验证和用户确认。人工 checkpoint 与 `diagnosing-bugs` 的输出必须脱敏，`wait-what` 不改变生命周期状态。
 
 ## 维护流程
 
@@ -94,7 +94,7 @@ YSS 技能的公开发布仓库为 `iloveZzz/yss-spec-dev-skills`，它是本模
 - 发布顺序为：同步 canonical projections → 更新 lock → `scripts/verify-template` → 导出并检查 → 独立审查 → 在 `yss-spec-dev-skills` 提交人工 PR。不得从目标仓库反向覆盖 `.agents/skills`。
 - skills.sh 通过 `npx skills add iloveZzz/yss-spec-dev-skills` 的安装遥测自动发现技能，不需要手工注册；遥测可用 `DISABLE_TELEMETRY=1` 或 `DO_NOT_TRACK` 关闭。
 
-已退休、personal 或由 YSS 有意排除的条目（`design-an-interface`、`qa`、`request-refactor-plan`、`ubiquitous-language`、`edit-article`、`obsidian-vault`、`writing-great-skills`、`web-design-engineer`、`web-video-presentation`、`wireframe-prototype`、`wizard`、`git-guardrails-claude-code`、`claude-handoff`、`batch-grill-me`）不再进入 `.agents/skills`、六个共享投影根或 `skills-lock.json`。其中 `wizard` 是最新上游仍存在但 YSS 当前有意排除的人工步骤技能，不应描述为上游已退休。迁移时使用 `codebase-design`、`triage + to-tickets`、`to-spec + improve-codebase-architecture`、`domain-modeling`、`product-design:index`、普通人工 checkpoint 或 `handoff` 等现行路由，不创建兼容目录。
+已退休、personal 或由 YSS 有意排除的条目不再进入 `.agents/skills`、六个共享投影根或 `skills-lock.json`。退役 ID、日期和替代路径只在 [`skill-migrations.md`](./skill-migrations.md) 持久化，其他活跃文档不得重复维护清单或创建兼容目录。其中 `wizard` 是最新上游仍存在但 YSS 当前有意排除的人工步骤技能，不应描述为上游已退休。
 
 ## 外部工作流工具
 

package/template/docs/agents/strategic-design-skills-integration.md

@@ -6,6 +6,7 @@
 - `yss-prototype-stage`
 - `yss-design-system`
 - `yss-antd-design`
+- `yss-antdv-next-design`
 - `yss-stage-decision`
 
 父模板通过 `.agents/skills/.strategic-design-skills-manifest.json` 固定上游 Git revision、路径和 tree hash。公共 ID 不因 profile 改名；共享规则先在战略设计源仓演进，再由父模板同步。
@@ -20,7 +21,7 @@
 | `yss-prototype-stage` | 用户确认后由完整生命周期判断 API 影响和实现准备 |
 | `yss-stage-decision` | 门禁状态由 `yss-product-lifecycle` 维护 |
 
-`yss-design-system` 与 `yss-antd-design` 当前不需要父模板内容适配，必须与锁定的上游 tree hash 一致。任何有效内容差异都必须保留本文件为 `adaptationRef`，不得复制成第二套公共技能身份。
+`yss-design-system`、`yss-antd-design` 与 `yss-antdv-next-design` 当前不需要父模板内容适配，必须与锁定的上游 tree hash 一致。任何有效内容差异都必须保留本文件为 `adaptationRef`，不得复制成第二套公共技能身份。
 
 ## 更新与验证
 
@@ -39,3 +40,7 @@
    ```
 
 父模板、战略设计源仓与 CLI 快照必须按源仓 → 父模板 → CLI 顺序固定 revision；旧实例不回填，也不提供迁移检查器。
+
+## 真实用户决定适配
+
+模板生命周期的关键决定统一消费 `docs/agents/digital-human-roles.yaml.user_decision_policy`。本地原型确认与阶段决策批准追加真实回复、当前资产和范围校验；数字人审查保留。记录协议见 [用户决定协议](../../.agents/skills/yss-product-lifecycle/references/user-decisions.md)。此适配只更新 effective hash，不改写已锁定的上游 revision/hash，也不发布外部技能源。

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

@@ -6,6 +6,40 @@ description: >-
   单一可执行注册表。实现合同编译器与生命周期编排器只消费通过本表校验的
   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_compiler: true
   consumed_by_lifecycle: true
@@ -23,6 +57,9 @@ capability_contract:
     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] }
@@ -45,12 +82,19 @@ capabilities:
   - { 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.mvc, primary_skill: yss-mvc-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.domain-behavior, capabilities: [layer.domain, layer.application, quality.java-code-style] }
-  - { id: backend.persistence-mybatis, capabilities: [layer.persistence, framework.mybatis, codegen.mapstruct, codegen.lombok, quality.java-code-style] }
-  - { id: backend.http-api, capabilities: [layer.web-adapter, contract.dto-wire, contract.request-validation, contract.error-mapping, codegen.mapstruct, codegen.lombok, quality.java-code-style] }
+  - { 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] }
@@ -59,16 +103,19 @@ recipes:
   - { 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.mvc, 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-antd-design, type: context-conditional, when: h2-react-antd }
+    - { 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 }
@@ -111,11 +158,6 @@ skill_dependencies:
     - { 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-page-module-development:
-    - { 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:
@@ -154,6 +196,11 @@ invocation_contract:
       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
@@ -174,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
@@ -210,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
@@ -276,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
@@ -294,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
@@ -324,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
@@ -402,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
@@ -468,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
@@ -534,15 +527,18 @@ skills:
     instance_default_discoverable: false
     aliases: []
     impacts: [frontend]
-  - id: yss-microapp-commit
-    layer: maintainer-only
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: [microapp-commit]
-    impacts: [frontend]
   - id: yss-mvc-scaffold-generator
     layer: specialist
-    maturity: supported
+    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
     instance_default_discoverable: false
     aliases: []
     impacts: [backend]
@@ -564,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
@@ -732,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,7 +16,7 @@
 | 原型 / 线框图 |  |  |
 | 状态矩阵 | `docs/.scratch/<feature>/design/<feature>-state-matrix.md` |  |
 | 原型评审结论 | `docs/.scratch/<feature>/design/<feature>-prototype-review.md` |  |
-| 原型交付物 | `docs/.scratch/<feature>/design/prototypes/index.html` 或稳定 URL | 有产品设计影响时必需；必须引用 schema v3 档位决策与交付物验证 |
+| 原型交付物 | `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` |  |
@@ -37,7 +37,7 @@
 | YAML 权威性 | 单一 OAS 3.1 document；未混入生命周期 frontmatter / 根字段；`operationId` 稳定 |  |  |
 | P0 覆盖 | 每个 P0 需求有 endpoint/schema/error/test 或明确非目标 |  |  |
 | 产品总体设计完整 | Draft 已依据 Spec 和产品总体设计 / 功能架构；缺产品总体设计时返回上游补齐 |  |  |
-| 交互输入完整 | 有产品设计影响时，Draft 已同时依据交互说明、低保真、状态矩阵、prototype-review、H1/H2 原型交付物、schema v3 浏览器/Design QA/条件 AntD 事实和用户确认；无产品设计影响时说明不适用原因 |  |  |
+| 交互输入完整 | 有产品设计影响时，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 语义闭环 |  |  |