create-yss-spec 3.3.8 → 3.4.1

package/template/.codex/skills/yss-formily/SKILL.md

@@ -1,272 +1,35 @@
 ---
 name: yss-formily
-description: 指导在 YSS UI 业务页面中正确使用 @yss-ui/components 的 YFormily；当新增、编辑、查看、查询、联动、详情插槽、分步表单或动态 schema 需求出现时使用，并校验组件导入、提交与错误处理边界。
+description: 路由 YSS UI 业务页面中的 YFormily 场景；当查询、编辑、详情、联动、分步表单或 schema 生成需求出现时，加载最小 Formily 专项 Skill。
 ---
 
-# YFormily 表单开发 Skill
+# YFormily 场景路由
 
-## 触发条件
+本技能只负责选择最小专项 Skill，不复制 Formily API、schema、代码骨架或页面编排规则。新代码 canonical 组件名是 `YFormily`；`YssFormily` 仅作为已确认导出的历史兼容名。
 
-- 生成或修改新增、编辑、查看、弹窗表单、详情表单、查询表单。
-- 需要 JSON Schema、字段联动、动态显隐、远程字典、Slot 自定义渲染。
-- 需要 `mode=0/1/2`、详情 Descriptions、分步表单。
+## 必选路由
 
-## 不适用场景
+任何 YFormily 使用都必须加载 `formily-foundation`，以确认公开 Props、schema 层级、提交、校验和错误处理边界。
 
-- 页面只有普通列表，不涉及表单：使用 `../page-list-module/SKILL.md`。
-- 只处理表格操作列或分页：使用 `../ytable-usage/SKILL.md`。
-- 组件库内部改造 YFormily 源码：回到 yss-ui 源仓库，使用其 `categories.library` 维护流程；该类 skill 不随业务模板分发。
+## 条件路由
 
-## 文档检索
+| 场景 | 追加 Skill |
+|---|---|
+| 字段显隐、值联动、异步 effects、跨字段副作用 | `formily-linkage-effects` |
+| 新增、编辑、查看模式，详情插槽或 disabled 规则 | `formily-mode-slot-detail` |
+| 分步录入、跨步骤校验、步骤状态 | `formily-step-flow` |
+| Modal / Drawer 的打开、回填、保存、关闭和回退 | `page-form-module` |
+| 从自然语言、截图或 Figma 生成 schema | `yss-formily-schema-generator` |
 
-1. 当前会话可用 yss-ui MCP 时，先用 `get_component_docs` 查询 `YFormily` 的 Props、Events、Slots、Methods 和 Types；再按需求用 `get_demo` 获取 `formily/basic`、`formily/linkage`、`formily/modes`、`formily/effects`、`formily/steps` 等官方 Demo。
-2. MCP 查询未命中时先用 `search_docs/list_components` 校正名称；只有 MCP 不可用、调用失败或校正后仍无结果时，才读取最新 `llms-full.txt`。文档与当前项目依赖版本不一致时，用当前源码和可编译导出核验，不猜测 API。
-3. 本 Skill 已加载时不得用 `get_skill` 重复查询自身；只在所需 Formily 子 Skill 未同步到本地时使用 `get_skill` 兜底。
+一个任务可以同时加载多个专项 Skill。`page-form-module` 只在页面容器生命周期命中时加载，不作为本技能的固定依赖。
 
-## 硬约束（禁止/必须）
+## 边界
 
-- 业务生成代码统一使用 `import { YFormily, type ISchema } from '@yss-ui/components'`。
-- `YFormily` 是标准推荐名称；`YssFormily` 仅作为历史兼容别名，除非维护旧代码，不用于新代码。
-- 业务层禁止导入 `@formily/antdv` UI 组件，禁止导入不存在的 `@formily/antd-v3`。
-- 所有业务 `YFormily` schema 必须包含 `FormLayout -> FormGrid -> 字段` 基础层级，禁止直接以字段或单独 `FormGrid` 作为顶层布局。
-- `Submit` 组件必须传 `onSubmit`，否则不会触发提交校验。
-- 标准业务列表/CRUD 查询区默认让 `YFormily` 只渲染查询字段；“查询/重置”用外部 `YButton` 放在 `.xxx__search-actions`，由 hook 的 `handleSearch/handleReset` 控制分页重置和请求。
-- `AutoButtonGroup + Submit + Reset` 仅用于纯 Formily 表单提交场景，不作为业务列表查询区默认方案。
-- 查询区禁止把 `.xxx__search-content` 写成横向“表单 + 按钮”并用大 `gap`、`align-items: flex-start`、`padding-top` 硬调按钮位置；字段换行时按钮必须仍在搜索卡片右下角。
-- 横向业务表单必须显式设置 `FormLayout` 的 `labelWidth` 和 `labelAlign: 'right'`；抽屉/弹窗表单不得让 label 宽度随文本抖动。
-- `FormGrid` 必须保持响应式：默认 `minColumns: 1`，通过 `maxColumns`、`minWidth` 控制宽屏列数；禁止把 `minColumns` 写成与 `maxColumns` 相同的固定列数，除非用户明确要求固定不响应。
-- 抽屉/弹窗编辑表单默认 `labelWidth: 140`、`labelAlign: 'right'`、`FormGrid { maxColumns: 2, minColumns: 1, minWidth: 320~360 }`；备注、长文本等字段用 `gridSpan` 占满整行。
-- **数据前置同步原则（必守）**：弹窗/抽屉表单数据必须在 `openCreate`/`openEdit` 打开方法中**同步赋好 `formModel.value`**，严禁在子组件内部通过 `watch(visible) + await nextTick() + initForm()` 滞后回填数据。
-- **单一信任源**：优先使用 `v-model="formModel"` + `ref="formRef"` 调用 `formRef.value.submit()` 获取校验后数据；严禁在业务组件顶层写 `const form = createForm()` 单例并与 `v-model`、`form.setValues()`、`form.reset()` 混用导致状态死锁。
-- **禁止滥用动态 `:key`**：严禁在 `YFormily`/`YssFormily` 上使用 `:key="isEdit ? 'edit' : 'create'"` 强制 Remount，必须通过响应式数据或 `:mode` 驱动。
-- **弹窗生命周期隔离**：Modal/Drawer 必须配置 `:destroy-on-close="true"`，且内部 `YFormily` 必须带 `v-if="visible/open"` 随容器打开挂载、关闭销毁，保证数据干净无残留。
-- 下拉/选择器（`Select`, `TreeSelect`, `Radio.Group` 等）异步数据源**必须使用 `enum` 或 `x-reactions` / `field.dataSource` 注入**；**严禁将异步 options 数组直接写入 `x-component-props.options`**（会导致 Formily 首次挂载覆盖为空数组且外部响应式无法通知，产生首次打开弹窗显示“暂无数据”、关闭再打开才展示的经典 Bug）。
-- 弹窗/抽屉表单的基础字典下拉数据，优先在打开前 `await fetchOptions()` 或在页面 `onMounted` 提前拉取；在组件内部 `watch` 更新选项时，必须使用精确字段路径并在 `await nextTick()` 后调用 `form.setFieldState('fieldName', state => { state.dataSource = options })`。
-- `mode=2` 自动进入详情查看态；不要生成旧式详情开关 prop，配置描述列表用 `detail-options`。
-- 只使用源码已公开的 Props 和实例方法；当前没有 `show-button-group`、`detail-as`、`validate`、`reset`、`clearValidate` 等 YFormily API，禁止根据旧 demo 猜测。
-- 分步表单默认使用 AntDV `Steps + 多 YFormily`，不默认使用 `FormStep`。
-- Orval API 的网络错误及 `success === false` 业务错误已由 `mutator.ts` 统一 `message.error` 并 reject；提交 hook 的 `else`/`catch` 只做状态恢复或业务补偿，禁止重复 `message.error`。
-- 需要统一提示客户端校验失败时使用 `onFormSubmitValidateFailed`；禁止在 `onFormSubmitFailed` 或 `Submit.onSubmitFailed` 中调用 `message.error`，因为 API reject 也会进入这些通用失败回调。
+- 查询、列表、页面目录与弹窗编排不在本技能重复定义。
+- 不根据旧 Demo 猜测 Props、实例方法或组件名。
+- API 错误提示服从项目 mutator 与 `yss-api-integration`，不得在通用失败回调重复提示。
+- 从截图或设计稿生成 schema 时，本技能只做路由；生成结果仍须按基础、联动、模式或分步专项校验。
 
-## 标准代码骨架
+## 输出
 
-```vue
-<script setup lang="ts">
-import { YFormily, type ISchema } from '@yss-ui/components';
-
-/** 表单保存回调 Props。 */
-interface SaveFormProps {
-  onSave: (values: Record<string, any>) => Promise<void>;
-}
-
-/** 表单保存回调。 */
-const props = defineProps<SaveFormProps>();
-
-/** 校验通过后提交表单数据。 */
-const onSubmit = (values: Record<string, any>) => {
-  return props.onSave(values);
-};
-
-/** 基础业务表单 Schema。 */
-const schema: ISchema = {
-  type: 'object',
-  properties: {
-    layout: {
-      type: 'void',
-      'x-component': 'FormLayout',
-      'x-component-props': { layout: 'horizontal', labelWidth: 100, labelAlign: 'right' },
-      properties: {
-        grid: {
-          type: 'void',
-          'x-component': 'FormGrid',
-          'x-component-props': { maxColumns: 3, minColumns: 1, minWidth: 260 },
-          properties: {
-            name: {
-              type: 'string',
-              title: '名称',
-              required: true,
-              'x-decorator': 'FormItem',
-              'x-component': 'Input',
-              'x-component-props': { placeholder: '请输入' },
-            },
-            submit: {
-              type: 'void',
-              'x-component': 'Submit',
-              'x-content': '提交',
-              'x-component-props': { onSubmit: '{{ onSubmit }}' },
-            },
-          },
-        },
-      },
-    },
-  },
-};
-</script>
-
-<template>
-  <YFormily :schema="schema" :scope="{ onSubmit }" />
-</template>
-```
-
-### 表单布局基准
-
-- 普通业务表单：`FormLayout { layout: 'horizontal', labelWidth: 120, labelAlign: 'right' }`，`FormGrid { maxColumns: 3, minColumns: 1, minWidth: 260 }`。
-- 抽屉/弹窗表单：长 label 较多时用 `labelWidth: 140`，`FormGrid { maxColumns: 2, minColumns: 1, minWidth: 320 或 360 }`。
-- 查询表单：字段少时用 `labelWidth: 100~120`，`FormGrid { maxColumns: 3 或 4, minColumns: 1, minWidth: 260~360 }`；查询/重置按钮放在表单外部的右下角按钮行。
-- 不要为了复刻宽屏两列布局写 `minColumns: 2`；这会破坏组件库 demo 中默认的响应式收缩行为。
-- 备注、说明、富文本、长输入框等横跨整行字段，在字段 `x-decorator-props` 上设置 `gridSpan`，例如两列表单使用 `gridSpan: 2`。
-
-### 业务列表查询区固定模板
-
-```typescript
-import { YButton, YCard, YFormily, type ISchema } from '@yss-ui/components';
-
-/** 查询表单 Schema。 */
-const searchSchema: ISchema = {
-  type: 'object',
-  properties: {
-    layout: {
-      type: 'void',
-      'x-component': 'FormLayout',
-      'x-component-props': { layout: 'horizontal', labelWidth: 120, labelAlign: 'right' },
-      properties: {
-        grid: {
-          type: 'void',
-          'x-component': 'FormGrid',
-          'x-component-props': { maxColumns: 4, minColumns: 1, minWidth: 260, columnGap: 16, rowGap: 0 },
-          properties: {
-            keyword: {
-              type: 'string',
-              title: '关键字',
-              'x-decorator': 'FormItem',
-              'x-component': 'Input',
-              'x-component-props': { placeholder: '请输入关键字', allowClear: true },
-            },
-          },
-        },
-      },
-    },
-  },
-};
-```
-
-```vue
-<template>
-  <YCard class="demo-page__search-card" :padding="16">
-    <div class="demo-page__search-content">
-      <div class="demo-page__search-form">
-        <YFormily v-model="queryModel" :schema="searchSchema" />
-      </div>
-      <div class="demo-page__search-actions">
-        <YButton type="primary" @click="handleSearch">查询</YButton>
-        <YButton @click="handleReset">重置</YButton>
-      </div>
-    </div>
-  </YCard>
-</template>
-```
-
-```less
-.demo-page {
-  &__search-content {
-    display: flex;
-    flex-direction: column;
-    align-items: stretch;
-    gap: 16px;
-  }
-
-  &__search-form {
-    width: 100%;
-    min-width: 0;
-
-    :deep(.ant-formily-form-item) {
-      margin-bottom: 0;
-    }
-
-    :deep(.ant-formily-form-grid) {
-      width: 100%;
-    }
-  }
-
-  &__search-actions {
-    display: flex;
-    width: 100%;
-    flex: 0 0 auto;
-    align-items: center;
-    justify-content: flex-end;
-    gap: 12px;
-  }
-}
-```
-
-> 只有纯 Formily 提交表单才把按钮放回 schema 内，例如 `AutoButtonGroup -> Submit/Reset`。
-
-### 抽屉/弹窗表单模板
-
-```typescript
-/** 抽屉或弹窗内的编辑表单 Schema。 */
-const formSchema: ISchema = {
-  type: 'object',
-  properties: {
-    layout: {
-      type: 'void',
-      'x-component': 'FormLayout',
-      'x-component-props': { layout: 'horizontal', labelWidth: 140, labelAlign: 'right' },
-      properties: {
-        grid: {
-          type: 'void',
-          'x-component': 'FormGrid',
-          'x-component-props': { maxColumns: 2, minColumns: 1, minWidth: 360, columnGap: 24, rowGap: 16 },
-          properties: {
-            orgName: {
-              type: 'string',
-              title: '机构名称',
-              required: true,
-              'x-decorator': 'FormItem',
-              'x-component': 'Input',
-              'x-component-props': { placeholder: '请输入机构名称' },
-            },
-            remark: {
-              type: 'string',
-              title: '备注',
-              'x-decorator': 'FormItem',
-              'x-decorator-props': { gridSpan: 2 },
-              'x-component': 'Input.TextArea',
-              'x-component-props': { placeholder: '请输入备注', rows: 4 },
-            },
-          },
-        },
-      },
-    },
-  },
-};
-```
-
-## 关联 skill
-
-- 基础表单：`../formily-foundation/SKILL.md`
-- 联动副作用：`../formily-linkage-effects/SKILL.md`
-- 模式与详情插槽：`../formily-mode-slot-detail/SKILL.md`
-- 分步流程：`../formily-step-flow/SKILL.md`
-- 完整示例：`../formily-foundation/references/examples.md`
-
-## 交付检查清单
-
-- [ ] 使用 `YFormily`，模板名和 import 一致。
-- [ ] 只使用文档和源码已公开的 Props/实例方法，未出现 `show-button-group`、`detail-as` 等旧式或虚构 API。
-- [ ] 未生成旧式详情开关 prop。
-- [ ] 未导入业务层 `@formily/antdv` UI 组件。
-- [ ] Schema 层级完整：`FormLayout -> FormGrid -> 字段`，`Submit.onSubmit` 可触发校验。
-- [ ] 所有横向表单已设置固定 `labelWidth` 和 `labelAlign: 'right'`。
-- [ ] `FormGrid` 保持响应式，未用 `minColumns: maxColumns` 固定列数。
-- [ ] 业务列表查询区的查询/重置按钮在外部 `.xxx__search-actions`，按钮行独占下一行并右对齐；缩窄后不会贴在第一行字段旁。
-- [ ] 抽屉/弹窗表单 label 宽度统一、右对齐，窄屏可响应式换列，长字段已占满整行。
-- [ ] 复杂联动已选择表达式、`x-reactions`、`scope` 或 `effects` 中合适的一种。
-- [ ] API 失败仅由 `mutator.ts` 统一提示，hook 的 `else`/`catch` 未重复 `message.error`。
-
-## 失败兜底策略
-
-- 字段不显示时，先检查 `FormLayout -> FormGrid -> 字段` 层级。
-- 提交不触发时，先检查 `Submit.x-component-props.onSubmit` 或外部 `formRef.submit()`。
-- 查看态显示异常时，先检查 `mode=2`、`detail-options` 和 `detail-<path>` 插槽命名。
-- API 调用被 reject 时，让错误继续中断当前流程；只在 `finally` 恢复 loading，不在业务 hook 重复提示。
+返回本次命中的专项 Skill、未命中项的理由，以及需要由目标工程版本或源码确认的组件事实。

package/template/.codex/skills/yss-frontend-scaffold-generator/SKILL.md

@@ -9,19 +9,20 @@ description: Use when creating a new YSS frontend micro-application from the sta
 
 ## Template Source
 
-```text
-repo: http://192.168.167.142:8081/Data-Middleground-Develop-Area/product-code/ai-frontend/yss-design/yss-frontend-template.git
-branch: template
-```
+默认使用随 Skill 分发的 `assets/data-quality-v1/`，从 Data Quality 抽取工作区、主题与微应用模式，重建为通用空骨架。来源、差异、支持范围见 `references/data-quality-baseline.md`；`references/data-quality-v1.manifest.json` 是文件白名单与 SHA-256 依据。
+
+技术栈：Vue 3、TypeScript、Vite、Pinia、Vue Router、Qiankun、pnpm、Ant Design Vue 4、YSS UI、Orval。Ant Design v6 是视觉设计参考，不是此 Vue 工程的运行时包。默认主题继承根 `DESIGN.md` 的 Data Quality 浅色、14px 正文、32px 控件、20px Card 内距；暗色 / compact 显式开启。
+
+合同 `frontend.template` 默认填 `{ "kind": "bundled", "baseline_id": "data-quality-v1", "manifest_digest": "sha256:<当前manifest字节摘要>" }`。用 `node .agents/skills/yss-frontend-scaffold-generator/scripts/refresh_baseline.mjs` 只读核验摘要；维护主题或骨架后先审阅改动，再用 `--write` 更新派生。
 
-模板基线：Vue 3、TypeScript、Vite、Qiankun、pnpm、Ant Design Vue、`@yss-ui/components`、`@yss-ui/hooks`、Orval。
+兼容已有 `{ repository, commit }` 合同：只有明确选择外部 Git 模板时传 `--template-checkout` 并核验 origin 与精确 40 位 commit；不再默认从私网浮动分支获取模板。
 
 ## Inputs
 
 - `app_name`：应用名。
 - `microapp_name`：微应用注册名。
 - `base_route`：基础路由。
-- Project Scaffold Contract schema v4：包含用户确认的仓库 scope、目标路径、`init_git`、模板 commit、应用参数、允许写路径和验证命令。
+- Project Scaffold Contract schema v4：包含用户确认的仓库 scope、目标路径、`init_git`、模板 manifest 摘要或 Git commit、应用参数、允许写路径和验证命令。
 - OpenAPI Freeze 记录：有 API 影响时提供已批准的冻结 YAML 版本和引用；无 API 影响时提供带原因的 `not-applicable`。
 - OpenAPI JSON 派生记录：`docs/.scratch/<feature>/api/<feature>-json-export.md`，包含 YAML / JSON SHA-256、Redocly CLI 版本和 lockfile 引用。
 - 冻结 JSON 产物：`docs/.scratch/<feature>/api/<feature>.json`；这是唯一允许交给既有前端代码生成流程的上游产物。
@@ -35,18 +36,20 @@ branch: template
 
 1. 确认当前任务已经通过 Harness 入口分诊、逐项目脚手架决定已由真实用户确认，且 schema v4 合同已由生命周期批准、持久化并保持当前。
 2. 确认目标是外部实现仓库；只有用户明确选择时才输出到 Harness 仓库的 `apps/frontend/<project>/`。`apps/frontend/` 只能作为项目容器，`app/frontend/`、`app/backend/` 及其子路径禁止作为输出位置。`git-submodule` 只能在已初始化且附加分支的子仓工作树生成；空 gitlink、detached HEAD、`--force` 覆盖挂载点不得当成普通目录。
-3. 只读检查模板分支和合同锁定的 40 位 commit 是否可访问；生成时使用精确 commit，不跟随浮动分支。
-4. 使用 `scripts/generate_and_verify_scaffold.mjs` 从已核验 checkout 的批准 commit 导出模板，排除模板 `.git` 及未提交的工作树内容；目标必须不存在或为空。不得默认写入 Harness、不得 `--force`。仅合同 `init_git=true` 时初始化目标 Git。
+3. 默认核验 bundled manifest 摘要、白名单和每个文件字节；Git 兼容方式核验合同的精确 commit。生成不读取 Data Quality 本机路径或未提交业务代码。
+4. 使用 `scripts/generate_and_verify_scaffold.mjs --contract-file <合同> --output-dir <目录> --evidence-dir <证据目录>` 生成白名单骨架；Git 来源额外提供 checkout，导出批准 commit 并排除 `.git` 及未提交工作树内容；目标必须不存在或为空。不得默认写入 Harness、不得 `--force`。仅合同 `init_git=true` 时初始化目标 Git。
 5. 替换应用名、微应用名、路由、`micro-config.json`、环境变量和 README 中的模板占位。
 6. 有 API 影响时核验 OpenAPI Freeze 记录和 JSON 派生记录，将摘要一致的 JSON 原样物化到 `<frontend>/openapi/openapi.json`；`openapi_impact=not-applicable` 时必须有原因并禁止生成 API client。
 7. 保持模板既有的前端代码生成配置不变；本 Harness 只将 SHA-256 一致的 JSON 原样交给既有前端代码生成流程，不修改该配置、不在此仓库执行生成，也不设置生成 CI 门禁。目标前端项目在需要时手动运行其既有命令。
-8. 实际执行并记录 `pnpm install --frozen-lockfile`、`pnpm lint`、`pnpm type-check`、`pnpm build` 的退出码和日志；缺失脚本只能由批准的工程基线提供替代命令。任何必需命令失败都阻断。
+8. 企业 registry / 认证由目标环境用户级 npm 配置提供，禁止复制来源 `.npmrc` 或 token。实际执行并记录 `pnpm install --frozen-lockfile`、`pnpm lint:check`、`pnpm type-check`、`pnpm build`、`pnpm build:standalone` 的退出码和日志；缺失脚本只能由批准的工程基线提供替代命令。任何必需命令失败都阻断。
 9. 按 `docs/templates/implementation-repo-registry-template.md` 回写前端实现仓库登记。
 
 ## Expected Template Shape
 
 ```text
-openapi/
+DESIGN.md
+packages/src/config/theme.json
+openapi/ # 仅有冻结 API 时物化
 packages/src/api/
 packages/src/router/
 packages/src/views/
@@ -64,15 +67,16 @@ packages/package.json
 - 不推送、不创建 MR / PR，除非用户明确要求。
 - 不绕过 OpenAPI Draft / Freeze；API client 只消费与 OpenAPI JSON 派生记录 SHA-256 一致的冻结 JSON。
 - 不接受任意 URL、未冻结 YAML、后端运行时输出或手工 JSON 作为既有前端代码生成流程的输入。
-- 不修改模板既有的代码生成配置，也不把客户端生成加入 CI。
+- 目标生成时不修改既有代码生成配置，也不把客户端生成加入 CI；本模板维护允许审阅和更新标准配置。
+- 不携带 Data Quality 业务页面、默认管理员、生产接口、私网 Postman 同步、部署凭证或残缺 JSP 命令；当前支持 Qiankun 与 standalone，JSP 不在可用基线内。
 - 不得把 `apps/frontend/` 容器根登记为项目根；Harness 内每个前端项目必须有独立的 `apps/frontend/<project>/` 路径。
 - 不把模板示例页面当作业务功能交付。
-- 生成后仍需使用 `yss-ui-business-page-generation`、`yss-components`、`yss-api-integration` 等专项 skill 实现业务页面。
+- 生成后仍需使用 `yss-ui-business-page-generation`、`component-selection-imports`、`yss-api-integration` 以及实际命中的表格、树、Formily 等专项 skill 实现业务页面。
 
 ## Output
 
 - 前端工程生成位置或目标仓库信息。
-- 模板来源和 commit / branch 证据。
+- 模板 baseline / manifest 摘要，或 Git repository / commit 证据。
 - 替换参数清单。
 - install / lint / type-check / build 命令，以及目标前端项目既有的手动客户端生成命令（如有）。
 - OpenAPI Freeze 记录、OpenAPI JSON 派生记录、JSON SHA-256 和 `openapi/openapi.json` 物化证据。

package/template/.codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/.eslintrc.cjs

@@ -0,0 +1 @@
+module.exports = { root: true, env: { browser: true, node: true, es2022: true }, extends: ['eslint:recommended', 'plugin:vue/vue3-essential', 'plugin:@typescript-eslint/recommended'], parser: 'vue-eslint-parser', parserOptions: { parser: '@typescript-eslint/parser', ecmaVersion: 'latest', sourceType: 'module', extraFileExtensions: ['.vue'] }, ignorePatterns: ['packages/src/api/generated/**'], rules: { 'vue/multi-word-component-names': 'off' } };

package/template/.codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/.npmrc.example

@@ -0,0 +1,2 @@
+# 在用户级 npm 配置中配置企业 @yss-ui registry 和认证；禁止提交 token。
+registry=https://registry.npmjs.org/

package/template/.codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/DESIGN.md

@@ -0,0 +1,264 @@
+---
+version: alpha
+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"
+  primary-control: "#245bdb"
+  primary-control-hover: "#2f68eb"
+  primary-active: "#0958d9"
+  primary-bg: "#e6f4ff"
+  on-primary: "#ffffff"
+  text: "rgba(0, 0, 0, 0.88)"
+  text-secondary: "rgba(0, 0, 0, 0.65)"
+  text-tertiary: "rgba(0, 0, 0, 0.45)"
+  canvas-layout: "#f0f2f5"
+  surface: "#ffffff"
+  surface-elevated: "#ffffff"
+  surface-subtle: "#fafafa"
+  border: "#d9d9d9"
+  border-secondary: "#f0f0f0"
+  success: "#52c41a"
+  success-bg: "#f6ffed"
+  warning: "#faad14"
+  warning-bg: "#fffbe6"
+  error: "#f5222d"
+  error-bg: "#fff2f0"
+  info-bg: "#e6f4ff"
+
+typography:
+  body:
+    fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif'
+    fontSize: 14px
+    fontWeight: 400
+    lineHeight: 1.571
+  body-strong:
+    fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif'
+    fontSize: 14px
+    fontWeight: 600
+    lineHeight: 1.571
+  heading-lg:
+    fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif'
+    fontSize: 24px
+    fontWeight: 600
+    lineHeight: 1.333
+  heading-md:
+    fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif'
+    fontSize: 18px
+    fontWeight: 600
+    lineHeight: 1.333
+  caption:
+    fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif'
+    fontSize: 12px
+    fontWeight: 400
+    lineHeight: 1.571
+  button:
+    fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif'
+    fontSize: 14px
+    fontWeight: 600
+    lineHeight: 1.571
+
+rounded:
+  none: 0px
+  sm: 4px
+  md: 6px
+  lg: 8px
+  pill: 9999px
+
+spacing:
+  xxs: 4px
+  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: 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: 32px
+  button-primary-disabled:
+    backgroundColor: "{colors.border-secondary}"
+    textColor: "{colors.text-tertiary}"
+    typography: "{typography.button}"
+    rounded: "{rounded.md}"
+    padding: "{spacing.xxs} {spacing.sm}"
+    height: 32px
+  button-default:
+    backgroundColor: "{colors.surface}"
+    textColor: "{colors.text}"
+    typography: "{typography.button}"
+    rounded: "{rounded.md}"
+    padding: "{spacing.xxs} {spacing.sm}"
+    height: 32px
+  input-default:
+    backgroundColor: "{colors.surface}"
+    textColor: "{colors.text}"
+    typography: "{typography.body}"
+    rounded: "{rounded.md}"
+    padding: "{spacing.xxs} {spacing.xs}"
+    height: 32px
+  input-error:
+    backgroundColor: "{colors.surface}"
+    textColor: "{colors.text}"
+    typography: "{typography.body}"
+    rounded: "{rounded.md}"
+    padding: "{spacing.xxs} {spacing.xs}"
+    height: 32px
+  table-header:
+    backgroundColor: "{colors.surface-subtle}"
+    textColor: "{colors.text}"
+    typography: "{typography.body-strong}"
+    padding: "{spacing.xs} {spacing.sm}"
+  table-row-selected:
+    backgroundColor: "{colors.primary-bg}"
+    textColor: "{colors.text}"
+    typography: "{typography.body}"
+    padding: "{spacing.xs} {spacing.sm}"
+  modal-default:
+    backgroundColor: "{colors.surface-elevated}"
+    textColor: "{colors.text}"
+    typography: "{typography.body}"
+    rounded: "{rounded.lg}"
+    padding: "{spacing.md}"
+  button-primary-active:
+    backgroundColor: "{colors.primary-active}"
+    textColor: "{colors.on-primary}"
+    typography: "{typography.button}"
+    rounded: "{rounded.md}"
+    padding: "{spacing.xxs} {spacing.sm}"
+    height: 32px
+  page-shell:
+    backgroundColor: "{colors.canvas-layout}"
+    textColor: "{colors.text}"
+    typography: "{typography.body}"
+    padding: "{spacing.md}"
+  alert-success:
+    backgroundColor: "{colors.success-bg}"
+    textColor: "{colors.text}"
+    typography: "{typography.body}"
+    rounded: "{rounded.sm}"
+    padding: "{spacing.xs} {spacing.sm}"
+  alert-warning:
+    backgroundColor: "{colors.warning-bg}"
+    textColor: "{colors.text}"
+    typography: "{typography.body}"
+    rounded: "{rounded.sm}"
+    padding: "{spacing.xs} {spacing.sm}"
+  alert-error:
+    backgroundColor: "{colors.error-bg}"
+    textColor: "{colors.text}"
+    typography: "{typography.body}"
+    rounded: "{rounded.sm}"
+    padding: "{spacing.xs} {spacing.sm}"
+  alert-info:
+    backgroundColor: "{colors.info-bg}"
+    textColor: "{colors.text}"
+    typography: "{typography.body}"
+    rounded: "{rounded.sm}"
+    padding: "{spacing.xs} {spacing.sm}"
+  badge-processing-solid:
+    backgroundColor: "{colors.primary}"
+    textColor: "#000000"
+    typography: "{typography.caption}"
+    rounded: "{rounded.sm}"
+    padding: "{spacing.xxs} {spacing.xs}"
+  badge-success-solid:
+    backgroundColor: "{colors.success}"
+    textColor: "#000000"
+    typography: "{typography.caption}"
+    rounded: "{rounded.sm}"
+    padding: "{spacing.xxs} {spacing.xs}"
+  badge-warning-solid:
+    backgroundColor: "{colors.warning}"
+    textColor: "#000000"
+    typography: "{typography.caption}"
+    rounded: "{rounded.sm}"
+    padding: "{spacing.xxs} {spacing.xs}"
+  badge-error-solid:
+    backgroundColor: "{colors.error}"
+    textColor: "#000000"
+    typography: "{typography.caption}"
+    rounded: "{rounded.sm}"
+    padding: "{spacing.xxs} {spacing.xs}"
+  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}"
+    typography: "{typography.body}"
+    rounded: "{rounded.lg}"
+    padding: "{spacing.md}"
+
+---
+
+## Overview
+
+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 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. 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
+
+Use the system font stack, 14px body text and 400/600 weights. Use `caption` only for supporting information; do not encode business status through weight alone.
+
+## Layout
+
+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
+
+Prefer surface and border changes over decorative shadows. Use the component library elevation tokens when available. Shadow values remain an implementation detail until the upstream DESIGN.md schema provides a stable structured elevation contract.
+
+## Shapes
+
+Controls use `rounded.md` (6px); cards and overlays use `rounded.lg` (8px); compact tags may use `rounded.sm` or `rounded.pill`. A container radius must not be smaller than the radius of its child controls.
+
+## Components
+
+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 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.
+- Don’t hard-code colors, arbitrary spacing or duplicate controls that already exist in YSS UI.
+- Don’t target component-library internal DOM or generated class names; v6 internal markup is not a stable contract.
+- Don’t use a Tag as the only representation of an error, permission or approval state.

package/template/.codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/README.md

@@ -0,0 +1,13 @@
+# __APP_NAME__
+
+Data Quality v1 通用骨架：Vue 3 / Ant Design Vue 4 / YSS UI，默认浅色、14px 正文、32px 控件。`packages/` 是应用根。YSS 按需注册，新增页面再按实现合同引入表格或表单组件。骨架不含业务页面、用户权限、生产 API 地址或部署凭证。
+
+使用 Node >=22.12、pnpm 10.15、TypeScript5.9.3；在用户级 npm 配置中设置企业 @yss-ui registry 和认证，然后运行 `pnpm install --frozen-lockfile`。检查使用 `pnpm lint:check`、`pnpm type-check`、`pnpm build` 和 `pnpm build:standalone`。
+
+`pnpm dev` 独立预览；Qiankun 注册名为 `__MICROAPP_NAME__`、默认激活路由 `__BASE_ROUTE__`，门户传入 `container` / `routerBase` / `bridgeVersion: 1` / `themeConfig.mode`。资源部署路径由 `VITE_PUBLIC_BASE` 明确设置，不能从路由猜测。复制 `packages/.env.example` 到 `.env.local` 配置本地代理。
+
+主题文件 `packages/src/config/theme.json` 派生自随工程提供的 `DESIGN.md`，不得与设计源并列维护；更新设计后经 Harness 主题投影再同步。暗色/compact 可由宿主串行化 DTO 设置。弹层挂到当前容器，主题 CSS 只写该容器；卸载时移除容器和监听。宿主仍须约定 CSS 隔离，组件 reset / YSS 样式不是跨应用完全隔离的证明。
+
+有已冻结 API 时，受控生成器物化 `openapi/openapi.json`，再在本工程手动执行 `pnpm generate:api`。不自动联网拉取接口、不改写 schema、不覆盖业务 API 包装、不把生成加入 CI。`apiClient` 是认证/错误处理的接入 seam，需依实现合同配置。
+
+仅支持全新空工程，JSP 模式和既有工程升级尚不支持。空白首页只验证启动，不代表业务交付。