create-yss-spec 3.4.5 → 3.4.7

package/template/.pi/skills/yss-validation/references/source-index.md

@@ -1,33 +1,10 @@
-# yss-validation Source Index
+# yss-validation Source Index Router
 
-Generated: 2026-08-17T12:03:37.436Z
-Source commit: `38b556a5081e6c66c0c538cbc1ef839b19996ed3`
-Source worktree: `dirty`
-Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT` to reproduce or refresh.
+Index schema: `backend-component-source-index-router-v1`
 
-This file is generated by `yss-skill-source-index-refresh/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
+Select the source index from the approved `platform_configuration.component_platform_line`; do not infer a line from imports, a branch name or a requested upgrade.
 
-Paths below are source path hints captured at refresh time. If they do not exist in the current workspace, locate sources using `YSS_SOURCE_ROOT`, CodeGraph, package/class names, Maven artifact names, or repository search before assuming the source is unavailable.
+- `boot2-java8` — [Spring Boot 2.7 / Java 8 maintenance line](source-index.boot2-java8.md)
+- `boot3-java17` — [Spring Boot 3.5 / Java 17 mainline](source-index.boot3-java17.md)
 
-## Component Path Hints
-
-- `yss-microservice-components/yss-component-validation-engine-parent` (missing when indexed)
-- `yss-microservice-components/yss-component-validation-jsr303` (existed when indexed)
-
-## Documentation Files
-
-- `yss-microservice-components/yss-component-validation-jsr303/readme.md`
-
-## Maven Modules
-
-- `yss-microservice-components/yss-component-validation-jsr303`
-
-## Key Java Entry Points
-
-- No key Java entry points matched the configured name patterns.
-
-## Recommended Next Reads
-
-- Start with the documentation files above when learning component usage.
-- Search the key Java entry points for annotations, auto configuration, properties, aspects, interceptors, handlers, and result objects before changing application code.
-- Prefer existing component extension points over rewriting framework logic in business modules.
+Run the freshness checker with the same explicit `--platform-line` and its matching clean source root before exact integration guidance.

package/template/.pi/skills/yss-web-controller/SKILL.md

@@ -47,7 +47,7 @@ node scripts/generate_controller.mjs \
   --domain-segment example \
   --web-project-dir /path/demo-adapter/demo-web \
   --application-service-package com.yss.demo.application.service \
-  --validation-namespace javax
+  --validation-namespace <resolved-platform-namespace>
 ```
 
 ## 输出预期
@@ -68,10 +68,10 @@ node scripts/generate_controller.mjs \
 - HTTP Request 不继承会暴露内部协作字段的 `PageQuery`；只生成冻结 OpenAPI allowlist 字段，禁止把 `offset`、`needTotalCount`、`tempTotalCount` 变成客户端输入。
 - `fields.<table>.pagination` 必须显式列出 `yss-dto` wire profile 允许暴露的字段子集；模板不得无条件生成字段或自行定义默认值。
 - 先跑脚本，再按项目规范做少量手调。
-- `javax` / `jakarta` validation namespace 必须来自工程基线，不得按记忆选择。
+- Validation namespace 参数必须来自批准的精确平台配置和当前工程基线，不得按记忆或 Boot 大版本自行选择。
 - 若用户只是要改单个 Controller，先看现有代码，不要盲覆盖整个目录。
 - 脚本是 initialize-only；写入前先规划全部目标并校验 `allowed_write_paths`，任一目标已存在或传入 `--force` 时整体返回 `unsupported`。落盘使用排他创建和失败回滚，不得留下部分文件；旧项目迁移不属于该生成器。
-- `integration_mode=existing-project` 保留已登记工程的 Boot 2/Boot 3 能力；`integration_mode=scaffold-v2` 必须提供 `--scaffold-manifest-file`，且 Manifest 已达到 `empty-scaffold-verified`，Profile、基础包和标准 Web module 路径全部一致。
+- `integration_mode=existing-project` 只复用工程登记、effective POM 与依赖树共同证明的精确平台，不从 Boot 大版本推断能力；`integration_mode=scaffold-v2` 必须提供 `--scaffold-manifest-file`，且 Manifest 已达到 `empty-scaffold-verified`，Profile、基础包、标准 Web module 路径和平台绑定全部一致。
 
 ## 按需读取
 
@@ -92,4 +92,4 @@ node scripts/generate_controller.mjs \
 
 ## 新脚手架平台约束
 
-消费批准切片架构身份中的 `platform_configuration`，与工程 Manifest 核对后使用对应 YSS 组件。Boot 2.7 使用 `javax` Web/Validation API；Boot 3.5/4.1 使用 `jakarta`。Boot 4 按 Jackson 3、对应自动配置和 starter 适配；不替换 `javax.sql` 等 Java SE 包。平台不一致、兼容条目缺失或候选未验证时回合同编译器阻断，不在业务实现中升级或替换组件。详见 仓库共享合同 `docs/engineering/backend-platforms.md`。
+消费批准切片架构身份中的 `platform_configuration`，并与工程 Manifest、effective POM 和依赖树核对。DTO、Validation、Exception 或其他 YSS 组件命中时，逐项消费合同中的 `component_bindings`；缺少 verified 架构证据、构件摘要或绑定发生漂移时回合同编译器阻断。Validation namespace、Jackson wire 行为、Web starter 和自动配置机制只来自解析后的精确平台事实；命令参数必须使用该解析值，不在本 Skill 中按 Boot 大版本硬编码。不得在业务实现中升级、降级或替换组件；平台迁移使用独立迁移工作单元。详见仓库共享合同 `docs/engineering/backend-platforms.md`。

package/template/.pi/skills/yss-web-controller/scripts/generate_controller.test.mjs

@@ -13,7 +13,7 @@ const dtoWireProfileDigest = createHash("sha256").update(await readFile(dtoWireP
 
 for (const [profile, module, placement, modules, generator] of [
   ["layered-mvc-service", "service", "server", ["server", "service", "repository"], "yss-layered-mvc-scaffold-generator"],
-  ["mvc-data-analysis-v1", "core", "client", ["server", "core", "client", "repository", "adapter", "feign-client"], "yss-mvc-data-analysis-project-initializer"]
+  ["mvc-data-analysis-v1", "core", "client", ["server", "core", "client", "repository", "adapter", "feign-client"], "yss-layered-mvc-scaffold-generator"]
 ]) test(`${profile} binds MVC service types, DTO ownership and drift checks`, async (t) => {
   const data = await fixture({ platform_profile: "spring-boot-2.7-jdk8", validation_namespace: "javax" });
   t.after(() => rm(data.root, { recursive: true, force: true }));

package/template/.pi/skills/ytable-usage/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ytable-usage
-description: "配置或修复 YSS UI YTable 的列、分页、行操作、筛选、拖拽与插槽；完整列表流程用 page-list-module。"
+description: "配置或修复 YSS UI YTable 的列表查询、列、分页、行操作、筛选、拖拽、插槽与自适应高度。"
 ---
 
 # YTable 使用
@@ -19,7 +19,7 @@ description: "配置或修复 YSS UI YTable 的列、分页、行操作、筛选
 
 1. 当前会话可用 yss-ui MCP 时，先用 `get_component_docs` 查询 `YTable` 的 Props、Events、Slots、Types 与实例方法；需要远程分页、筛选、操作列、拖拽或工具栏时，再用 `get_demo` 获取对应官方 Demo。
 2. MCP 工具不可用、调用失败或用 `search_docs/list_components` 校正后仍无结果时，才读取最新 `llms-full.txt`；若文档与当前项目依赖版本不一致，用当前源码和导出核验。
-3. 把远程数据、`loading`、分页映射、API 调用和事件处理放入 Hook；把列定义和纯配置放入 `constant.ts`。
+3. 把 `currentParams`、远程数据、`loading`、分页映射、选择态、API 调用和事件处理放入 Hook；把列定义和纯配置放入 `constant.ts`。
 4. 在模板中组合 `data/columns/loading/pagination`，并根据真实开启的工具栏和分页配置高度 Hook。
 5. 完成后核对删除确认、远程筛选、分页字段映射和 API 错误处理边界。
 
@@ -37,6 +37,9 @@ description: "配置或修复 YSS UI YTable 的列、分页、行操作、筛选
 - 远程筛选必须提供稳定 `filters`，设置 `filterMethod: () => true` 禁用本地二次过滤，并监听 `filter-change`。
 - 自适应滚动列表绑定 `:height="tableHeight"`；`pageable`、工具栏分别对应 `withPagination: true`、`withToolbar: true`。纯短表不强制引入高度 Hook。
 - `mutator.ts` 已对网络错误和 `success === false` 统一 `message.error` 并 reject。API Hook 不再检查 `success === false`，不在 `else/catch` 重复 `message.error`；用 `finally` 恢复 loading，让异常继续中断流程。
+- 远程列表只维护一份 `currentParams`。查询和重置回到第一页，翻页只更新页码与页大小并保留筛选条件；刷新、导出和编辑后重载复用同一参数源。批量操作成功后清空受控选中态和组件内部选中态。
+- 使用真实签名 `useTableHeight(tableAreaRef, options)`，结果绑定 `:height="tableHeight"`。稳定布局采用可计算高度的 flex column，表格区设置 `flex: 1; min-height: 0; overflow: hidden`，不用固定大高度或魔法偏移。
+- `pageable`、工具栏插槽、YEditTable 添加按钮分别对应 `withPagination`、`withToolbar`、`withAddButton`；只扣除实际开启的区域。shrink-wrap 容器使用更外层稳定 `boundaryRef`，弹层或隐藏布局仅在可见后按需 `nextTick(recalculateHeight)`。
 
 ## 标准代码骨架
 
@@ -105,16 +108,19 @@ export interface ItemListApi {
 export const useItemList = (api: ItemListApi) => {
   const dataList = ref<ItemRow[]>([]);
   const loading = ref(false);
+  const currentParams = ref({ pageIndex: 1, pageSize: 20 });
   const pagination = ref<YTablePagination>({ current: 1, pageSize: 20, total: 0, remote: true });
 
   /** 查询当前页；错误提示由 mutator 统一处理。 */
   const loadList = async () => {
     loading.value = true;
     try {
-      const result = await api.queryPage({
+      currentParams.value = {
+        ...currentParams.value,
         pageIndex: pagination.value.current,
         pageSize: pagination.value.pageSize,
-      });
+      };
+      const result = await api.queryPage(currentParams.value);
       dataList.value = result.list ?? [];
       pagination.value = { ...pagination.value, total: result.totalCount ?? 0 };
     } finally {
@@ -134,7 +140,7 @@ export const useItemList = (api: ItemListApi) => {
     await loadList();
   };
 
-  return { dataList, loading, pagination, loadList, handlePageChange, handleDelete };
+  return { currentParams, dataList, loading, pagination, loadList, handlePageChange, handleDelete };
 };
 ```
 
@@ -196,7 +202,7 @@ onMounted(loadList);
 ```less
 /* style.less */
 .table-area {
-  height: 100%;
+  flex: 1;
   min-height: 0;
   overflow: hidden;
 }
@@ -241,6 +247,8 @@ onMounted(loadList);
 - [ ] 批量操作成功后已重置 `selectedRowKeys` 并调用 `tableRef.clearSelection()`。
 - [ ] 未使用虚构 `request/searchParams/row-key` Props，也未把 `refresh()` 当成远程请求。
 - [ ] 工具栏、字典翻译、操作确认与高度偏移均与实际开关一致。
+- [ ] 查询、重置、翻页、刷新和导出复用同一份 `currentParams`；查询/重置回到第一页，批量成功后清空选中态。
+- [ ] 高度观察容器稳定；分页/工具栏偏移没有重复扣减，隐藏态仅在必要时补算。
 - [ ] API Hook 没有 `success === false` 分支或重复 `message.error`。
 
 ## 失败兜底策略
@@ -248,4 +256,3 @@ onMounted(loadList);
 - 分页字段混乱时，在 Hook 中分离 YTable 状态和后端参数，不直接把 `pageIndex/totalCount` 绑到组件。
 - 操作过多时使用 `displayLimit` 和更多菜单；远程刷新失效时回到业务 `loadList()`，不把实例 `refresh()` 当成接口请求。
 - API 失败后只在 `finally` 恢复本地 loading，让 mutator 的 reject 继续中断删除后刷新等后续流程。
-

package/template/.pi/skills/ytree-usage/SKILL.md

@@ -32,6 +32,7 @@ description: "配置或修复 YSS UI YTree 的字段映射、搜索、选中与
 - `danger: true` 只改变危险项视觉，不会弹出确认框。删除必须放在节点附近的 `#node-suffix` 或当前选中节点操作区，用 Ant Design Vue `Popconfirm` 的 `@confirm` 调用接口；不使用居中 `Modal.confirm`。
 - 树区域需要滚动时绑定 `:height="treeHeight"`，不默认添加 `:virtual="true"`。只有展开后可见扁平节点数 `* itemHeight > height` 时才会实际裁剪 DOM。
 - 使用 YTree 内置搜索时，高度 Hook 通过 `extraOffset: YTREE_SEARCH_HEIGHT` 扣除 48px；不再叠加无依据的魔法数。
+- 最外层必须有可计算高度，树区域设置 `flex: 1; min-height: 0; overflow: hidden`；Hook 挂载时 `treeAreaRef` 必须存在。Tab/Drawer 优先保持外层容器挂载，隐藏态得到的最小高度不作为最终结果，可见后按需 `nextTick(recalculateHeight)`。
 - 左树右表优先组合 `YSplitPane + YCard + YTree + YTable`；切换节点时同步查询条件并把右表分页重置为第 1 页。
 - 节点删除 API 的错误由 `mutator.ts` 统一提示并 reject；不在 `else/catch` 重复 `message.error`。
 

package/template/docs/agents/backend-architecture-profiles.md

@@ -21,7 +21,7 @@ Profile、模块闭包、生成器、成熟度和 Recipe 的权威映射见 `yss
 
 - 新脚手架统一 `verification_database=h2`、`production_database=not-bound`。仅测试和显式 `scaffold-local` 使用 H2；普通配置不设置数据库或默认激活 Profile。不另加生产驱动、第三方数据源或 Mock 服务。
 - 生产数据库、DDL、索引和方言在后续批准的存储工作单元接入；H2 测试不能证明生产方言兼容。脚手架不包含业务 SQL、schema/data 占位或业务 API。
-- DDD / 通用 MVC 消费批准的 `platform_configuration` v1，平台清单与证据规则见 `docs/engineering/backend-platforms.md`。数据分析初始化器保留 `spring-boot-2.7-jdk8` / `javax`，不自动开放新平台。组件 Skill 不擅自升级 Java、Boot、处理器或替换 YSS 依赖。MapStruct + Lombok 必须验证 binding 与生成代码编译。
+- DDD / 通用 MVC 消费批准的 `platform_configuration` v2，平台清单与证据规则见 `docs/engineering/backend-platforms.md`。凡注册表标记 `component_binding: required` 的能力，编译器必须从该配置指向的同一 compatibility 条目解析 `component_capabilities`；未登记、非 `verified`、架构证据缺失或构件摘要漂移均阻断。数据分析初始化器保留 `spring-boot-2.7-jdk8` / `javax`，不自动开放新平台。组件 Skill 不擅自升级 Java、Boot、处理器或替换 YSS 依赖。MapStruct + Lombok 必须验证 binding 与生成代码编译。
 - 对 SQL 注入、敏感信息、权限和事务的规则不因 H2 或模板而豁免。MySQL 专属语法规则仅适用于批准的 MySQL 存储工作单元；框架命名/返回包装等差异须记录明确的 YSS 基线例外。
 
 ## 验证含义

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

@@ -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-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 ]
+    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, 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.
@@ -124,8 +124,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, 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, page-list-module, page-form-module ]
+    core_skills: [ yss-implementation-contract-compiler, yss-technical-design, 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 ]
     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.
 

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

@@ -2,17 +2,53 @@
 
 本文记录已退役技能入口的迁移路径。退役技能不保留物理目录、投影或 lock 条目；本文件是历史名称的唯一持久兼容说明。
 
+## 后端组件源码索引双轨迁移（2026-09-19）
+
+后端组件 Skill 的单一 `references/source-index.md` 已迁移为平台线选择页。生成证据分别保存在 `source-index.boot2-java8.md` 与 `source-index.boot3-java17.md`，来源根分别由 `YSS_SOURCE_ROOT_BOOT2_JAVA8` 与 `YSS_SOURCE_ROOT_BOOT3_JAVA17` 显式提供。
+
+- 精确接入、代码生成和配置指导必须从批准的 `platform_configuration.component_platform_line` 选择索引，并以相同 `--platform-line` 和匹配源码根运行 freshness 检查。
+- 平台线缺失、源码根错配、组件 tree 漂移或组件子树 dirty 均返回 `blocked`；禁止退回另一代索引，也不能用源码可编译替代构件兼容认证。
+- 历史提交中的单轨索引只作只读证据；当前刷新不得覆盖另一平台线或把两个变量指向同一代源码。
+
+## 前端 Skill 面二次收敛（2026-09-20）
+
+以下入口已硬退役，不保留运行时 alias、物理目录、投影、Registry 条目或 lock 条目：
+
+- `page-skeleton`：页面目录、职责拆分和组合流程由 `yss-ui-business-page-generation` 持有。
+- `component-selection-imports`：组件路由、真实导出和受控 Ant Design Vue 回退由 `yss-ui` 及其 `references/component-routing.md` 持有。
+- `page-list-module`：页面编排归 `yss-ui-business-page-generation`，请求参数与异步状态归 `yss-hook`，表格 API、分页、选择态和高度归 `ytable-usage`。
+- `page-form-module`：页面容器生命周期归 `yss-ui-business-page-generation`，Schema、模式、联动和分步行为归 `yss-formily` 路由的专项 Skill。
+- `yss-use-table-height`：YTable/YEditTable 高度分别归 `ytable-usage`、`yedit-table-usage`。
+- `yss-use-tree-height`：YTree 高度归 `ytree-usage`。
+- `vue3-best-practices`：请求竞态、单一参数源和组件状态规则归 `yss-hook`；长整型与普通 number 的类型边界以 `yss-api-integration` 为准。
+
+上游名称 `use-table-height`、`use-tree-height` 不再作为 Registry alias，只在 `.yss-skills-manifest.json` 的排除清单和历史证据中出现。活跃合同必须直接使用替代入口；命中旧 ID 返回 `skill-retired`。
+
+## 后端设计与脚手架入口硬退役（2026-09-20）
+
+以下入口已完成硬退役，不保留 alias、物理目录、投影、Registry 条目或 lock 条目：
+
+- `yss-mvc-design`：新工作使用 `yss-technical-design`。MVC schema、规则和 API impact 的 OpenAPI review 条件依赖由技术设计入口持有。
+- `yss-mvc-data-analysis-project-initializer`：新工作使用 `yss-layered-mvc-scaffold-generator` 的 `mvc-data-analysis-v1` Profile，继续保留六模块、H2、CONTEXT handoff、skillUtils 和独立 Git 行为。
+- `yss-backend-scaffold-parent`：新工作使用 `yss-ddd-scaffold-generator`；工程基线由生成器内部 `references/engineering-baseline.md` 和验证器持有。
+
+硬退役统一规则：
+
+- 旧 Slice、Technical Design 或 Scaffold Contract 因 Registry、Profile 或 generator 摘要变化变为 `stale`，必须重新编译和批准。
+- 新请求命中旧 ID 返回 `skill-retired`，迁移路径只从本文件和永久 tombstone 查询。
+- 历史冻结证据保持只读；活跃调用者必须直接使用替代入口，不得恢复兼容壳。
+
 ## 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-mvc-scaffold-generator`，新工作统一使用 `yss-layered-mvc-scaffold-generator`；数据分析工程选择 `mvc-data-analysis-v1` Profile。
 - 前端组件总入口：`yss-components`。
 
-DDD 脚手架只保留已登记并被生成合同消费的 `yss-backend-scaffold-parent`。生成后的 Application、Domain、Infrastructure、Web 和 Adapter 实现从 `yss-ddd-scaffold-generator/references/layer-skill-routing.md` 路由到顶层权威 Skill，不再把普通参考目录暴露为可发现 Skill。
+DDD 脚手架的 Parent 工程约束由 `yss-ddd-scaffold-generator/references/engineering-baseline.md` 内部持有。生成后的 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` 保留为薄路由器，不再复制表单代码骨架和专项规则。
+前端页面统一从 `yss-ui` 路由：完整页面使用 `yss-ui-business-page-generation`，组件选型与导入使用 `yss-ui/references/component-routing.md`，表格、树、Formily 和 Hook 使用各自专项 Skill；组件高度由对应表格或树专项持有。没有独立 Skill 的复杂组件契约集中在 `yss-ui/references/specialized-components.md`。`yss-formily` 保留为薄路由器，不再复制表单代码骨架和专项规则。
 
 旧 ID 只允许存在于本迁移记录、retired/obsolete 清单、负向测试和不可变历史证据中。
 

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

@@ -1,4 +1,4 @@
-schema_version: 2
+schema_version: 3
 registry_id: yss.skill-routing
 status: active
 description: >-
@@ -6,6 +6,47 @@ description: >-
   单一可执行注册表。实现合同编译器与生命周期编排器只消费通过本表校验的
   canonical 技能；skills-lock.json 继续独立持有来源、hash 与投影完整性。
 canonical_content_root: .agents/skills
+backend_skill_domains:
+  schema_version: 1
+  scope: active-yss-backend-capability-owners
+  domain_ids: [technical-design, layered-implementation, wire-framework-contract, component-capability, engineering-initialization, platform-governance-migration]
+  assignments:
+    yss-technical-design: technical-design
+    yss-tactical-design: technical-design
+    yss-domain: layered-implementation
+    yss-application: layered-implementation
+    yss-repository: layered-implementation
+    yss-web-controller: layered-implementation
+    yss-mybatis: wire-framework-contract
+    yss-dto: wire-framework-contract
+    yss-validation: wire-framework-contract
+    yss-exception: wire-framework-contract
+    yss-cache: component-capability
+    yss-userinfo: component-capability
+    yss-audit-log: component-capability
+    yss-excel-mvc: component-capability
+    yss-distributed-id: component-capability
+    yss-resilience4j: component-capability
+    yss-security-algorithm: component-capability
+    yss-ddd-scaffold-generator: engineering-initialization
+    yss-layered-mvc-scaffold-generator: engineering-initialization
+    yss-implementation-contract-compiler: platform-governance-migration
+    yss-skill-source-index-refresh: platform-governance-migration
+    yss-up-springboot3: platform-governance-migration
+  deprecated_skills: []
+backend_source_index_contract:
+  schema_version: 1
+  owner_skill: yss-skill-source-index-refresh
+  scope: yss-component-capability-skills
+  component_skills: [yss-audit-log, yss-cache, yss-distributed-id, yss-dto, yss-excel-mvc, yss-exception, yss-mybatis, yss-resilience4j, yss-security-algorithm, yss-userinfo, yss-validation]
+  selector_path: references/source-index.md
+  generated_path_pattern: references/source-index.<platform-line>.md
+  platform_lines:
+    - { id: boot2-java8, source_env: YSS_SOURCE_ROOT_BOOT2_JAVA8, generated_suffix: source-index.boot2-java8.md }
+    - { id: boot3-java17, source_env: YSS_SOURCE_ROOT_BOOT3_JAVA17, generated_suffix: source-index.boot3-java17.md }
+  platform_line_source: approved-platform-configuration
+  freshness_checker: yss-skill-source-index-refresh/scripts/check-backend-skill-source-index.mjs
+  cross_line_fallback: forbidden
 existing_project_profiles:
   existing-domain-driven-maven:
     source_kind: existing-registration
@@ -45,7 +86,7 @@ architecture_profiles:
     dto_modules: [server, client]
   mvc-data-analysis-v1:
     architecture_family: layered-mvc
-    generator_skill: yss-mvc-data-analysis-project-initializer
+    generator_skill: yss-layered-mvc-scaffold-generator
     maturity: draft
     core_modules: [server, core, client, repository, adapter, feign-client]
     capability_modules: {}
@@ -58,7 +99,7 @@ runtime_policy:
   consumed_by_lifecycle: true
   discovery_enforced: true
 capability_contract:
-  schema_version: 2
+  schema_version: 3
   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]
@@ -69,39 +110,54 @@ capability_contract:
     deduplicate_skills: true
     preserve_all_reasons: true
   deterministic_order: [recipe-declaration, dependency-topology, skill-id]
+  platform_component_binding:
+    marker: provider
+    required_kind: yss-component
+    catalog_source: docs/engineering/backend-platforms.json
+  provider_kinds: [yss-component, platform-managed, none]
+retirement_contract:
+  schema_version: 1
+  stages: [deprecated, retired]
+  deprecated_new_use: forbidden
+  cleanup_statuses: [migration-only, remove-ready]
+  hard_retirement_tombstone: docs/agents/skill-migrations.md
+  retired_id_source: scripts/lib/skill-supply-chain.mjs#OBSOLETE
+  failure_codes:
+    deprecated: skill-deprecated
+    retired: skill-retired
 capabilities:
-  - { id: writing.lifecycle-document, primary_skill: i-have-adhd, task_modes: [guidance] }
-  - { id: architecture.technical-design, primary_skill: yss-technical-design, task_modes: [guidance, integration, review-input] }
-  - { id: architecture.mvc-design, primary_skill: yss-mvc-design, architecture_family: layered-mvc, task_modes: [guidance, integration, review-input] }
-  - { 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, architecture_family: domain-driven, 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: scaffold.frontend-vue3, primary_skill: yss-frontend-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] }
+  - { id: writing.lifecycle-document, primary_skill: i-have-adhd, provider: { kind: none }, task_modes: [guidance] }
+  - { id: architecture.technical-design, primary_skill: yss-technical-design, provider: { kind: none }, task_modes: [guidance, integration, review-input] }
+  - { id: architecture.mvc-design, primary_skill: yss-technical-design, provider: { kind: none }, architecture_family: layered-mvc, task_modes: [guidance, integration, review-input] }
+  - { id: layer.mvc-service, primary_skill: yss-application, provider: { kind: none }, architecture_family: layered-mvc, task_modes: [guidance, integration, slice-implementation, troubleshooting, review-input] }
+  - { id: layer.mvc-persistence, primary_skill: yss-repository, provider: { kind: none }, architecture_family: layered-mvc, task_modes: [guidance, integration, slice-implementation, troubleshooting, review-input] }
+  - { id: layer.mvc-web, primary_skill: yss-web-controller, provider: { kind: none }, architecture_family: layered-mvc, task_modes: [guidance, integration, slice-implementation, troubleshooting, review-input] }
+  - { id: governance.implementation-contract, primary_skill: yss-implementation-contract-compiler, provider: { kind: none }, task_modes: [contract-compilation, reroute, result-validation] }
+  - { id: maintenance.skill-source-index, primary_skill: yss-skill-source-index-refresh, provider: { kind: none }, task_modes: [component-maintenance, source-index-refresh] }
+  - { id: architecture.tactical-domain, primary_skill: yss-tactical-design, provider: { kind: none }, architecture_family: domain-driven, task_modes: [guidance, integration, slice-implementation, review-input] }
+  - { id: layer.domain, primary_skill: yss-domain, provider: { kind: none }, task_modes: [guidance, integration, slice-implementation, troubleshooting, review-input] }
+  - { id: layer.application, primary_skill: yss-application, provider: { kind: none }, task_modes: [guidance, integration, slice-implementation, troubleshooting, review-input] }
+  - { id: layer.persistence, primary_skill: yss-repository, provider: { kind: none }, task_modes: [guidance, integration, slice-implementation, troubleshooting, review-input] }
+  - { id: layer.web-adapter, primary_skill: yss-web-controller, provider: { kind: none }, task_modes: [guidance, integration, slice-implementation, troubleshooting, review-input] }
+  - { id: contract.dto-wire, primary_skill: yss-dto, provider: { kind: yss-component, binding_id: contract.dto-wire }, task_modes: [guidance, integration, slice-implementation, troubleshooting, review-input] }
+  - { id: contract.request-validation, primary_skill: yss-validation, provider: { kind: platform-managed, binding_id: spring-validation }, task_modes: [guidance, integration, slice-implementation, troubleshooting, review-input] }
+  - { id: contract.error-mapping, primary_skill: yss-exception, provider: { kind: yss-component, binding_id: contract.error-mapping }, task_modes: [guidance, integration, slice-implementation, troubleshooting, review-input] }
+  - { id: framework.mybatis, primary_skill: yss-mybatis, provider: { kind: yss-component, binding_id: framework.mybatis }, task_modes: [guidance, integration, slice-implementation, troubleshooting, review-input] }
+  - { id: quality.java-code-style, primary_skill: alibaba-java-code-style, provider: { kind: none }, task_modes: [guidance, slice-implementation, review-input] }
+  - { id: codegen.mapstruct, primary_skill: mapstruct, provider: { kind: none }, task_modes: [integration, slice-implementation, troubleshooting, review-input] }
+  - { id: codegen.lombok, primary_skill: lombok, provider: { kind: none }, task_modes: [integration, slice-implementation, troubleshooting, review-input] }
+  - { id: component.cache, primary_skill: yss-cache, provider: { kind: yss-component, binding_id: component.cache }, task_modes: [guidance, integration, slice-implementation, troubleshooting, component-maintenance, review-input] }
+  - { id: component.current-user-context, primary_skill: yss-userinfo, provider: { kind: yss-component, binding_id: component.current-user-context }, task_modes: [guidance, integration, slice-implementation, troubleshooting, component-maintenance, review-input] }
+  - { id: component.audit-log, primary_skill: yss-audit-log, provider: { kind: yss-component, binding_id: component.audit-log }, task_modes: [guidance, integration, slice-implementation, troubleshooting, component-maintenance, review-input] }
+  - { id: component.excel-import-export, primary_skill: yss-excel-mvc, provider: { kind: yss-component, binding_id: component.excel-import-export }, task_modes: [guidance, integration, slice-implementation, troubleshooting, component-maintenance, review-input] }
+  - { id: component.distributed-id, primary_skill: yss-distributed-id, provider: { kind: yss-component, binding_id: component.distributed-id }, task_modes: [guidance, integration, slice-implementation, troubleshooting, component-maintenance, review-input] }
+  - { id: component.security-algorithm, primary_skill: yss-security-algorithm, provider: { kind: yss-component, binding_id: component.security-algorithm, new_adoption: forbidden, failure_code: component-new-adoption-forbidden }, task_modes: [guidance, integration, slice-implementation, troubleshooting, component-maintenance, review-input] }
+  - { id: component.gateway-resilience, primary_skill: yss-resilience4j, provider: { kind: yss-component, binding_id: component.gateway-resilience }, task_modes: [guidance, integration, slice-implementation, troubleshooting, component-maintenance, review-input] }
+  - { id: scaffold.ddd, primary_skill: yss-ddd-scaffold-generator, provider: { kind: none }, task_modes: [integration, component-maintenance] }
+  - { id: scaffold.layered-mvc, primary_skill: yss-layered-mvc-scaffold-generator, provider: { kind: none }, task_modes: [integration, component-maintenance] }
+  - { id: scaffold.frontend-vue3, primary_skill: yss-frontend-scaffold-generator, provider: { kind: none }, task_modes: [integration, component-maintenance] }
+  - { id: project-init.mvc-data-analysis, primary_skill: yss-layered-mvc-scaffold-generator, provider: { kind: none }, task_modes: [component-maintenance] }
+  - { id: migration.springboot3, primary_skill: yss-up-springboot3, provider: { kind: none }, 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] }
@@ -145,7 +201,6 @@ skill_dependencies:
     - { skill: prototype-review, type: review-only }
     - { skill: yss-design-system, type: coordination-only }
   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 }
@@ -157,8 +212,6 @@ skill_dependencies:
   yss-technical-design:
     - { skill: i-have-adhd, type: context-conditional, when: lifecycle-document-output }
     - { skill: yss-tactical-design, type: coordination-only, when: domain-driven }
-    - { skill: yss-mvc-design, type: coordination-only, when: layered-mvc }
-  yss-mvc-design:
     - { skill: yss-openapi-draft-review, type: review-only, when: api-impact }
   yss-tactical-design:
     - { skill: domain-modeling, type: coordination-only }
@@ -193,7 +246,7 @@ skill_dependencies:
   yss-exception:
     - { skill: yss-dto, type: context-required }
   yss-ui-business-page-generation:
-    - { skill: component-selection-imports, type: context-conditional, when: components }
+    - { skill: yss-ui, type: context-required }
     - { 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 }
@@ -504,12 +557,6 @@ skills:
     instance_default_discoverable: true
     aliases: []
     impacts: [backend, lifecycle]
-  - id: yss-mvc-design
-    layer: specialist
-    maturity: draft
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [backend, lifecycle]
   - id: yss-tactical-design
     layer: specialist
     maturity: draft
@@ -558,12 +605,6 @@ skills:
     instance_default_discoverable: false
     aliases: []
     impacts: [frontend]
-  - 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
@@ -648,18 +689,6 @@ skills:
     instance_default_discoverable: false
     aliases: []
     impacts: [backend]
-  - id: yss-use-table-height
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: [use-table-height]
-    impacts: [frontend]
-  - id: yss-use-tree-height
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: [use-tree-height]
-    impacts: [frontend]
   - id: yss-userinfo
     layer: specialist
     maturity: supported
@@ -678,12 +707,6 @@ skills:
     instance_default_discoverable: false
     aliases: []
     impacts: [backend, api]
-  - id: component-selection-imports
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [frontend]
   - id: file-export-download
     layer: specialist
     maturity: supported
@@ -726,36 +749,12 @@ skills:
     instance_default_discoverable: false
     aliases: []
     impacts: [template-maintenance]
-  - id: page-form-module
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [frontend]
-  - id: page-list-module
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [frontend]
-  - id: page-skeleton
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [frontend]
   - id: theme-token-usage
     layer: specialist
     maturity: supported
     instance_default_discoverable: false
     aliases: []
     impacts: [frontend, prototype]
-  - id: vue3-best-practices
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [frontend]
   - id: yedit-table-usage
     layer: specialist
     maturity: supported
@@ -785,6 +784,4 @@ platform_skills:
     layer: specialist
     instance_default_discoverable: false
     aliases: [product-design:index]
-external_skills:
-  - id: yss-backend-scaffold-parent
-    source: .agents/skills/yss-ddd-scaffold-generator/references/yss-backend-scaffold-parent/SKILL.md
+external_skills: []

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

@@ -20,7 +20,7 @@
 | 原型交付物 | `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 工程基线 | `.agents/skills/yss-ddd-scaffold-generator/references/engineering-baseline.md` |  |
 | YSS DTO wire profile | `.agents/skills/yss-dto/references/openapi-wire-profile.yaml`；`scripts/verify-yss-dto-openapi-profile` |  |
 
 ## P0 追踪矩阵

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

@@ -77,7 +77,7 @@ owner: ai
 | 场景 | 推荐 skill | 是否需要 | 备注 |
 |------|-------------|----------|------|
 | 新服务骨架 | `yss-ddd-scaffold-generator` / `yss-layered-mvc-scaffold-generator` | 是 / 否 | 按批准的 architecture_family 选择 |
-| 后端基线检查 | `yss-backend-scaffold-parent` | 是 / 否 |  |
+| 后端基线检查 | `yss-ddd-scaffold-generator` 内部 `engineering-baseline` / `yss-layered-mvc-scaffold-generator` | 是 / 否 |  |
 | 领域建模 | `yss-domain` | 是 / 否 |  |
 | Application 用例编排 / 事务边界 | `yss-application` | 是 / 否 |  |
 | Repository / MyBatis | `yss-repository` / `yss-mybatis` | 是 / 否 |  |
@@ -91,7 +91,7 @@ owner: ai
 | `scaffold_status=required` 时已由 Agent 推荐并通过 `gate.backend-architecture-platform-approved` 同时确认 DDD / MVC 与精确 Spring Boot 版本，随后编译 schema v4 合同并经生命周期批准，再使用对应生成器；既有工程核验复用登记值 | 是 / 否 / 不适用 | gate、decision_id / digest、platform_configuration、contract_id / contract_version、批准引用、持久化引用和 Manifest v4 |
 | 脚手架生成结果只包含工程结构、配置和机械模板 | 是 / 否 | 禁止生成业务行为 |
 | 生成器输入、预期文件和实际 `./mvnw validate` / `./mvnw test` / `./mvnw package` 已留证 | 是 / 否 | 每条命令记录 `exit_code`、`duration_ms`、stdout/stderr 引用和执行时间；打印命令不算证据 |
-| `yss-backend-scaffold-parent` 基线校验已完成并重新进入 `yss-implementation-contract-compiler` | 是 / 否 / 不适用 |  |
+| 生成器内部工程基线校验已完成并重新进入 `yss-implementation-contract-compiler` | 是 / 否 / 不适用 |  |
 | 脚手架后所有业务代码均绑定批准 Slice Implementation Contract 和 YSS Skill Execution Result | 是 / 否 |  |
 
 ## 5. 完成标准
@@ -104,7 +104,7 @@ owner: ai
 - [ ] `baseline_id` / `baseline_version` 已登记，后续切片和审查只引用该质量基线，未重复定义。
 - [ ] 命中高风险影响时已完成 Doubt-Driven 主张、反证、证据和残余风险记录；未命中时已记录 `not-applicable` 原因。
 - [ ] 风险影响、验证证据和责任人已记录。
-- [ ] 原型确认后已按脚手架顺序完成工程基线、生成器、`yss-backend-scaffold-parent` 和 实现合同编译器 重编译；脚手架未生成业务行为。
+- [ ] 原型确认后已按脚手架顺序完成工程基线、生成器内部基线校验和 实现合同编译器 重编译；脚手架未生成业务行为。
 
 ## 6. 下一步门禁
 

package/template/docs/architecture/templates/system-overview-design-template.md

@@ -74,7 +74,7 @@ owner: ai
 |---|---|---|---|---|---|
 |  |  |  |  |  |  |
 
-检查规则和关键场景逐条承接、成功/失败测试、分层依赖及事务回滚。MVC 不填写聚合、值对象或 DDD Gateway；详细规则消费 `yss-mvc-design`。
+检查规则和关键场景逐条承接、成功/失败测试、分层依赖及事务回滚。MVC 不填写聚合、值对象或 DDD Gateway；详细规则由 `yss-technical-design` 的 `layered-mvc` 分支负责。
 
 ### 8.2 DDD Tactical Check