create-yss-spec 3.3.8 → 3.4.1

package/template/.pi/skills/yss-skill-source-index-refresh/scripts/refresh-yss-skill-index.mjs

@@ -31,7 +31,6 @@ const BACKEND = {
 
 const FRONTEND = {
   "yss-ui": ["components", "hooks", "skills"],
-  "yss-components": ["components"],
   "yss-hook": ["hooks"],
   "yss-ui-business-page-generation": ["components", "hooks", "skills"],
   "yss-use-table-height": ["hooks"],

package/template/.pi/skills/yss-tactical-design/SKILL.md

@@ -10,7 +10,7 @@ description: 在 YSS 技术分析阶段将批准的战略领域输入细化为
 ## 适用边界
 
 - 由 `yss-technical-design` 在已确认 `domain-driven` 的技术设计分支中调用；传统 MVC 使用 `yss-mvc-design`，不得按状态或一致性影响单独推断为 DDD。
-- 输入必须是版本当前的 Spec、功能架构、战略 DDD、状态矩阵、OpenAPI Draft / Freeze、ADR 和工程约束。若输入来自 Strategic Design Handoff，必须先用 `scripts/verify-strategic-context-import` 验证 schema v3 `source_context_snapshot` / `context_delta` 已对账到目标仓根 `CONTEXT.md`，Visual Baseline Bundle 可读取且 digest 当前，并且目标侧 `context_reconciliation` 有效；未完成时不得开始战术建模。
+- 输入必须是版本当前的 Spec、功能架构、战略 DDD、状态矩阵、OpenAPI Draft / Freeze、ADR 和工程约束。若输入来自 Strategic Design Handoff，必须先用 `scripts/verify-strategic-context-import` 验证历史 v3/v4 或当前 v5 的 `source_context_snapshot` / `context_delta` 已对账到目标仓根 `CONTEXT.md`，对应的 prototype 或 existing UI baseline 可读取且摘要当前，并且目标侧 `context_reconciliation` 有效；未完成时不得开始战术建模。
 - 默认将结果写入系统概要设计 / 数据架构中的 Tactical DDD Check；聚合、状态机、一致性或持久化映射复杂到无法清楚表达时，才升级为独立战术设计文档。
 - 没有聚合、状态、不变量、一致性或领域边界影响时返回 `not-applicable` 及原因，不生成空设计。
 

package/template/.pi/skills/yss-ui/SKILL.md

@@ -32,7 +32,7 @@ pnpm why vue @yss-ui/components @yss-ui/hooks ant-design-vue vxe-table
 
 记录实际版本、lockfile、验证命令和环境阻塞。完整策略见 `references/antdv-compatibility.md`。
 
-产品设计使用的 Antdv Next 或 Ant Design v6 视觉/token 语义，不等于 Vue 生产实现 API。生产代码必须使用项目安装的 Ant Design Vue 4.x API，禁止把原型 props、events、slots、hook 或组件写法当作生产合同。`yss-antdv-next-design` 只用于默认 H2 Vue 原型，`yss-antd-design` 只用于显式 React 兼容原型；原型阶段不得调用本技能。只有进入前端实现计划、已批准切片的生产实现或实现还原验证后，才从目标 lockfile、类型、本地文档和既有用法取得真实组件事实。
+产品设计使用的 Antdv Next 或 Ant Design v6 视觉/token 语义，不等于 Vue 生产实现 API。生产代码必须使用项目安装的 Ant Design Vue 4.x API，禁止把原型 props、events、slots、hook 或组件写法当作生产合同。原型统一使用 HTML/CSS/JavaScript；原型阶段不得调用本技能。只有进入前端实现计划、已批准切片的生产实现或实现还原验证后，才从目标 lockfile、类型、本地文档和既有用法取得真实组件事实。
 
 ## 3. 组件选型门禁
 
@@ -56,7 +56,7 @@ pnpm why vue @yss-ui/components @yss-ui/hooks ant-design-vue vxe-table
 | 任务 | 必须路由 |
 |---|---|
 | 新建或改造完整业务页面 | `yss-ui-business-page-generation` |
-| 页面布局、组件和交互 | `yss-components` |
+| 页面布局与无独立 Skill 的专项组件 | `page-skeleton`、`component-selection-imports`、`references/specialized-components.md` |
 | 请求、分页、参数、树数据映射 | `yss-hook` |
 | Formily schema、联动、校验、详情态 | `yss-formily` |
 | 表格高度 | `yss-use-table-height` |
@@ -153,6 +153,7 @@ verification: pnpm type-check
 ## 10. 按需读取
 
 - 组件路由：`references/component-routing.md`
+- 无独立 Skill 的专项组件：`references/specialized-components.md`
 - 版本兼容：`references/antdv-compatibility.md`
 - 主题/locale/浮层：`references/theme-locale-overlay.md`
 - 可访问性与性能：`references/accessibility.md`

package/template/.pi/skills/yss-ui/references/component-routing.md

@@ -6,17 +6,18 @@
 |---|---|---|---|---|
 | 普通按钮、权限按钮 | `YButton` | AntDV Button | required | 权限、主题和统一动作语义；不得直接导入 Button |
 | 卡片 | `YCard` | AntDV Card | required | YSS 布局与间距扩展 |
-| 数据表格 | `YTable` | VXE Table + AntDV Pagination | specialized | 使用 `yss-components`、`field/type`、字段插槽 |
-| 编辑表格 | `YEditTable` | VXE Table | specialized | 对照 edit-table docs/demo |
-| 树 | `YTree` | AntDV Tree | specialized | 搜索、Tooltip、动作和高度路由 |
+| 数据表格 | `YTable` | VXE Table + AntDV Pagination | specialized | 使用 `ytable-usage`；远程分页交给 `page-list-module`，高度交给 `yss-use-table-height` |
+| 编辑表格 | `YEditTable` | VXE Table | specialized | 使用 `yedit-table-usage`，不要把编辑与普通展示表格混为一套 API |
+| 树 | `YTree` | AntDV Tree | specialized | 使用 `ytree-usage`；高度交给 `yss-use-tree-height` |
 | Schema 表单 | `YFormily` | Formily + AntDV | specialized | `YFormily` 为 canonical；`YssFormily` 仅为历史兼容名；加载 `yss-formily` |
-| 分栏布局 | `YSplitPane` | YSS layout | required | 统一主从页面与容器高度 |
-| 文件导入 | `YFileImport` | Upload/业务适配 | required | 使用 YSS 上传结果和表单适配 |
-| 条件构建 | `YConditionBuilder` | YSS domain component | required | 使用对应 docs/demo |
-| Cron | `YCron` | YSS domain component | required | 底层 Popover 可 fallback |
-| 图表 | `YEcharts` | ECharts | required | 主题、resize、darkMode 使用 YSS API |
-| 编辑器 | `YMonaco` | Monaco | required | 按需加载和尺寸治理 |
-| Sheet | `YSheet` | Univer | required | locale 与资源包按 YSS 文档 |
+| 分栏布局 | `YSplitPane` | YSS layout | required | 页面骨架使用 `page-skeleton`；组件边界见 `specialized-components.md` |
+| 文件导入 | `YFileImport` | Upload/业务适配 | required | 两步导入边界见 `specialized-components.md` |
+| 条件构建 | `YConditionBuilder` | YSS domain component | required | 标准模型与校验边界见 `specialized-components.md` |
+| 月历 | `YMonthCalendar` | YSS domain component | required | 日期、月份、高度与事件边界见 `specialized-components.md` |
+| Cron | `YCron` | YSS domain component | required | 七段表达式边界见 `specialized-components.md` |
+| 图表 | `YssEcharts` | ECharts | required | 主题、更新和尺寸边界见 `specialized-components.md` |
+| 编辑器 | `YMonaco` / `YMonacoDiff` | Monaco | required | 按需加载和尺寸治理见 `specialized-components.md` |
+| Sheet | `YSheet` | Univer | required | Facade、释放和依赖边界见 `specialized-components.md` |
 | 输入、选择、日期 | 无独立通用 Wrapper | AntDV Input/Select/DatePicker 等 | fallback | 读取实际 AntDV 版本；服从 theme/locale/popup 规则 |
 | 浮层反馈 | 无统一 Wrapper | Modal/Drawer/Popover/Tooltip/Alert | fallback | 服从容器、焦点、销毁、z-index 规则 |
 | 服务式反馈 | 无统一 Wrapper | message/notification | fallback | 检查 App/ConfigProvider 上下文 |

package/template/.pi/skills/yss-ui/references/specialized-components.md

@@ -0,0 +1,52 @@
+# YSS 专项组件契约
+
+本文件只承载尚无独立 Skill 的组件边界。页面编排使用 `yss-ui-business-page-generation`，表格、树、Formily、请求和高度分别加载对应专项 Skill。
+
+## YSplitPane
+
+- 轻内容可使用实时拖拽；树、宽表、编辑器、图表等重内容优先 `resize-mode="deferred"` 与 `collapse-animation="transform"`。
+- 尺寸受控时使用 `v-model:left-width`，纵向使用 `v-model:top-height`；`storage-key` 只保存尺寸，不替代页面状态。
+- 折叠默认保留内容状态。只有允许丢失展开、勾选、滚动等内部状态时才启用销毁。
+
+## YConditionBuilder
+
+- 根值是 `ConditionGroup`；叶子保持字段、操作符和值的标准模型。接口 DSL 的序列化、恢复与错误兜底放入 Hook。
+- 字段切换需要动态操作符或候选值时使用组件公开的加载入口；提交前执行公开校验。
+- 默认严格校验，只有明确允许未完成草稿时才关闭；展示态使用 `disabled`，不使用已废弃的 `readonly`。
+- 组件资料见 `../assets/component-docs/condition-builder-*`，实现前仍须核对目标项目安装版本。
+
+## YMonthCalendar
+
+- `v-model` 管理选中日期，`v-model:month` 管理展示月份，不把二者当作日期范围。
+- `valid-range` 限制范围，`disabled-date` 表达业务禁用日期；业务层仍需规范化起止输入。
+- 自定义日期单元格应保留 today、selected、disabled 等状态语义。
+- `fill-height` 仅用于父容器已有明确高度的场景；键盘、右键和双击动作使用公开事件，不覆盖默认焦点行为。
+
+## YFileImport
+
+- 文件选择、预检、结果回显和最终确认组成两步流程；业务上传与校验由 `nextStep` / `finalImport` 接入。
+- 默认 `beforeUpload=false`，不能期待 `action` 自动上传；直传只通过 `upload-props.customRequest`。
+- `importResult` 展示结果，失败数据通过 `exportErrorData` 下载。弹窗配置与上传器配置保持分离。
+- 组件资料见 `../assets/component-docs/file-import-*`。
+
+## YMonaco / YMonacoDiff
+
+- 分栏折叠或 Drawer 打开等容器尺寸变化后确认已重新布局。
+- 日志增量使用 `appendContent()`，避免频繁重设超大完整字符串。
+- 编辑器必须按需加载并在页面卸载时释放相关资源。
+
+## YCron
+
+- 业务值是七段表达式：秒、分、时、天、月、周、年。
+- 页面只负责双向绑定和禁用态；时区、后端模型转换和生效校验属于 API/Hook 层。
+
+## YSheet
+
+- 必须提供明确容器高度。
+- 初始化后只通过公开 Facade API 修改工作簿，并通过公开保存入口取值；不得直接修改工作簿原始数据对象。
+- 卸载时释放实例，接入前确认 Univer、React、RxJS 等可选依赖及包体影响。
+
+## YssEcharts
+
+- option、更新策略和容器尺寸以目标版本手册与项目已验证实践为准。
+- 不在页面层重复原生 ECharts 初始化、销毁或 ResizeObserver 管理。

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

@@ -158,12 +158,13 @@ async function validateContract(contract, args) {
   if (manifestPath !== path.resolve(contract.scaffold_manifest_ref)) throw new Error("--scaffold-manifest-file does not match the approved web generation contract");
   if (!await exists(manifestPath)) throw new Error(`scaffold manifest not found: ${manifestPath}`);
   const manifest = JSON.parse(await readFile(manifestPath, "utf8"));
-  if (![2, 3].includes(manifest.schema_version)) throw new Error("scaffold manifest must use historical schema_version=2 or current schema_version=3");
-  if (mvc && manifest.schema_version !== 3) throw new Error("MVC requires schema v3 scaffold identity");
+  if (![2, 3, 4].includes(manifest.schema_version)) throw new Error("scaffold manifest must use supported schema_version=2/3/4");
+  if (manifest.schema_version === 3 && manifest.legacy_reconciliation?.status !== "approved") throw new Error("historical schema v3 scaffold requires approved legacy reconciliation before business generation");
+  if (mvc && ![3, 4].includes(manifest.schema_version)) throw new Error("MVC requires schema v3/v4 scaffold identity");
   if (manifest.architecture_identity || mvc) {
     assertArchitectureAgreement(contract.architecture_identity, { manifest });
     if (contract.architecture_identity.architecture_profile !== contract.architecture_profile) throw new Error("Web architecture profile differs from its identity");
-  } else if (manifest.schema_version === 3 && (manifest.architecture_family !== "domain-driven" || manifest.generator_skill !== "yss-ddd-scaffold-generator")) throw new Error("schema v3 scaffold manifest must bind the domain-driven generator for Web adapter generation");
+  } else if (manifest.schema_version >= 3 && (manifest.architecture_family !== "domain-driven" || manifest.generator_skill !== "yss-ddd-scaffold-generator")) throw new Error("schema v3/v4 scaffold manifest must bind the domain-driven generator for Web adapter generation");
   if (!["empty-scaffold-verified", "first-slice-verified"].includes(manifest.completion_level)) throw new Error("scaffold manifest must be empty-scaffold-verified before Web generation");
   const scaffoldRoot = path.dirname(path.dirname(manifestPath));
   if (implementationRoot !== scaffoldRoot) throw new Error("implementation_project_root does not match the scaffold manifest project root");

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

@@ -20,7 +20,7 @@ for (const [profile, module, placement, modules, generator] of [
   const identity = { architecture_family: "layered-mvc", architecture_profile: profile, generator_skill: generator, requested_capabilities: [], resolved_modules: modules, contract_digest: "a".repeat(64), verification_database: "h2", production_database: "not-bound" };
   const project = path.join(data.root, "demo-service");
   const manifestFile = path.join(project, ".yss/scaffold-generation.json");
-  const manifest = { schema_version: 3, project_name: "demo-service", base_package: "com.yss.demo", completion_level: "empty-scaffold-verified", architecture_identity: identity, profiles: { platform: "spring-boot-2.7-jdk8", validation_namespace: "javax" } };
+  const manifest = { schema_version: 4, project_name: "demo-service", base_package: "com.yss.demo", completion_level: "empty-scaffold-verified", architecture_identity: identity, profiles: { platform: "spring-boot-2.7-jdk8", validation_namespace: "javax" } };
   await mkdir(path.dirname(manifestFile), { recursive: true });
   await writeFile(manifestFile, JSON.stringify(manifest));
   const contract = webContract(project, { architecture_profile: profile, architecture_identity: identity, dto_placement: placement, integration_mode: "scaffold-v2", scaffold_manifest_ref: manifestFile, platform_profile: "spring-boot-2.7-jdk8", validation_namespace: "javax", application_service_package: `com.yss.demo.${module}.service` });

package/template/CONTEXT.md

@@ -46,6 +46,7 @@ context_schema_version: 1
 | `ready-for-agent` | 表示垂直切片已通过必要门禁并具备直接实现条件的流程状态。 | — | 不得用于 Spec 初稿、原型、OpenAPI Draft 或其他未冻结资产。 |
 | OpenAPI Draft | review-only 的 OpenAPI 3.1 契约草案。 | — | Freeze 前不得作为前后端稳定实现契约。 |
 | OpenAPI Freeze | 已通过评审、可作为前后端实现和契约测试输入的 OpenAPI 3.1 契约。 | — | Freeze 后变更必须回到 API 影响分析和设计审查。 |
+| API Contract Decision | 以原始字节摘要记录 API 影响结论；有影响时闭包绑定 OpenAPI Draft、Validation、独立 Review 与 Freeze，无影响时绑定评估、原因和证据。 | — | 与 Technical Design、Data Architecture Decision 一起由 `gate.engineering-contract-approved` 原子批准；不得用空 OpenAPI 或字符串自证代替。 |
 | YSS 响应包装 | 对外 API 使用 `Result` 基础字段及 `SingleResult`、`MultiResult`、`PageResult` 表达单对象、非分页列表和分页查询结果的统一返回结构。 | — | Java 泛型记法是语义简称；公开 schema 必须落成具体 endpoint wire shape。 |
 | DTO wire shape | DTO 在 HTTP/JSON 边界实际暴露的字段、类型、可空性和方向性；与 Java 字段、getter 或内部协作字段区分。 | — | 以目标 mapper / contract evidence 为准，不从 getter、Lombok 或 `@JsonIgnore` 机械推断。 |
 | UI 影响 | 会改变用户可见页面、导航、交互流程、状态呈现或权限体验的功能影响。 | — | 纯后端、API、批处理或数据变更不自动构成 UI 影响。 |

package/template/DESIGN.md

@@ -1,7 +1,7 @@
 ---
 version: alpha
-name: YSS Enterprise Design System
-description: A machine-readable compact visual contract for YSS enterprise applications, aligned with Ant Design v6 semantic tokens and the experimental Antdv Next provider. It complements the product lifecycle and does not define product behavior, API contracts, permissions, or business states.
+name: YSS Data Quality Design System
+description: A machine-readable Data Quality default visual contract for YSS enterprise applications, aligned with YSS enterprise visual semantics and framework-independent HTML prototypes. It complements the product lifecycle and does not define product behavior, API contracts, permissions, or business states.
 
 colors:
   primary: "#3371ff"
@@ -17,6 +17,7 @@ colors:
   surface: "#ffffff"
   surface-elevated: "#ffffff"
   surface-subtle: "#fafafa"
+  border: "#d9d9d9"
   border-secondary: "#f0f0f0"
   success: "#52c41a"
   success-bg: "#f6ffed"
@@ -70,53 +71,57 @@ spacing:
   xs: 8px
   sm: 12px
   md: 16px
+  card: 20px
   lg: 24px
   xl: 32px
   xxl: 48px
 
 components:
+  separator:
+    backgroundColor: "{colors.border}"
+    height: 1px
   button-primary:
     backgroundColor: "{colors.primary-control}"
     textColor: "{colors.on-primary}"
     typography: "{typography.button}"
     rounded: "{rounded.md}"
     padding: "{spacing.xxs} {spacing.sm}"
-    height: 28px
+    height: 32px
   button-primary-hover:
     backgroundColor: "{colors.primary-control-hover}"
     textColor: "{colors.on-primary}"
     typography: "{typography.button}"
     rounded: "{rounded.md}"
     padding: "{spacing.xxs} {spacing.sm}"
-    height: 28px
+    height: 32px
   button-primary-disabled:
     backgroundColor: "{colors.border-secondary}"
     textColor: "{colors.text-tertiary}"
     typography: "{typography.button}"
     rounded: "{rounded.md}"
     padding: "{spacing.xxs} {spacing.sm}"
-    height: 28px
+    height: 32px
   button-default:
     backgroundColor: "{colors.surface}"
     textColor: "{colors.text}"
     typography: "{typography.button}"
     rounded: "{rounded.md}"
     padding: "{spacing.xxs} {spacing.sm}"
-    height: 28px
+    height: 32px
   input-default:
     backgroundColor: "{colors.surface}"
     textColor: "{colors.text}"
     typography: "{typography.body}"
     rounded: "{rounded.md}"
     padding: "{spacing.xxs} {spacing.xs}"
-    height: 28px
+    height: 32px
   input-error:
     backgroundColor: "{colors.surface}"
     textColor: "{colors.text}"
     typography: "{typography.body}"
     rounded: "{rounded.md}"
     padding: "{spacing.xxs} {spacing.xs}"
-    height: 28px
+    height: 32px
   table-header:
     backgroundColor: "{colors.surface-subtle}"
     textColor: "{colors.text}"
@@ -139,7 +144,7 @@ components:
     typography: "{typography.button}"
     rounded: "{rounded.md}"
     padding: "{spacing.xxs} {spacing.sm}"
-    height: 28px
+    height: 32px
   page-shell:
     backgroundColor: "{colors.canvas-layout}"
     textColor: "{colors.text}"
@@ -196,6 +201,18 @@ components:
   secondary-copy:
     textColor: "{colors.text-secondary}"
     typography: "{typography.caption}"
+  card-default:
+    backgroundColor: "{colors.surface}"
+    textColor: "{colors.text}"
+    typography: "{typography.body}"
+    rounded: "{rounded.lg}"
+    padding: "{spacing.card}"
+  button-compact:
+    height: 28px
+  button-small:
+    height: 24px
+  button-large:
+    height: 40px
   card-compact:
     backgroundColor: "{colors.surface}"
     textColor: "{colors.text}"
@@ -209,11 +226,11 @@ components:
 
 YSS is an enterprise UI system for dense, scannable work surfaces: tables, forms, filters, workflows and operational feedback. This file is the normative source for visual tokens and component visual variants. Product behavior remains in Spec, interaction specifications and state matrices.
 
-The visual baseline is Ant Design v6 semantic tokens mapped to YSS UI. Production applications use Vue 3 + YSS UI / Ant Design Vue 4.x; high-fidelity React prototypes use Ant Design 6.x, while experimental Vue prototypes may use the draft Antdv Next provider against an exact-version fact pack. These tracks share visual intent, not framework APIs.
+The default theme adopts Data Quality global tokens on the Ant Design v6 design foundation: light mode, primary #3371ff, body 14px, controls 32/24/40px, radii 6/4/8px and card padding 20px. Compact and dark modes are opt-in. Data Quality runs Vue 3 + Ant Design Vue 4.2.6 + YSS UI; that runtime version is distinct from the design foundation. Client-specific JSP themes and page-local glass effects are not defaults. Prototypes use HTML/CSS/JavaScript with local token CSS. Production applications use the target implementation contract and lockfile; prototype visuals do not establish production component API compatibility.
 
 ## Colors
 
-Use semantic roles (`primary`, `text`, `surface`, `border`, `success`, `warning`, `error`) instead of literal values in product pages. Keep a single primary action per decision area. State colors must be paired with readable text or an icon and must meet WCAG 2.2 AA.
+Use semantic roles (`primary`, `text`, `surface`, `border`, `success`, `warning`, `error`) instead of literal values in product pages. Keep a single primary action per decision area. The brand seed remains Data Quality #3371ff; primary-control #245bdb and its hover variant are deliberate YSS accessibility adaptations for white small text, not values copied from Data Quality. State colors must be paired with readable text or an icon and must meet WCAG 2.2 AA.
 
 ## Typography
 
@@ -221,7 +238,7 @@ Use the system font stack, 14px body text and 400/600 weights. Use `caption` onl
 
 ## Layout
 
-Use a 4px spacing grid and the spacing tokens above. Keep the Ant Design seed `controlHeight` at 32px, then apply the compact algorithm once; the default prototype and dense-work-surface result is 28px. Never seed 28px and apply compact again. Page, container and overlay surfaces form the base three-layer model. On narrow screens, toolbars and filters reflow or collapse; table overflow is restricted to the table container.
+Use a 4px spacing grid and the spacing tokens above. Use the default 32px control variant directly in HTML prototypes. The explicit compact variant uses 28px; small and large controls use 24px and 40px. When production uses an Ant Design theme algorithm, keep its seed `controlHeight` at 32px and apply compact once; never seed 28px and compact again. Page, container and overlay surfaces form the base three-layer model. On narrow screens, toolbars and filters reflow or collapse; table overflow is restricted to the table container.
 
 ## Elevation & Depth
 
@@ -233,12 +250,12 @@ Controls use `rounded.md` (6px); cards and overlays use `rounded.lg` (8px); comp
 
 ## Components
 
-The component keys above describe compact visual variants, not business states. Controls use a 28px computed height, 14px body type, pale semantic feedback surfaces and visible focus rings. Required implementation states include hover, focus, active, disabled, loading, error, empty, readonly, no-permission, conflict and success. Define those behavior and acceptance details in the lifecycle state-matrix and prototype evidence assets.
+The component keys above describe default visual variants and explicitly named optional sizes, not business states. Default controls use a 32px computed height, 14px body type, pale semantic feedback surfaces and visible focus rings. Required implementation states include hover, focus, active, disabled, loading, error, empty, readonly, no-permission, conflict and success. Define those behavior and acceptance details in the lifecycle state-matrix and prototype evidence assets.
 
 ## Do's and Don'ts
 
 - Do consume tokens through ConfigProvider, CSS variables or the target component library theme.
-- Do compose `compactAlgorithm` with `darkAlgorithm` for dark compact work surfaces.
+- Do use the verified derived dark/compact token snapshot for HTML; production theme algorithms remain implementation-specific.
 - Do verify desktop (`1440x900`), mobile (`390x844`) and impacted intermediate viewports.
 - Do provide visible feedback for save, submit, publish, export and retry actions.
 - Don’t use marketing hero layouts, large gradients or decorative cards in operational pages.

package/template/__yss_dotfile__.gitignore

@@ -20,6 +20,10 @@ dist/
 .env
 .env.*
 !.env.example
+# Public scaffold mode files (no credentials)
+!**/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/.env.development
+!**/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/.env.production
+!**/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/.env.production.standalone
 *.pem
 
 # Database

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

@@ -88,10 +88,10 @@ roles:
     title: YSS 产品经理
     stages: [ stage.plan, stage.spec-architecture, stage.product-design, stage.verification-release-retrospective ]
     draft_artifact_ids: [ artifact.product-overview, artifact.functional-architecture, artifact.interaction-spec, artifact.state-matrix, artifact.prototype-confirmation ]
-    core_skills: [ yss-design-system, yss-prototype-stage, prototype-review, yss-antdv-next-design, yss-research, competitive-intelligence ]
+    core_skills: [ yss-design-system, yss-prototype-stage, prototype-review, yss-research, competitive-intelligence ]
     forbidden_skills: [ yss-ui, yss-domain, yss-repository, yss-web-controller, yss-ddd-scaffold-generator, yss-layered-mvc-scaffold-generator, implement, tdd ]
     description: >-
-      Own priority, product-design impact, interaction, state matrix, prototype confirmation recommendation, and the commercial constraints, delivery commitments, release window, and commercial non-goals for Plan and release. May reject Spec scope. Do not write production code or freeze OpenAPI alone. Do not independently approve external commercial contracts or formal commitments; those require biological-human approval. Frontend implementation uses the frontend-engineer role and yss-ui, not yss-antdv-next-design. Explicit React/AntD compatibility prototypes use yss-antd-design conditionally.
+      Own priority, product-design impact, interaction, state matrix, prototype confirmation recommendation, and the commercial constraints, delivery commitments, release window, and commercial non-goals for Plan and release. May reject Spec scope. Do not write production code or freeze OpenAPI alone. Do not independently approve external commercial contracts or formal commitments; those require biological-human approval. Frontend implementation uses the frontend-engineer role and yss-ui. Prototypes use offline HTML/CSS/JavaScript and project DESIGN.md; production component facts remain downstream.
 
   - id: role.project-manager
     name: 项目经理
@@ -112,7 +112,7 @@ roles:
     title: YSS 前端工程师
     stages: [ stage.product-design, stage.system-data-engineering, stage.ticket-formalization, stage.vertical-slice-implementation, stage.verification-release-retrospective ]
     draft_artifact_ids: [ artifact.frontend-implementation-plan ]
-    core_skills: [ yss-ui, yss-ui-business-page-generation, yss-components, yss-formily, formily-foundation, formily-linkage-effects, formily-mode-slot-detail, formily-step-flow, ytable-usage, ytree-usage, yedit-table-usage, yss-api-integration, yss-hook, theme-token-usage, page-skeleton, page-list-module, page-form-module, component-selection-imports, vue3-best-practices, tdd ]
+    core_skills: [ yss-ui, yss-ui-business-page-generation, yss-formily, ytable-usage, ytree-usage, yedit-table-usage, yss-api-integration, yss-hook, theme-token-usage, page-skeleton, page-list-module, page-form-module, component-selection-imports, vue3-best-practices, tdd ]
     forbidden_skills: [ yss-domain, yss-application, yss-repository, yss-mybatis, yss-web-controller, yss-ddd-scaffold-generator, yss-layered-mvc-scaffold-generator, java-backend-commit ]
     description: >-
       Own Vue page modules, frontend tests, and frontend_implementation_plan. Review OpenAPI Draft for client fit and prototype feasibility. Write only contract-allowed frontend paths. Verify with pnpm. Do not freeze API, own backend domain, or countersign your own merge.
@@ -125,7 +125,7 @@ roles:
     stages: [ stage.system-data-engineering, stage.ticket-formalization, stage.vertical-slice-implementation, stage.verification-release-retrospective ]
     draft_artifact_ids: [ artifact.openapi-draft, artifact.data-architecture, artifact.technical-design ]
     core_skills: [ yss-implementation-contract-compiler, yss-technical-design, yss-tactical-design, yss-mvc-design, yss-domain, yss-application, yss-repository, yss-mybatis, yss-web-controller, yss-dto, mapstruct, lombok, alibaba-java-code-style, yss-exception, yss-validation, tdd, yss-ddd-scaffold-generator, yss-layered-mvc-scaffold-generator ]
-    forbidden_skills: [ yss-ui, yss-ui-business-page-generation, yss-formily, yss-frontend-scaffold-generator, yss-antd-design, yss-antdv-next-design, page-list-module, page-form-module ]
+    forbidden_skills: [ yss-ui, yss-ui-business-page-generation, yss-formily, yss-frontend-scaffold-generator, page-list-module, page-form-module ]
     description: >-
       Own OpenAPI Draft, data-architecture contributions, and backend tests. Write only contract-allowed backend paths. Verify with ./mvnw. Do not Freeze OpenAPI, treat UI copy as requirements, or countersign your own implementation.
 

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

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

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

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

package/template/docs/design/README.md

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

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

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