create-yss-spec 3.5.3 → 3.5.4

package/template/.pi/skills/yedit-table-usage/SKILL.md

@@ -39,178 +39,11 @@ description: "配置或修复 YSS UI YEditTable 的行内编辑、候选联动
 - 自适应高度使用 `useTableHeight(tableAreaRef, options)` 并绑定 `:height="tableHeight"`；直接父容器必须可计算且设置 `min-height: 0`。若表格内容会反向撑开观察容器，改用稳定 `boundaryRef`；弹层展开后高度仍不准时才调用 `nextTick(recalculateHeight)`。
 - API 失败由 `mutator.ts` 统一提示并 reject。Hook 中不写 `success === false` 分支，不在 `else/catch` 重复 `message.error`；清理状态放在 `finally`。
 
-## 标准代码骨架
-
-```typescript
-import type { YEditTableColumn, YTableActionConfig } from '@yss-ui/components';
-
-/** 扩展属性行。 */
-export interface ExtRow {
-  id?: string;
-  _rowKey: string;
-  extName?: string;
-  extValues?: string[];
-  memo?: string;
-}
-
-/** 可编辑表格列。 */
-export const EDIT_COLUMNS: YEditTableColumn[] = [
-  {
-    field: 'extName',
-    title: '扩展属性',
-    minWidth: 220,
-    component: 'form-item-select',
-    props: { placeholder: '请选择扩展属性' },
-    customRule: (value, _row, _field, all) => {
-      if (!value) return { errMsg: '扩展属性不能为空' };
-      if (all.filter(item => item.extName === value).length > 1) return { errMsg: '扩展属性不能重复' };
-      return {};
-    },
-  },
-  {
-    field: 'extValues',
-    title: '扩展值',
-    minWidth: 240,
-    component: 'form-item-select',
-    props: { multiple: true, placeholder: '请选择扩展值' },
-    customRule: value =>
-      Array.isArray(value) && value.some(item => String(item).length > 100)
-        ? { errMsg: '单个扩展值最多 100 个字符' }
-        : {},
-  },
-  {
-    field: 'memo',
-    title: '备注',
-    minWidth: 240,
-    component: 'form-item-input',
-    props: { placeholder: '请输入备注' },
-    customRule: value => (String(value ?? '').length > 200 ? { errMsg: '最多 200 个字符' } : {}),
-  },
-  { type: 'action', title: '操作', width: 100, fixed: 'right' },
-];
-
-/** 表格字典数据；实际项目可由 Hook 响应式提供。 */
-export const EDIT_OPTIONS_MAP = {
-  extName: [
-    { label: '类型', value: 'type' },
-    { label: '级别', value: 'level' },
-  ],
-  extValues: [
-    { label: '默认', value: 'default' },
-    { label: '扩展', value: 'extended' },
-  ],
-};
-
-/** 创建前端新行。 */
-export const createEmptyRow = (): ExtRow => ({
-  _rowKey: `temp-${Date.now()}-${Math.random().toString(36).slice(2)}`,
-  extValues: [],
-});
-
-/** 创建带删除确认的操作配置。 */
-export const createActionConfig = (onDelete: (row: ExtRow) => void): YTableActionConfig => ({
-  buttons: [
-    {
-      value: 'delete',
-      label: '删除',
-      type: 'link',
-      isConfirm: true,
-      confirmProps: { title: '是否确认删除此条数据？', okText: '确定', cancelText: '取消' },
-      click: ({ row }) => onDelete(row),
-    },
-  ],
-});
-```
-
-```vue
-<script setup lang="ts">
-import { computed, ref } from 'vue';
-import { YEditTable } from '@yss-ui/components';
-import { createActionConfig, createEmptyRow, EDIT_COLUMNS, EDIT_OPTIONS_MAP, type ExtRow } from './constant';
-
-/** 组件模式。0-新增，1-编辑，2-查看。 */
-interface Props {
-  mode: 0 | 1 | 2;
-}
-
-const props = defineProps<Props>();
-const rows = ref<ExtRow[]>([]);
-const tableRef = ref<InstanceType<typeof YEditTable>>();
-const readonly = computed(() => props.mode === 2);
-const columns = computed(() => (readonly.value ? EDIT_COLUMNS.filter(column => column.type !== 'action') : EDIT_COLUMNS));
-const actionConfig = createActionConfig(row => {
-  rows.value = rows.value.filter(item => item._rowKey !== row._rowKey);
-});
-
-/** 处理组件 add 事件，显式更新 v-model:data。 */
-const handleAddRow = () => {
-  rows.value = [...rows.value, createEmptyRow()];
-};
-
-/** 校验全部编辑行。 */
-const validateRows = async (): Promise<boolean> => {
-  if (!tableRef.value) return false;
-  const { valid } = await tableRef.value.validate();
-  return valid;
-};
-</script>
-
-<template>
-  <YEditTable
-    ref="tableRef"
-    v-model:data="rows"
-    :columns="columns"
-    :action-config="actionConfig"
-    :options-map="EDIT_OPTIONS_MAP"
-    :row-config="{ keyField: '_rowKey', useKey: true }"
-    :table-config="{ editConfig: { trigger: 'click', mode: 'row', autoClear: false } }"
-    :disabled="readonly"
-    :addable="!readonly"
-    add-btn-text="添加一行"
-    add-position="bottom"
-    @add="handleAddRow"
-  />
-</template>
-
-<style scoped lang="less">
-@import './style.less';
-</style>
-```
-
-## Select 值类型边界
-
-```typescript
-/** allowCreate 对应 tags 模式，字段按数组存储。 */
-interface CreatableRow {
-  tags?: string[];
-}
-
-const creatableColumn: YEditTableColumn = {
-  field: 'tags',
-  title: '标签',
-  component: 'form-item-select',
-  props: { allowCreate: true, placeholder: '请选择或输入标签' },
-};
-```
-
-## 表头筛选
-
-```typescript
-const textFilterColumn: YEditTableColumn = {
-  field: 'columnName',
-  title: '目标列名称',
-  component: 'form-item-input',
-  filterable: true,
-  filters: [{ data: '' }],
-  filterMethod: ({ option, cellValue }) =>
-    String(cellValue ?? '').toLowerCase().includes(String(option?.data ?? '').trim().toLowerCase()),
-  filterRender: { name: 'VxeInput', props: { clearable: true, placeholder: '请输入关键词' } },
-};
-```
-
-- 远程筛选监听 `@filter-change`，并设置 `filterMethod: () => true` 禁用本地二次筛选。
-- 切换数据源或新增行后，可调用 `tableRef.value?.getTableInstance()?.clearFilter()`。
-- 只在面板高度定制时使用 `#<field>-filter`；修改 `option.data` 后调用 `updateFilterOptionStatus(option, !!option.data)` 同步状态。
+## 按需示例
+
+首次组织可编辑明细行、查看态或提交校验时，读取 [完整组合示例](references/editable-table-example.md)。
+
+需要可创建 Select 或表头筛选时，读取 [Select 与筛选示例](references/select-and-filter-examples.md)；行级候选与表头筛选仍是不同职责。
 
 ## 交付检查清单
 

package/template/.pi/skills/yedit-table-usage/references/editable-table-example.md

@@ -0,0 +1,141 @@
+# YEditTable 组合示例
+
+仅在入口所列条件命中时读取本文件。Markdown 链接相对本文件；行内 references/assets/schemas 路径相对 Skill 根目录。示例代码属于目标工程，模块相对导入按所示文件位置解析。
+
+## 标准代码骨架
+
+```typescript
+import type { YEditTableColumn, YTableActionConfig } from '@yss-ui/components';
+
+/** 扩展属性行。 */
+export interface ExtRow {
+  id?: string;
+  _rowKey: string;
+  extName?: string;
+  extValues?: string[];
+  memo?: string;
+}
+
+/** 可编辑表格列。 */
+export const EDIT_COLUMNS: YEditTableColumn[] = [
+  {
+    field: 'extName',
+    title: '扩展属性',
+    minWidth: 220,
+    component: 'form-item-select',
+    props: { placeholder: '请选择扩展属性' },
+    customRule: (value, _row, _field, all) => {
+      if (!value) return { errMsg: '扩展属性不能为空' };
+      if (all.filter(item => item.extName === value).length > 1) return { errMsg: '扩展属性不能重复' };
+      return {};
+    },
+  },
+  {
+    field: 'extValues',
+    title: '扩展值',
+    minWidth: 240,
+    component: 'form-item-select',
+    props: { multiple: true, placeholder: '请选择扩展值' },
+    customRule: value =>
+      Array.isArray(value) && value.some(item => String(item).length > 100)
+        ? { errMsg: '单个扩展值最多 100 个字符' }
+        : {},
+  },
+  {
+    field: 'memo',
+    title: '备注',
+    minWidth: 240,
+    component: 'form-item-input',
+    props: { placeholder: '请输入备注' },
+    customRule: value => (String(value ?? '').length > 200 ? { errMsg: '最多 200 个字符' } : {}),
+  },
+  { type: 'action', title: '操作', width: 100, fixed: 'right' },
+];
+
+/** 表格字典数据；实际项目可由 Hook 响应式提供。 */
+export const EDIT_OPTIONS_MAP = {
+  extName: [
+    { label: '类型', value: 'type' },
+    { label: '级别', value: 'level' },
+  ],
+  extValues: [
+    { label: '默认', value: 'default' },
+    { label: '扩展', value: 'extended' },
+  ],
+};
+
+/** 创建前端新行。 */
+export const createEmptyRow = (): ExtRow => ({
+  _rowKey: `temp-${Date.now()}-${Math.random().toString(36).slice(2)}`,
+  extValues: [],
+});
+
+/** 创建带删除确认的操作配置。 */
+export const createActionConfig = (onDelete: (row: ExtRow) => void): YTableActionConfig => ({
+  buttons: [
+    {
+      value: 'delete',
+      label: '删除',
+      type: 'link',
+      isConfirm: true,
+      confirmProps: { title: '是否确认删除此条数据？', okText: '确定', cancelText: '取消' },
+      click: ({ row }) => onDelete(row),
+    },
+  ],
+});
+```
+
+```vue
+<script setup lang="ts">
+import { computed, ref } from 'vue';
+import { YEditTable } from '@yss-ui/components';
+import { createActionConfig, createEmptyRow, EDIT_COLUMNS, EDIT_OPTIONS_MAP, type ExtRow } from './constant';
+
+/** 组件模式。0-新增，1-编辑，2-查看。 */
+interface Props {
+  mode: 0 | 1 | 2;
+}
+
+const props = defineProps<Props>();
+const rows = ref<ExtRow[]>([]);
+const tableRef = ref<InstanceType<typeof YEditTable>>();
+const readonly = computed(() => props.mode === 2);
+const columns = computed(() => (readonly.value ? EDIT_COLUMNS.filter(column => column.type !== 'action') : EDIT_COLUMNS));
+const actionConfig = createActionConfig(row => {
+  rows.value = rows.value.filter(item => item._rowKey !== row._rowKey);
+});
+
+/** 处理组件 add 事件，显式更新 v-model:data。 */
+const handleAddRow = () => {
+  rows.value = [...rows.value, createEmptyRow()];
+};
+
+/** 校验全部编辑行。 */
+const validateRows = async (): Promise<boolean> => {
+  if (!tableRef.value) return false;
+  const { valid } = await tableRef.value.validate();
+  return valid;
+};
+</script>
+
+<template>
+  <YEditTable
+    ref="tableRef"
+    v-model:data="rows"
+    :columns="columns"
+    :action-config="actionConfig"
+    :options-map="EDIT_OPTIONS_MAP"
+    :row-config="{ keyField: '_rowKey', useKey: true }"
+    :table-config="{ editConfig: { trigger: 'click', mode: 'row', autoClear: false } }"
+    :disabled="readonly"
+    :addable="!readonly"
+    add-btn-text="添加一行"
+    add-position="bottom"
+    @add="handleAddRow"
+  />
+</template>
+
+<style scoped lang="less">
+@import './style.less';
+</style>
+```

package/template/.pi/skills/yedit-table-usage/references/select-and-filter-examples.md

@@ -0,0 +1,38 @@
+# YEditTable Select 与筛选示例
+
+仅在入口所列条件命中时读取本文件。Markdown 链接相对本文件；行内 references/assets/schemas 路径相对 Skill 根目录。示例代码属于目标工程，模块相对导入按所示文件位置解析。
+
+## Select 值类型边界
+
+```typescript
+/** allowCreate 对应 tags 模式，字段按数组存储。 */
+interface CreatableRow {
+  tags?: string[];
+}
+
+const creatableColumn: YEditTableColumn = {
+  field: 'tags',
+  title: '标签',
+  component: 'form-item-select',
+  props: { allowCreate: true, placeholder: '请选择或输入标签' },
+};
+```
+
+## 表头筛选
+
+```typescript
+const textFilterColumn: YEditTableColumn = {
+  field: 'columnName',
+  title: '目标列名称',
+  component: 'form-item-input',
+  filterable: true,
+  filters: [{ data: '' }],
+  filterMethod: ({ option, cellValue }) =>
+    String(cellValue ?? '').toLowerCase().includes(String(option?.data ?? '').trim().toLowerCase()),
+  filterRender: { name: 'VxeInput', props: { clearable: true, placeholder: '请输入关键词' } },
+};
+```
+
+- 远程筛选监听 `@filter-change`，并设置 `filterMethod: () => true` 禁用本地二次筛选。
+- 切换数据源或新增行后，可调用 `tableRef.value?.getTableInstance()?.clearFilter()`。
+- 只在面板高度定制时使用 `#<field>-filter`；修改 `option.data` 后调用 `updateFilterOptionStatus(option, !!option.data)` 同步状态。

package/template/.pi/skills/yss-ddd-scaffold-generator/SKILL.md

@@ -23,27 +23,11 @@ description: 用于生成完整的 YSS DDD 多模块后端脚手架。当用户
 
 ## Spring Boot / Java 平台选择
 
-调用本技能前由生命周期编排器展示 `scripts/backend-platforms` 的精确版本清单及兼容状态，并通过 `gate.backend-architecture-platform-approved` 把架构、Spring Boot、Java 和 YSS 父 POM/BOM 合并展示、取得真实用户确认；生成器不提问、不猜版本、不使用 `x` 或 `latest`。已有批准且当前的选择展示摘要后复用；既有工程核验并复用登记值，不触发该门禁。
-
-- 精确候选版本与可选状态只读取 `scripts/backend-platforms` 和共享平台清单，不在此复制版本表；候选不等于可生成。
-- 独立子项目可继承主项目组合或覆盖，必须逐项目确认（允许一次确认明确列出的项目）；同一 Maven Reactor 使用一个平台。
-- 只开放共享兼容清单中已有真实 YSS 构建、依赖和启动证据的组合。缺少兼容父 POM、BOM、starter 或相应能力证据即 `blocked`；不替换官方组件、不降级回退。
-- 新生成合同必须有 `platform_configuration` v2，与架构决策、Maven 坐标及兼容条目摘要一致。Boot、Java、YSS 坐标或依赖配方变化时回生命周期重新确认并编译合同；仅追加同配置验证记录不重复确认，仍核验证据有效性。
-- Spring MVC、Servlet、Validation、Jackson 和 starter 坐标消费共享平台清单；Java 下限和允许组合由当前平台条目决定。Jakarta 转换不包括 `javax.sql` 等 Java SE API。
-- 平台候选维护验证产物标记 `platform_verification=candidate`，不能交给业务生成、升级完成等级或进入首切片验证。测试夹具不证明 YSS 兼容。
-
-版本清单、合同字段、候选验证和支持晋级规则见 仓库共享合同 `.template-spec/engineering/backend-platforms.md`。
+核验新工程平台时读取 [平台选择与证据](references/platform-selection.md)。只消费生命周期经 `gate.backend-architecture-platform-approved` 取得的真实用户确认和当前 `platform_configuration` v2；以 `scripts/backend-platforms` 的已验证可选组合为准。生成器不提问、不默认、不降级；缺证据即 `blocked`。
 
 ## 优先流程
 
-1. 确认服务级 `scaffold_request_id`、已通过 `gate.backend-architecture-platform-approved` 的 `domain-driven` 架构与精确 Spring Boot 版本选择及 digest、项目名、基础包名、Maven 项目坐标、父 POM GAV、YSS Components BOM 版本、输出目录和批准 Profile。Java `base_package` 与 Maven `group_id` 是两个独立输入，不得相互推导；脚手架发生在 Ticket 正式化前，不使用 `slice_id` 伪造切片身份。
-   Harness 内输出目录必须是 `apps/backend/` 容器，生成器再以 `project_name` 创建 `apps/backend/<project>/`；禁止使用 `app/backend/`、`app/frontend/` 或把 `apps/backend/` 之外的容器根当作后端项目根。
-2. 优先运行 `node scripts/generate_and_verify_scaffold.mjs`，在同一个受控工作流中生成骨架并执行真实 Maven 验证。`generate_scaffold.mjs` 只是底层生成原语，单独返回 0 不代表脚手架完成。
-3. 检查生成的模块名、POM、机械启动入口、基础配置文件和包路径。
-4. 受控工作流必须在生成项目根目录实际执行 `./mvnw validate`、`./mvnw test` 和 `./mvnw package`；三条命令全部返回 0 后才能报告完成。
-5. 三条 Wrapper 命令通过只得到 `empty-scaffold-verified`。如需声称已满足下游技能的首切片就绪条件，必须使用 `node scripts/run_first_slice_verification.mjs` 校验批准且版本当前的 Slice Implementation Contract、完整分层产物、当前合同 freshness 与根 Wrapper；只有验证器成功更新 Manifest 后才得到 `first-slice-verified`。
-
-受控验证命令由本 skill 的 `node scripts/run_scaffold_verification.mjs` 固定执行；验证器先检查 `.yss/scaffold-generation.json` 的合同元数据和 Wrapper、Java、项目级 Maven settings/profile、仓库凭据是否就绪，再在指定 evidence 目录写入每条命令的 stdout/stderr、`exit_code`、`failure_category`、耗时、执行时间和 `scaffold-verification.json`。仓库或凭据失败归为 `repository-access`，与 `project-model`、`compilation`、`bootstrap-entrypoint`、`test-failure`、`packaging` 分开；任何一条命令失败或未执行都必须阻断。
+合同与输出范围通过后，运行生成器前读取 [受控生成与验证](references/generation-workflow.md)。入口为 `scripts/generate_and_verify_scaffold.mjs`；根 `./mvnw validate/test/package` 必须真实执行并全部成功，仅获得 `empty-scaffold-verified`。首切片等级另由 `run_first_slice_verification.mjs` 核验。
 
 ## 推荐命令
 
@@ -60,6 +44,8 @@ description: 用于生成完整的 YSS DDD 多模块后端脚手架。当用户
 - `*-bootstrap` 下可被 Spring Boot Maven Plugin 发现的机械 `*Application` 启动入口
 - 基础配置、机械模板、构建脚本
 
+生成前预检与生成后内容验收须读取 [工程内容检查](references/engineering-checks.md)，并消费既有 [工程基线](references/engineering-baseline.md)。凭据仅从安全环境注入，日志须脱敏。
+
 ## 使用约束
 
 - 先在生命周期批准的脚手架受控生成合同下生成骨架，再做业务化定制；不要直接把脚手架当最终代码交付。
@@ -67,10 +53,7 @@ description: 用于生成完整的 YSS DDD 多模块后端脚手架。当用户
 - 若目标工程已经存在，直接返回 `unsupported`。旧项目继续按原工程维护；需要现代化时单独立项、先评估再逐切片迁移，不属于本 skill。
 - 输出目录必须显式指定；目标工程目录必须不存在，`--force` 永久拒绝。
 - Harness 内多项目布局必须使用 `apps/backend/<project>/`；`apps/backend/` 只能是生成器的父容器，`app/backend/`、`app/frontend/` 及其子路径一律拒绝。`git-submodule` gitlink、空挂载点、detached HEAD 工作树不得覆盖生成，即使传入 `--force` 也不得当成普通目录，且不得走「请显式传入 `--force`」普通目录覆盖 / rename 路径。`--output-dir` 指向 detached HEAD 子仓时不得 mkdir、staging 或生成工程。先 `git submodule update --init` 并在子仓附加分支工作树内生成。维护生成器时按 [守卫顺序](references/generator-maintenance.md) 检查，不能将 gitlink 当普通目录。
-- 不要在 skill 里硬编码用户业务字段或真实连接信息。
-- 生成后要检查依赖关系是否仍符合分层约束。
 - 生成时的工程基线由本 skill 的 `references/engineering-baseline.md` 持有并绑定摘要；它不是独立 Skill。生成后必须回到 实现合同编译器，并按批准切片加载 `yss-domain`、`yss-application`、`yss-repository`、`yss-mybatis`、`yss-web-controller`、`yss-dto`、`yss-exception`、`yss-validation`、`mapstruct`、`lombok`、`alibaba-java-code-style` 等实际命中的行为 skill。
-- 验证数据库固定 H2，生产数据库 `not-bound`；后续存储接入按批准的切片合同执行。
 - 生成后的后端工程必须使用项目根目录 `./mvnw ...` 执行构建、测试、运行和 CI 验证；不得在 README、实施记录、Ticket、Review 或 Release 中默认写裸 `mvn ...`。既有仓库确实无法使用 wrapper 时，必须记录受控例外。
 - 原型确认后，`scaffold_status=required` 才能进入本 skill；本 skill 的生成边界是工程结构、POM、配置、Wrapper 和机械模板，不是业务实现。
 - 脚手架合同必须携带 `contract_id`、`contract_version`、实现合同编译器 draft 引用、生命周期批准引用、持久化引用、当前版本、允许写路径、预期证据文件和验证命令；字段缺失或版本过期时阻断。
@@ -82,10 +65,6 @@ description: 用于生成完整的 YSS DDD 多模块后端脚手架。当用户
 - 严禁把领域规则、状态机、权限、事务、复杂查询、错误映射、业务字段或用户可见行为塞进脚手架生成步骤。`./mvnw validate`、输出目录存在或“生成成功”都不等于生命周期批准、架构放行或 `ready-for-agent`。
 - 生命周期脚手架生成必须关闭 `--with-example`，不得把 User CRUD 或业务字段当作样板。生成器严格 `initialize-only`：非空目标、`--force`、旧项目迁移和当前模板升级一律 `unsupported`。未来若支持同一 Target Profile 内的模板升级，必须另行设计和批准，当前不预留可执行承诺。
 - 脚手架完成后，所有后续生成的后端代码必须回到 `yss-implementation-contract-compiler`，消费批准且版本当前的 Slice Implementation Contract 和对应 YSS skill；业务行为使用 `behavior-tdd`，机械生成才使用 `controlled-generation`。
-- `.mvn/settings.xml` 只能通过 `${env.MAVEN_REPO_USERNAME}` 和 `${env.MAVEN_REPO_PASSWORD}` 读取 Maven 仓库凭据；内部仓库构建前由 CI 或本地安全环境注入变量，禁止把 Maven 仓库用户名、明文密码或 Maven 加密密码写入 skill、模板或生成工程。
-- `.mvn/maven.config` 必须显式加载项目级 `.mvn/settings.xml` 并激活 `yss-internal`；仓库 URL 来自 `YSS_MAVEN_REPOSITORY_URL`，凭据来自 `MAVEN_REPO_USERNAME` / `MAVEN_REPO_PASSWORD`。预检缺失时先于 Maven 执行阻断，日志必须脱敏。
-- Domain POM 不得依赖 YSS DTO/Exception、Web Validation、Swagger 或 Jackson；DTO/Exception/OpenAPI 注解属于 Web。MapStruct 统一 `componentModel="spring"`，父 POM 负责 processor 与 `lombok-mapstruct-binding`。
-- 生成工程必须携带 ArchUnit、Maven Enforcer 和 Wrapper checksum；DEBUG 与 MyBatis stdout SQL 只能进入 `application-local.yml`。
 - 涉及 API 契约时，先确认 `docs/.scratch/<feature>/api/<feature>.yaml` 中的 OpenAPI Draft / Freeze 状态；不要用脚手架生成结果反向替代产品契约设计。
 
 ## 按需读取

package/template/.pi/skills/yss-ddd-scaffold-generator/references/engineering-checks.md

@@ -0,0 +1,11 @@
+# DDD 生成工程检查
+
+生成后验收工程内容时读取；Maven 执行前先检查凭据、settings 与脱敏要求。
+
+- 不要在 skill 里硬编码用户业务字段或真实连接信息。
+- 生成后要检查依赖关系是否仍符合分层约束。
+- 验证数据库固定 H2，生产数据库 `not-bound`；后续存储接入按批准的切片合同执行。
+- `.mvn/settings.xml` 只能通过 `${env.MAVEN_REPO_USERNAME}` 和 `${env.MAVEN_REPO_PASSWORD}` 读取 Maven 仓库凭据；内部仓库构建前由 CI 或本地安全环境注入变量，禁止把 Maven 仓库用户名、明文密码或 Maven 加密密码写入 skill、模板或生成工程。
+- `.mvn/maven.config` 必须显式加载项目级 `.mvn/settings.xml` 并激活 `yss-internal`；仓库 URL 来自 `YSS_MAVEN_REPOSITORY_URL`，凭据来自 `MAVEN_REPO_USERNAME` / `MAVEN_REPO_PASSWORD`。预检缺失时先于 Maven 执行阻断，日志必须脱敏。
+- Domain POM 不得依赖 YSS DTO/Exception、Web Validation、Swagger 或 Jackson；DTO/Exception/OpenAPI 注解属于 Web。MapStruct 统一 `componentModel="spring"`，父 POM 负责 processor 与 `lombok-mapstruct-binding`。
+- 生成工程必须携带 ArchUnit、Maven Enforcer 和 Wrapper checksum；DEBUG 与 MyBatis stdout SQL 只能进入 `application-local.yml`。

package/template/.pi/skills/yss-ddd-scaffold-generator/references/generation-workflow.md

@@ -0,0 +1,14 @@
+# DDD 受控生成与验证
+
+仅在入口所列条件命中时读取本文件。Markdown 链接相对本文件；行内 references/assets/schemas 路径相对 Skill 根目录。Skill 自带的 bin/scripts 命令从 Skill 根目录执行；明确注明 repository root 的包装命令仍从项目根目录执行。
+
+## 优先流程
+
+1. 确认服务级 `scaffold_request_id`、已通过 `gate.backend-architecture-platform-approved` 的 `domain-driven` 架构与精确 Spring Boot 版本选择及 digest、项目名、基础包名、Maven 项目坐标、父 POM GAV、YSS Components BOM 版本、输出目录和批准 Profile。Java `base_package` 与 Maven `group_id` 是两个独立输入，不得相互推导；脚手架发生在 Ticket 正式化前，不使用 `slice_id` 伪造切片身份。
+   Harness 内输出目录必须是 `apps/backend/` 容器，生成器再以 `project_name` 创建 `apps/backend/<project>/`；禁止使用 `app/backend/`、`app/frontend/` 或把 `apps/backend/` 之外的容器根当作后端项目根。
+2. 优先运行 `node scripts/generate_and_verify_scaffold.mjs`，在同一个受控工作流中生成骨架并执行真实 Maven 验证。`generate_scaffold.mjs` 只是底层生成原语，单独返回 0 不代表脚手架完成。
+3. 检查生成的模块名、POM、机械启动入口、基础配置文件和包路径。
+4. 受控工作流必须在生成项目根目录实际执行 `./mvnw validate`、`./mvnw test` 和 `./mvnw package`；三条命令全部返回 0 后才能报告完成。
+5. 三条 Wrapper 命令通过只得到 `empty-scaffold-verified`。如需声称已满足下游技能的首切片就绪条件，必须使用 `node scripts/run_first_slice_verification.mjs` 校验批准且版本当前的 Slice Implementation Contract、完整分层产物、当前合同 freshness 与根 Wrapper；只有验证器成功更新 Manifest 后才得到 `first-slice-verified`。
+
+受控验证命令由本 skill 的 `node scripts/run_scaffold_verification.mjs` 固定执行；验证器先检查 `.yss/scaffold-generation.json` 的合同元数据和 Wrapper、Java、项目级 Maven settings/profile、仓库凭据是否就绪，再在指定 evidence 目录写入每条命令的 stdout/stderr、`exit_code`、`failure_category`、耗时、执行时间和 `scaffold-verification.json`。仓库或凭据失败归为 `repository-access`，与 `project-model`、`compilation`、`bootstrap-entrypoint`、`test-failure`、`packaging` 分开；任何一条命令失败或未执行都必须阻断。

package/template/.pi/skills/yss-ddd-scaffold-generator/references/platform-selection.md

@@ -0,0 +1,16 @@
+# DDD 脚手架平台选择
+
+仅在入口所列条件命中时读取本文件。Markdown 链接相对本文件；行内 references/assets/schemas 路径相对 Skill 根目录。Skill 自带的 bin/scripts 命令从 Skill 根目录执行；明确注明 repository root 的包装命令仍从项目根目录执行。
+
+## Spring Boot / Java 平台选择
+
+调用本技能前由生命周期编排器展示 `scripts/backend-platforms` 的精确版本清单及兼容状态，并通过 `gate.backend-architecture-platform-approved` 把架构、Spring Boot、Java 和 YSS 父 POM/BOM 合并展示、取得真实用户确认；生成器不提问、不猜版本、不使用 `x` 或 `latest`。已有批准且当前的选择展示摘要后复用；既有工程核验并复用登记值，不触发该门禁。
+
+- 精确候选版本与可选状态只读取 `scripts/backend-platforms` 和共享平台清单，不在此复制版本表；候选不等于可生成。
+- 独立子项目可继承主项目组合或覆盖，必须逐项目确认（允许一次确认明确列出的项目）；同一 Maven Reactor 使用一个平台。
+- 只开放共享兼容清单中已有真实 YSS 构建、依赖和启动证据的组合。缺少兼容父 POM、BOM、starter 或相应能力证据即 `blocked`；不替换官方组件、不降级回退。
+- 新生成合同必须有 `platform_configuration` v2，与架构决策、Maven 坐标及兼容条目摘要一致。Boot、Java、YSS 坐标或依赖配方变化时回生命周期重新确认并编译合同；仅追加同配置验证记录不重复确认，仍核验证据有效性。
+- Spring MVC、Servlet、Validation、Jackson 和 starter 坐标消费共享平台清单；Java 下限和允许组合由当前平台条目决定。Jakarta 转换不包括 `javax.sql` 等 Java SE API。
+- 平台候选维护验证产物标记 `platform_verification=candidate`，不能交给业务生成、升级完成等级或进入首切片验证。测试夹具不证明 YSS 兼容。
+
+版本清单、合同字段、候选验证和支持晋级规则见 仓库共享合同 `.template-spec/engineering/backend-platforms.md`。

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

@@ -29,12 +29,20 @@ description: 建立或核验 YSS 设计系统、主题 Token 与页面视觉一
 5. 若是前端实现阶段，配合 `yss-ui`、`yss-ui-business-page-generation`、`yss-formily` 及实际命中的组件专项，但本技能负责风格与体验一致性门禁。
 6. 若发现视觉 Token 或组件变体不足，先更新根 `DESIGN.md` 并重新生成投影；只有治理、流程或验收说明不足时才更新 `.template-spec/design/design.md`。
 
+新建高保真原型默认选择根规范已有的紧凑组件变体，按需读取 [原型默认主题](references/prototype-default-theme.md)；此选择不改变生产主题默认值或既有批准页面。
+
+需要构建或评审企业后台页面层级、密度、表单反馈时，按需读取 [企业后台设计方法与示例](references/enterprise-craft.md)。示例演示同 Token 下的结构改进，不新增视觉规范或产品需求。
+
+需要调整页面分组、字段反馈、详情侧栏或紧凑工具栏时，读取 [页面组合与主题适配](references/page-composition.md)。
+
+新企业原型的模块、侧栏、页签和分栏使用根规范 workspace 角色；工作区充分利用宽度，窄屏导航改用 Sheet。缓存、草稿与场景重置由原型技能 `references/enterprise-workspace.md` 承担，不由主题定义业务状态。
+
 ## 核心基线
 
 - UI 定位：中后台、数据密集、表单密集、流程密集、可扫描、低装饰。
 - 颜色：使用 `DESIGN.md` 的 `colors.*`；品牌 seed 与高对比主控件变体是不同角色，不得用 seed 绕过 `components.button-primary*`。
 - 排版：使用 `DESIGN.md` 的 `typography.*`，状态不能只靠字重表达。
-- 密度：使用 `DESIGN.md` 的组件高度与 `spacing.*`；默认采用 Data Quality 浅色、32px 控件；仅显式紧凑模式应用一次 compact algorithm，不手工二次压缩。
+- 密度：使用 `DESIGN.md` 的组件高度与 `spacing.*`；生产默认采用 Data Quality 浅色和根规范普通控件；新高保真原型选择命名紧凑变体，窄屏采用普通控件。生产 compact algorithm 仅显式选择时应用一次。
 - 圆角：使用 `rounded.*`，控件、容器和 pill 角色不得用页面级 magic number 替代。
 - 运行时换肤：短名 CSS 变量必须指向 `--brand-*`，不要再维护第二套色值。
 - 表面层级：页面背景、内容容器、浮层三层模型。
@@ -52,7 +60,7 @@ description: 建立或核验 YSS 设计系统、主题 Token 与页面视觉一
 - 不硬编码表面色、边框色、状态色；优先使用 token 或主题变量。
 - 交互原型中的每个可点击主动作都必须给出 interaction feedback：状态变化、禁用原因、成功或失败反馈至少覆盖其一。
 - accessibility：品牌 Seed 保持 `colors.primary`；实际文字/背景组合不满足 WCAG 2.2 AA 时，优先使用 `components.*` 中的高对比变体或 `ConfigProvider` component token 调整，并验证 default/hover/active/disabled/focus、键盘焦点、200% zoom、reduced motion 与目标尺寸，不新增页面级特例色。
-- 离线原型直接消费所选主题的派生值；默认使用 default 快照，显式紧凑模式才使用 compact 快照，避免重复 compact。生产组件库的主题算法由其实现合同约束；暗色启用前必须核验当前派生 Token 与浏览器截图。
+- 离线原型直接消费所选主题的派生值；原型主题从 variables.css 的根规范命名变体选择密度，正文仍遵循 typography.body；生产算法快照按已选模式使用，避免重复 compact。生产组件库的主题算法由其实现合同约束；暗色启用前必须核验当前派生 Token 与浏览器截图。
 - 原型使用语义 HTML、项目主题变量与当前行为合同；生产实现不得依赖组件库内部 DOM、生成类名或未记录 API。
 - 不用 Tag 表达关键错误、阻断或审批状态；关键状态必须有可读文本和语义反馈。
 - 不让按钮、标签、表头、弹窗、卡片中的文字溢出或遮挡。
@@ -73,7 +81,7 @@ description: 建立或核验 YSS 设计系统、主题 Token 与页面视觉一
 
 - 是否通过 `ConfigProvider`、CSS variables 或项目 token 消费主题。
 - 是否将颜色、圆角、阴影和状态样式绑定到 semantic token，而不是复制表面色和交互色。
-- 是否使用当前 `DESIGN.md` 和所选主题派生快照中的控件、排版与间距值；默认使用 default，仅显式紧凑模式使用 compact，且没有重复 compact。
+- 是否使用当前 `DESIGN.md` 和所选主题派生快照中的控件、排版与间距值；原型已登记 compact/comfortable 密度，生产按当前合同选择算法快照，且没有重复 compact。
 - 是否使用 YSS UI / Ant Design 的语义组件，而不是自造同类组件。
 - 是否保留 hover、focus、active、disabled、loading、error、empty 状态。
 - 是否为可提交、导出、保存、发布、审批等操作提供明确的 interaction feedback 与不可逆操作确认。
@@ -94,6 +102,8 @@ description: 建立或核验 YSS 设计系统、主题 Token 与页面视觉一
 | 原型渲染适配 | `yss-prototype-stage/references/product-design-adapter.md`；H1/H2 统一 HTML 交付、分别验证视觉与可操作流程；不得调用 `yss-ui` |
 | API 契约 / 接入 | `yss-openapi-governance` / `yss-api-integration` |
 
+搜索选择、日期范围、320 CSS px 重排或读屏风险检查时，按需读取 [搜索日期主题与无障碍](references/search-date-theme.md)，并入现有六轴 QA。
+
 ## 更新设计系统
 
 当用户要求“引入设计系统”“形成项目规范”“更新设计系统 skill”时：

package/template/.pi/skills/yss-design-system/assets/enterprise-craft/app.js

@@ -0,0 +1,53 @@
+(() => {
+  const $ = id => document.getElementById(id);
+  let rows, scenario, retried, trigger;
+  for (const item of window.prototypeScenarios) $('scenario').add(new Option(item.label, item.id));
+  const descriptions = {
+    list: '观察查询与业务操作的分区、表头/数据的层级、长名称与空值。',
+    form: '观察字段分组、辅助说明、错误位置与提交区域；两侧失败都保留输入。',
+    approval: '观察待处理项、阻断原因和恢复动作能否关联；不以颜色代替状态文本。'
+  };
+  function element(tag, text) { const el = document.createElement(tag); el.textContent = text; return el; }
+  function feedback(text, kind = 'info') { $('feedback').textContent = text; $('feedback').dataset.kind = kind; }
+  function perform() {
+    if (scenario.outcome === 'no-permission') { feedback('无操作权限：可以查看资料，请联系负责人。', 'error'); return; }
+    if (scenario.outcome === 'failure' && !retried) { feedback('保存失败，当前输入已保留。请重试。', 'error'); $('retry').hidden = false; return; }
+    if (scenario.outcome === 'conflict' && !retried) { feedback('版本冲突：本地输入已保留。重新加载前可复制内容。', 'error'); $('reload').hidden = false; return; }
+    feedback('操作成功（本地模拟）。', 'success'); $('retry').hidden = true; $('reload').hidden = true; $('submit').focus();
+  }
+  function render(reloaded = false) {
+    const params = new URLSearchParams(location.hash.slice(1));
+    const pair = params.get('pair') || 'list'; const variant = params.get('variant') || 'after';
+    scenario = window.prototypeScenarios.find(s => s.id === (params.get('scenario') || 'primary'));
+    if (!descriptions[pair] || !['before','after'].includes(variant) || !scenario) { $('app').textContent = '示例链接无效：请检查示例、对照和场景。'; return; }
+    $('pair').value = pair; $('variant').value = variant; $('scenario').value = scenario.id;
+    $('explanation').textContent = descriptions[pair]; rows = (reloaded === true ? window.craftServerData : window.craftData).map(row => ({ ...row })); retried = reloaded === true;
+    $('app').className = variant;
+    $('app').innerHTML = `<section class="surface"><div class="page-heading"><div><h1>${pair === 'list' ? '资料工作台' : pair === 'form' ? '资料信息' : '待核对资料'}</h1><p class="secondary">核对资料名称、负责人和当前状态。所有操作均为本地模拟。</p></div><div class="actions"><button id="submit" class="primary">${pair === 'list' ? '保存当前清单' : pair === 'form' ? '保存资料' : '确认核对'}</button></div></div><div id="global-feedback"></div><div id="content"></div><div id="local-feedback"></div><div class="actions"><button id="retry" hidden>重试</button><button id="reload" hidden>重新加载</button></div></section>`;
+    const notice = element('p', ''); notice.id = 'feedback'; notice.className = 'feedback'; notice.setAttribute('role','status');
+    $(variant === 'before' ? 'global-feedback' : 'local-feedback').append(notice);
+    if (pair === 'list') {
+      $('content').innerHTML = '<form id="query" class="query"><label>名称或编号<input id="keyword" placeholder="输入资料名称或编号"></label><button>查询</button><button type="button" id="clear">重置查询</button></form><p id="count" class="secondary"></p><div class="table-scroll"><table><thead><tr><th>编号</th><th>资料名称</th><th>负责人</th><th>状态</th><th>操作</th></tr></thead><tbody id="rows"></tbody></table></div><dialog id="detail"><h2>资料详情</h2><dl id="detail-data"></dl><button id="close">关闭详情</button></dialog>';
+      const showRows = () => {
+        const visible = rows.filter(r => (r.id + r.name).includes($('keyword').value.trim())); $('rows').replaceChildren(); $('count').textContent = `共 ${visible.length} 条资料`;
+        for (const row of visible) { const tr = document.createElement('tr'); for (const key of ['id','name','owner','status']) tr.append(element('td', row[key] || '未填写')); const cell = document.createElement('td'); const button = element('button','查看'); button.setAttribute('aria-label',`查看 ${row.id}`); button.onclick = () => { trigger = button; $('detail-data').replaceChildren(); for (const [key,label] of [['id','编号'],['name','名称'],['owner','负责人'],['note','说明'],['version','版本']]) $('detail-data').append(element('dt',label),element('dd',row[key] || '未填写')); $('detail').showModal(); $('close').focus(); }; cell.append(button); tr.append(cell); $('rows').append(tr); }
+      };
+      $('query').onsubmit = e => { e.preventDefault(); showRows(); }; $('clear').onclick = () => { $('keyword').value = ''; showRows(); };
+      const close = () => { $('detail').close(); trigger?.focus(); }; $('close').onclick = close; $('detail').oncancel = e => { e.preventDefault(); close(); }; showRows();
+    } else if (pair === 'form') {
+      $('content').innerHTML = '<form id="editor"><section class="section"><h2>基本信息</h2><div class="fields"><div class="field"><label for="name">资料名称</label><input id="name" required aria-describedby="name-help"><p class="secondary" id="name-help">保留完整名称，便于查询与核对。</p></div><div class="field"><label for="owner">负责人</label><input id="owner" required aria-describedby="owner-help"><p class="secondary" id="owner-help">填写当前资料负责人。</p></div></div></section><section class="section"><h2>核对说明</h2><p id="note"></p><p>版本：<span id="version"></span></p></section></form>';
+      $('note').textContent = rows[0].note; $('version').textContent = rows[0].version; $('name').value = rows[0].name; $('owner').value = rows[0].owner; $('name').readOnly = $('owner').readOnly = scenario.outcome === 'no-permission';
+      $('editor').onsubmit = e => { e.preventDefault(); perform(); };
+    } else {
+      for (const row of rows) { const article = element('article',''); article.className = 'approval-item'; const content = element('div',''); content.append(element('h2',row.name), element('p',`${row.id} · ${row.owner || '负责人未填写'} · ${row.status}`), element('p',row.note)); article.append(content, element('span','核对当前资料后提交')); $('content').append(article); }
+    }
+    $('submit').disabled = scenario.outcome === 'no-permission';
+    if (scenario.outcome === 'no-permission') feedback('无操作权限：可以查看资料，请联系负责人。', 'error');
+    $('submit').onclick = () => pair === 'form' ? $('editor').requestSubmit() : perform();
+    $('retry').onclick = () => { retried = true; pair === 'form' ? $('editor').requestSubmit() : perform(); };
+    $('reload').onclick = () => { if (!confirm('重新加载将放弃本地修改，是否继续？')) return; render(true); $('reload').hidden = true; feedback('已重新加载，可继续核对和提交。'); $('submit').focus(); };
+    document.body.dataset.scenario = scenario.id;
+  }
+  for (const name of ['pair','variant','scenario']) $(name).onchange = () => { location.hash = new URLSearchParams({ pair: $('pair').value, variant: $('variant').value, scenario: $('scenario').value }).toString(); };
+  $('reset').onclick = render; window.addEventListener('hashchange', render); render();
+})();

package/template/.pi/skills/yss-design-system/assets/enterprise-craft/index.html

@@ -0,0 +1,2 @@
+<!doctype html><html lang="zh-CN"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>企业后台层级示例</title><link rel="stylesheet" href="../../../../../.template-spec/design/tokens/variables.css"><link rel="stylesheet" href="styles.css"></head>
+<body><aside class="review" aria-label="示例评审区"><strong>同 Token 设计对照</strong><p>虚构资料与固定场景，仅供方法教学；两侧业务内容和交互相同。</p><div class="controls"><label>示例 <select id="pair"><option value="list">查询列表</option><option value="form">表单详情</option><option value="approval">审批异常</option></select></label><label>对照 <select id="variant"><option value="before">调整前</option><option value="after" selected>调整后</option></select></label><label>场景 <select id="scenario"></select></label><button id="reset">重置</button></div><p id="explanation"></p></aside><main id="app"></main><script src="scenarios.js"></script><script src="app.js"></script></body></html>

package/template/.pi/skills/yss-design-system/assets/enterprise-craft/scenarios.js

@@ -0,0 +1,14 @@
+window.prototypeScenarios = [
+  { id: 'primary', label: '正常操作', outcome: 'success' },
+  { id: 'failure', label: '失败后重试', outcome: 'failure' },
+  { id: 'no-permission', label: '无操作权限', outcome: 'no-permission' },
+  { id: 'conflict', label: '版本冲突', outcome: 'conflict' }
+];
+window.craftData = [
+  { id: 'M-001', name: '季度经营分析资料', owner: '张明', version: 1, status: '待核对', note: '用于本季度经营分析，需核对归属部门。' },
+  { id: 'M-002', name: '跨部门业务协作与异常处理说明（长名称示例）', owner: '李华', version: 1, status: '待核对', note: '包含跨部门协作信息，请核对完整名称与负责人。' },
+  { id: 'M-003', name: '归档清单', owner: '', version: 1, status: '已更新', note: '负责人尚未填写。' }
+];
+
+// Complete simulated server snapshots for the maintenance-only conflict exercise.
+window.craftServerData = window.craftData.map((row, index) => ({...row, version: 2, ...(index === 0 ? {name: '服务端最新资料名称', owner: '最新负责人', note: '服务端已核对归属部门。'} : {})}));