create-yss-spec 3.3.1 → 3.3.3

package/template/.qoder/skills/yss-ui/references/checklist.md

@@ -1,110 +0,0 @@
-# yss-ui Checklist
-
-## 使用方式
-
-- 开发阶段：按页面类型逐项自检。
-- 联调阶段：重点执行“数据链路与交互”清单。
-- 提交前：至少完成“通用基线”+ 当前页面类型清单。
-
----
-
-## 通用基线（所有页面必查）
-
-- [ ] 已用 `pnpm why` 确认 Vue、YSS UI、AntDV、VXE 实际版本
-- [ ] 组件选型已对照 `component-routing.md`，AntDV 回退已记录原因
-- [ ] 使用 Vue 3 Composition API + `<script setup lang="ts">`
-- [ ] 优先使用 `@yss-ui/components`，缺失能力再回退 `ant-design-vue`
-- [ ] 未引入不存在的 Y 前缀组件
-- [ ] 无 `@formily/antd*` 违规导入
-- [ ] 页面容器具备统一布局（padding/margin/min-height）
-- [ ] 状态展示与危险操作颜色保持一致
-- [ ] 关键交互具备成功/失败反馈（`message`）
-- [ ] 关键实现至少对照一个 docs demo（`../assets/demos/*`）
-- [ ] 推荐 Demo 不含 `pending-verification`
-
-## 主题、Locale 与浮层
-
-- [ ] 页面通过项目 ConfigProvider/YSS theme/语义 token 消费主题
-- [ ] 未新增页面级主题色和任意 z-index
-- [ ] locale、时区、日期和金额格式化沿用项目统一能力
-- [ ] Popup/Teleport 目标适配宿主和微应用容器
-- [ ] Modal/Drawer 关闭时清理状态并恢复触发元素焦点
-
-## 可访问性、响应式与性能
-
-- [ ] 图标按钮有可访问名称，状态不只依赖颜色
-- [ ] 表单 label、错误提示与控件建立语义关联
-- [ ] 主要操作可通过键盘完成，Tab 顺序合理
-- [ ] 窄屏布局、表格横向滚动和操作收敛已检查
-- [ ] 大数据 Table/Tree、远程搜索和复杂组件采用项目已验证的性能策略
-
----
-
-## 列表页清单（YTable）
-
-- [ ] 列定义使用 `YTableColumn`，主字段走 `field/type`
-- [ ] 启用 `:row-config="{ keyField: 'id' }"` 或业务主键
-- [ ] 需要选择行时已配置 `type: 'checkbox'`
-- [ ] 自定义单元格走字段插槽（如 `#status`、`#action`）
-- [ ] DOM 模板（JSP/HTML）下插槽命名使用 kebab-case（如 `#toolbar-left`）
-- [ ] 避免以 `bodyCell` 分支作为主渲染模式
-- [ ] 分页状态包含 `current/pageSize/total`
-- [ ] `@change` 中同步更新分页并触发刷新
-- [ ] 加载态与空态行为正确
-
----
-
-## 抽屉详情页清单
-
-- [ ] 抽屉开关状态单一来源（`ref<boolean>`）
-- [ ] 打开抽屉前正确设置当前记录
-- [ ] 抽屉关闭时清理临时输入/评论等状态
-- [ ] Tab 切换不引入脏数据
-- [ ] 抽屉内表格优先使用 YTable（列同样遵循 `field/type`）
-- [ ] 底部操作按钮具备确认机制（如 `Modal.confirm`）
-
----
-
-## 步骤页清单（Create/Step）
-
-- [ ] 步骤状态由单一 `currentStep` 管理
-- [ ] 第一步表单校验通过后再进入下一步
-- [ ] 步骤二列表推荐使用 YTable 承载节点信息
-- [ ] 节点编辑弹层（Drawer/Modal）保存后回填源数据
-- [ ] 上一步/下一步/取消/完成按钮状态与文案正确
-- [ ] 完成动作后有明确反馈并返回目标页面
-
----
-
-## 数据链路与联调清单（API + Mock）
-
-- [ ] API 请求通过项目统一实例（`mutator.ts`）发起
-- [ ] URL 未重复拼接 `/api` 前缀
-- [ ] 列表请求参数包含 `page/pageSize` 与筛选参数
-- [ ] Mock 路由与前端请求路径一致
-- [ ] Mock 返回结构为 `{ code, message, data: { list, total, page, pageSize } }`
-- [ ] 查询行为会重置页码到第一页
-- [ ] 分页行为会沿用筛选条件重新请求
-- [ ] 异常时正确提示并兜底空数据
-
----
-
-## 路由与菜单清单
-
-- [ ] 页面路由挂载在正确模块 `children` 下
-- [ ] `meta.title` 与页面语义一致
-- [ ] 详情/创建页使用 `menuType: MENU_TYPE.INNER_MENU`
-- [ ] 路由名称（name）语义清晰且唯一
-
----
-
-## 交付前核查清单
-
-- [ ] 关键文件已补充必要类型定义
-- [ ] 无调试输出（如 `console.info`）遗留
-- [ ] 运行格式化命令并确认无格式问题
-- [ ] 目标文件 IDE 诊断无新增错误
-- [ ] 若 lint/type-check 失败，已明确标注环境原因
-- [ ] 如需 AI 辅助生成代码，优先加载 `llms-full.txt` 上下文
-- [ ] 必要的组件测试、E2E、视觉回归已执行；未适用项记录原因
-- [ ] 浏览器 console 无新增 warning/error

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

@@ -1,31 +0,0 @@
-# YSS UI 组件路由表
-
-本文件是 YSS Wrapper 与 Ant Design Vue / VXE 组件选型的权威映射。`required` 表示生产页面必须优先使用 YSS；`fallback` 表示当前无独立 YSS 封装，可直接使用项目安装版本的 AntDV；`specialized` 表示必须加载专项 skill。
-
-| 场景 | YSS 组件 | 底层能力 | 策略 | 关键差异 / 路由 |
-|---|---|---|---|---|
-| 普通按钮、权限按钮 | `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、动作和高度路由 |
-| 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 文档 |
-| 输入、选择、日期 | 无独立通用 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 上下文 |
-| 布局与导航 | 按项目现状 | AntDV Layout/Grid/Menu/Tabs 等 | fallback | 不复制 React Ant Design v6 API |
-
-## 受控回退
-
-YSS `required` wrapper 缺少必要能力时，记录组件、能力缺口、依赖版本、替代方案、主题/locale/浮层影响和验证证据。没有记录不得回退。
-
-## 更新规则
-
-新增或变更 YSS Wrapper 时同步：本表、组件 docs、至少一个已验证 demo、三个索引、兼容矩阵和验证脚本。

package/template/.qoder/skills/yss-ui/references/frontend-docs.md

@@ -1,11 +0,0 @@
-# yss-ui Frontend Documentation
-
-Generated: 2026-08-17T12:03:37.436Z
-
-Use these YSS UI documentation entry points as authoritative references when local repo examples are insufficient.
-
-- components: http://192.168.164.27:3200/components
-- hooks: http://192.168.164.27:3200/hooks
-- skills: http://192.168.164.27:3200/skills
-
-When documentation and local code differ, inspect the current project code before editing and prefer established local usage.

package/template/.qoder/skills/yss-ui/references/migration-antdv-to-yss.md

@@ -1,20 +0,0 @@
-# AntDV 到 YSS Wrapper 迁移与 Demo 审计
-
-## 迁移规则
-
-1. 从 `component-routing.md` 判断目标是 required、fallback 或 specialized。
-2. required 组件改用 YSS Wrapper，并运行对应 docs/demo 验证。
-3. fallback 组件保留 AntDV 导入，记录无 Wrapper 或能力缺口。
-4. 服务式 API 记录 App/ConfigProvider 上下文。
-5. 未验证 Demo 标记 `pending-verification`，不得进入推荐索引。
-
-## 2026-08-08 基线审计
-
-基线发现 28 个 Demo 直接导入 `ant-design-vue`。
-
-- 明确迁移：直接使用 AntDV `Button` 的 Cron、Card、Table Demo 改用 `YButton`。
-- 合理 fallback：Input、Select、Checkbox、Radio、Collapse、Popover、Tooltip、Dropdown、Tag、Grid 等当前无独立通用 YSS Wrapper。
-- 服务式 fallback：`message` 保留，但实现项目必须检查应用上下文。
-- `RadioButton` / `RadioGroup` 不等同于独立 `Button`，不应被 Button 规则误判。
-
-后续新增 Demo 若直接导入 YSS 已标记 required 的底层组件，模板验证必须失败。

package/template/.qoder/skills/yss-ui/references/quick-recipes.md

@@ -1,280 +0,0 @@
-# yss-ui Quick Recipes
-
-## 使用说明
-
-- 当任务是“新建页面”时，优先选用最接近的模板再改字段与交互。
-- 当任务是“重构页面”时，按“列定义 -> 插槽 -> 请求 -> 分页 -> 路由”顺序迁移。
-- 模板默认基于 Vue 3 + TypeScript + `@yss-ui/components`。
-- 组件与 Demo 先对照 `../assets/reference-index.md` 和 `../assets/demos/*` 再编码。
-
----
-
-## 组件样例速查（docs 对照）
-
-- YTable：`../assets/demos/table/*`
-- YEditTable：`../assets/demos/edit-table/*`
-- YssFormily：`../assets/demos/formily/*`
-- YTree：`../assets/demos/tree/*`
-- SplitPane：`../assets/demos/split-pane/*`
-- YMonaco：`../assets/demos/monaco/*`
-- YEcharts：`../assets/demos/echarts/*`
-- YFileImport：`../assets/demos/file-import/*`
-- YConditionBuilder：`../assets/demos/condition-builder/*`
-- YCron：`../assets/demos/cron/*`
-- YCard：`../assets/demos/card/*`
-- YButton：`../assets/demos/button/*`
-
----
-
-## 模板 1：列表管理页（带勾选、分页、状态、操作）
-
-```ts
-import { reactive, ref } from "vue";
-import { YTable, type YTableColumn } from "@yss-ui/components";
-
-const loading = ref(false);
-const tableData = ref<any[]>([]);
-const pagination = reactive({
-  current: 1,
-  pageSize: 10,
-  total: 0,
-  showSizeChanger: true,
-  showQuickJumper: true,
-});
-
-const columns = reactive<YTableColumn[]>([
-  { type: "checkbox", width: 50, align: "center" },
-  { type: "seq", title: "序号", width: 60, align: "center" },
-  { field: "name", title: "名称", minWidth: 180 },
-  { field: "owner", title: "负责人", width: 120 },
-  { field: "updatedAt", title: "更新时间", width: 180 },
-  { field: "status", title: "状态", width: 110 },
-  { field: "action", title: "操作", width: 180, fixed: "right" as const },
-]);
-```
-
-```vue
-<YTable
-  :columns="columns"
-  :row-config="{ keyField: 'id' }"
-  :data="tableData"
-  :loading="loading"
-  :pagination="pagination"
-  :checkbox-config="{ highlight: true }"
-  @change="handlePageChange"
->
-  <template #status="{ row }">
-    <span :class="['status-dot', row.status === 'ENABLED' ? 'enabled' : 'disabled']"></span>
-    {{ row.status === "ENABLED" ? "启用" : "停用" }}
-  </template>
-  <template #action="{ row }">
-    <a @click="handleEdit(row)">编辑</a>
-    <a @click="handleDetail(row)">详情</a>
-    <a style="color: #ff4d4f" @click="handleDelete(row)">删除</a>
-  </template>
-</YTable>
-```
-
----
-
-## 模板 2：待办审批页（列表 + 详情抽屉）
-
-```ts
-import { ref, reactive } from "vue";
-import { YTable, type YTableColumn } from "@yss-ui/components";
-
-const detailVisible = ref(false);
-const activeRecord = ref<any>(null);
-
-const columns = reactive<YTableColumn[]>([
-  { type: "checkbox", width: 50, align: "center" },
-  { type: "seq", title: "序号", width: 60, align: "center" },
-  { field: "approvalName", title: "审批名称", width: 220 },
-  { field: "submitter", title: "提交人", width: 120 },
-  { field: "submittedAt", title: "提交时间", width: 180 },
-  { field: "status", title: "状态", width: 110 },
-  { field: "action", title: "操作", width: 220, fixed: "right" as const },
-]);
-```
-
-```vue
-<YTable :columns="columns" :row-config="{ keyField: 'id' }" :data="tableData">
-  <template #approvalName="{ row }">
-    <a @click="openDetail(row)">{{ row.approvalName }}</a>
-  </template>
-  <template #action="{ row }">
-    <a @click="handleApprove(row)">同意</a>
-    <a style="color: #ff4d4f" @click="handleReject(row)">拒绝</a>
-    <a @click="openDetail(row)">详情</a>
-  </template>
-</YTable>
-```
-
----
-
-## 模板 3：步骤创建页（步骤二节点表格）
-
-```ts
-import { reactive, ref } from "vue";
-import { YTable, type YTableColumn } from "@yss-ui/components";
-
-const nodeList = ref<any[]>([]);
-
-const nodeColumns = reactive<YTableColumn[]>([
-  { type: "seq", title: "序号", width: 70, align: "center" },
-  { field: "nodeName", title: "节点名称", minWidth: 160 },
-  { field: "taskType", title: "任务策略类型", width: 140 },
-  { field: "approverType", title: "审批人类型", width: 140 },
-  { field: "approvers", title: "审批人", minWidth: 220 },
-  { field: "action", title: "操作", width: 130, fixed: "right" as const },
-]);
-```
-
-```vue
-<YTable
-  :columns="nodeColumns"
-  :row-config="{ keyField: 'id' }"
-  :data="nodeList"
-  :border="true"
->
-  <template #taskType="{ row }">
-    {{ row.taskType === "AUTO" ? "自动通过审批" : "人工审批" }}
-  </template>
-  <template #approvers="{ row }">
-    {{ row.approvers.join("、") || "-" }}
-  </template>
-  <template #action="{ row }">
-    <a @click="openEditDrawer(row)">编辑</a>
-    <a style="color: #ff4d4f" @click="removeNode(row.id)">删除</a>
-  </template>
-</YTable>
-```
-
----
-
-## 模板 4：列表请求 + API 接入
-
-```ts
-const fetchData = async () => {
-  loading.value = true;
-  try {
-    const res = await getListApi({
-      page: pagination.current,
-      pageSize: pagination.pageSize,
-      keyword: query.keyword || undefined,
-      status: query.status || undefined,
-    });
-    tableData.value = res?.data?.list || [];
-    pagination.total = res?.data?.total || 0;
-  } finally {
-    loading.value = false;
-  }
-};
-
-const handleSearch = () => {
-  pagination.current = 1;
-  fetchData();
-};
-
-const handlePageChange = (page: number, size: number) => {
-  pagination.current = page;
-  pagination.pageSize = size;
-  fetchData();
-};
-```
-
-Mock 返回建议结构：
-
-```json
-{
-  "code": 200,
-  "message": "success",
-  "data": {
-    "list": [],
-    "total": 0,
-    "page": 1,
-    "pageSize": 10
-  }
-}
-```
-
----
-
-## 模板 5：树表页面（YTree + useTreeHeight + SplitPane）
-
-```ts
-import { ref } from "vue";
-import { useTreeHeight, YTREE_SEARCH_HEIGHT } from "@yss-ui/hooks";
-
-const treeWrapRef = ref<HTMLDivElement>();
-const selectedKeys = ref<(string | number)[]>([]);
-const searchValue = ref("");
-const { treeHeight } = useTreeHeight(treeWrapRef, {
-  extraOffset: YTREE_SEARCH_HEIGHT,
-});
-```
-
-```vue
-<div class="layout">
-  <YSplitPane :initial-width="300" :min-width="240" :max-width="480">
-    <template #left>
-      <div ref="treeWrapRef" class="tree-wrap">
-        <YTree
-          v-model:searchValue="searchValue"
-          v-model:selectedKeys="selectedKeys"
-          :height="treeHeight"
-          :tree-data="treeData"
-          filterable
-          @select="handleTreeSelect"
-        />
-      </div>
-    </template>
-    <template #right>
-      <YTable :columns="columns" :data="tableData" :row-config="{ keyField: 'id' }" />
-    </template>
-  </YSplitPane>
-</div>
-```
-
----
-
-## 模板 6：YssFormily 模式切换（新增/编辑/查看）
-
-```ts
-const mode = ref<0 | 1 | 2>(0);
-const formData = ref<Record<string, any>>({});
-```
-
-```vue
-<YssFormily v-model="formData" :schema="schema" :mode="mode">
-  <template #detail-owner="{ value }">
-    <a-tag color="blue">{{ value || "-" }}</a-tag>
-  </template>
-</YssFormily>
-```
-
-规则要点：
-
-- 查看态插槽固定命名：`detail-<字段路径>`，路径中的 `.` 改为 `-`
-- 输入类事件优先 `onUpdate:value`，跨字段逻辑优先 `x-reactions/effects`
-
----
-
-## 模板 7：文件导入两步流（YFileImport）
-
-```vue
-<YFileImport
-  v-model="visible"
-  :file-type-list="['xls', 'xlsx', 'csv']"
-  :import-result="importResult"
-  @nextStep="handleNextStep"
-  @finalImport="handleFinalImport"
-  @exportErrorData="handleExportErrorData"
-/>
-```
-
-要点：
-
-- 走“选择文件 -> 结果确认”两步交互
-- 失败数据通过 `exportErrorData` 下载回溯
-- 与表单联动时可复用 `formily.vue` 示例模式

package/template/.qoder/skills/yss-ui/references/theme-locale-overlay.md

@@ -1,25 +0,0 @@
-# 主题、Locale 与浮层门禁
-
-## 主题
-
-- 通过项目 `ConfigProvider`、`@yss-ui/theme`、语义 token 或项目 CSS variables 消费主题。
-- 禁止页面硬编码表面色、状态色、任意圆角、阴影和 z-index。
-- 暗色和紧凑模式由项目主题层切换，页面只消费语义角色。
-
-## Locale 与格式化
-
-- AntDV locale、时区和日期库由应用入口统一配置。
-- 页面不得混用 dayjs、moment、原生字符串拼接和不同金额格式化器。
-- 日期、金额、枚举、空值显示复用项目公共能力。
-
-## Popup / Teleport
-
-- Modal、Drawer、Dropdown、Popover、Tooltip、Select、DatePicker 使用项目统一 popup container。
-- 微应用中明确宿主根节点、Shadow DOM/Teleport 目标和卸载行为。
-- 禁止页面自行增加 z-index 解决遮挡；先修正挂载层级和项目 token。
-
-## 生命周期与焦点
-
-- 弹层关闭时清理临时表单、异步请求和订阅。
-- 根据项目版本选择正确的销毁属性，不猜测最新官网 API。
-- 打开后聚焦合理入口，关闭后恢复触发元素焦点。

package/template/.qoder/skills/yss-ui/references/verification.md

@@ -1,20 +0,0 @@
-# YSS UI 分层验证
-
-按影响面执行，未命中项记录 `not-applicable` 及原因。
-
-```text
-格式化
-→ lint
-→ type-check
-→ 组件测试
-→ 关键交互测试
-→ 响应式检查
-→ 主题、locale、popup 检查
-→ 必要的 E2E / 视觉回归
-```
-
-优先使用前端工程已有 `pnpm` scripts，不自行发明命令。Fresh verification 记录命令、退出码、环境、证据文件和未覆盖风险。
-
-最低人工检查：加载/空态/错误/权限、键盘和焦点、危险操作确认、窄屏布局、暗色/紧凑模式、浏览器 console warning。
-
-完成后返回 YSS Skill Execution Result 所需 changed files、evidence files、actual verification、deferred seams、drift/new impacts。

package/template/.qoder/skills/yss-ui-business-page-generation/SKILL.md

@@ -1,159 +0,0 @@
----
-name: yss-ui-business-page-generation
-description: 指导生成或改造 Vue3 YSS UI CRUD、列表、表单、详情、左树右表和弹窗抽屉页面，覆盖组件选型、模块拆分、Orval API、响应式高度、主题和原型验收；当用户要求生成 YSS UI 业务页或 CRUD 模块时使用。
----
-
-# YSS UI 业务页面生成 Skill
-
-## 触发条件
-
-- 用户要求生成或改造业务页面、CRUD 模块、列表页、表单页、详情页、左树右表、树表联动页面。
-- 页面涉及 `YTable`、`YTree`、`YFormily`、`YButton`、`YCard`、`YSplitPane`、`YConditionBuilder` 等 YSS UI 组件。
-- 需要让 AI 优先复用 YSS UI 组件、hooks、utils，而不是直接使用 Ant Design Vue 或重复造工具函数。
-- 用户提供旧项目路径、原型截图、目标截图或要求“照旧项目/照原型还原”。
-
-## 不适用场景
-
-- 只修改 yss-ui 组件库内部实现：回到 yss-ui 源仓库，使用其 `categories.library` 维护流程；该类 skill 不随业务模板分发。
-- 只写文档、提交信息或发版流程，不生成业务页面代码。
-- 用户明确要求不用 YSS UI 组件库。
-
-## 必读参考
-
-- 组件来源速查：`./references/component-map.md`
-- Hooks 速查：`./references/hooks-map.md`
-- Utils 速查：`./references/utils-map.md`
-- 表格细节：`../ytable-usage/SKILL.md`
-- 编辑表格细节：`../yedit-table-usage/SKILL.md`
-- 树形细节：`../ytree-usage/SKILL.md`
-- 表单细节：`../yss-formily/SKILL.md`
-- 前端还原验证：`../yss-ui/references/verification.md` 与当前 Slice 的 `frontend_implementation_plan` / `frontend_implementation_verification`
-- 主题 Token 与换肤：`../theme-token-usage/SKILL.md`
-- 文件导出下载：`../file-export-download/SKILL.md`
-- Orval 接口与错误处理：`../yss-api-integration/SKILL.md`
-
-## 文档检索顺序
-
-1. 当前会话可用 yss-ui MCP 时，生成业务代码前先调用一次 `get_codegen_rules`；不确定导出时用 `list_components`，配置组件/Hook/Utils 前用 `get_component_docs`，复杂场景用 `get_demo`，不确定归属时用 `search_docs`。
-2. MCP 查询未命中时，先用 `list_components` 或 `search_docs` 校正名称；只有 MCP 工具不可用、调用失败或校正后仍无结果时，才读取最新 `llms-full.txt`。
-3. MCP/`llms-full.txt` 与当前项目的依赖版本或导出不一致时，使用当前项目源码、CodeGraph 和可编译导出交叉核验，明确记录差异，不猜测 API。
-4. 当前 Skill 已被本地加载时不得再用 `get_skill` 查询自身；仅在所需子 Skill 未同步到本地时才用 `list_skills/get_skill` 兜底。
-
-## 硬约束（禁止/必须）
-
-- 生成页面前必须先判定组件来源：YSS UI 已封装的组件从 `@yss-ui/components` 导入。
-- 表单默认使用 `YFormily + JSON Schema`，业务代码禁止导入 `@formily/antdv` UI 组件。
-- 所有 `YFormily` 横向业务表单必须显式设置固定 `labelWidth` 与 `labelAlign: 'right'`，并使用 `FormLayout -> FormGrid -> 字段` 响应式结构；禁止用 `minColumns: maxColumns` 固定列数破坏响应式。
-- 标准列表/CRUD 查询区必须采用 `YCard -> search-content -> search-form(YFormily) + search-actions(YButton 查询/重置)` 的纵向布局；按钮行独占下一行并右对齐，缩放或窄屏字段换行后仍位于搜索卡片右下角。
-- 查询区禁止横向放“表单 + 按钮”并用大 `gap`、`align-items: flex-start`、`padding-top` 硬调按钮位置。
-- 抽屉/弹窗编辑表单默认 `labelWidth: 140`、`FormGrid { maxColumns: 2, minColumns: 1, minWidth: 320~360 }`，备注/长文本字段用 `gridSpan` 占满整行。
-- 下拉选择器（`Select`/`TreeSelect`/`Radio.Group`）异步数据源必须通过 `enum` 或 `x-reactions` / `field.dataSource` 注入，严禁写入 `x-component-props.options`（会导致首次打开弹窗显示“暂无数据”、关闭再打开才展示的经典时序 Bug）；弹窗基础下拉字典优先在打开前 `await` 或页面初始化提前拉取。
-- 表格默认使用 `YTable`；远程分页使用 `pageable + pagination.remote + @page-change`，事件参数固定读取 `{ current, pageSize }`，禁止使用 `currentPage`。
-- 编辑表格默认使用 `YEditTable`；需求出现“编辑表格/添加行/删除行/行内下拉”时禁止直接用 `a-table` 手搓。
-- 左树右表优先使用 `YSplitPane + YCard + YTree + YTable`，高度使用 `useTreeHeight/useTableHeight`。
-- 标准列表必须使用 `YTable` 真实 API：`:data`、`:columns`、`:loading`、`pageable`、`v-model:pagination`、`@page-change`；禁止臆造 `request/search-params` 等 Prop。实例 `refresh()` 只刷新当前 vxe 表格数据，远程重新查询必须调用业务 Hook。
-- 新增/导入/批量操作等主操作直接放入 `#toolbar-right` 插槽；**无需配置 `:toolbar-config="{ custom: true }"`**，避免无端展示列设置图标；**仅在业务明确需要列设置时才传入 `:toolbar-config="{ custom: true }"`**。
-- 删除确认默认使用 `YTable actionConfig.buttons[].isConfirm` 按钮项或 AntDV `Popconfirm` 气泡确认，禁止默认使用居中 `Modal.confirm`。
-- 样式抽离到 `style.less`，在 SFC 中使用 `<style scoped lang="less">@import './style.less';</style>`。
-- `index.vue` 原则上不超过 150 行；状态、API、副作用和处理方法进入 `hooks/`，列定义和静态配置进入 `constant.ts`。
-- 所有导出函数、hooks、类型和静态配置必须使用中文 JSDoc。
-- Orval 请求必须使用真实生成导出和 DTO；禁止 `if (res?.success)` 冗余包裹，也禁止在 `else`/`catch` 重复 `message.error`。
-- 页面、公共组件、内联样式、TS 渲染配置和 SVG 必须遵循 `theme-token-usage`；禁止硬编码品牌色及 hover/active/selected/focus 色阶，主色透明态必须由真实动态 Token 派生。
-- 页面包含导出、报表、模板或附件下载时必须遵循 `file-export-download`，使用 `handleBlobResponse(res.data, res.headers)`，并检查生成方法是否已包含 `responseType: 'blob'`。
-- 若用户给出旧项目路径或截图，开发前必须先提取 UI/交互验收清单；交付前逐项对照，不允许只实现字段和接口。
-
-## 标准代码骨架
-
-```text
-src/views/{module-name}/
-├── index.vue
-├── constant.ts
-├── style.less
-├── hooks/
-│   ├── use{Module}List.ts
-│   └── use{Module}Form.ts
-├── type.ts              # 独立类型较多时增加
-└── components/          # 多个私有视图时增加
-    ├── {Module}Table.vue
-    └── {Module}Modal.vue
-```
-
-## 生成流程
-
-1. 读取本 skill 的三个 reference，并按上述文档检索顺序核对真实 API 与导出，禁止根据旧示例猜测。
-2. 读取 `theme-token-usage`，检查项目真实主题变量与运行时同步链路。
-3. 若有截图或旧项目路径，先读取已批准且 digest 当前的 Visual Baseline manifest 和 `frontend_implementation_plan`，按 `case_id` 提取布局、状态、交互、响应式与控件类型验收项；缺失或摘要漂移时返回 `blocked`，不得凭目录或截图猜测。
-4. 按需求类型加载细分 skill：列表读 `page-list-module` 和 `ytable-usage`；表单读 `yss-formily`；编辑表格读 `yedit-table-usage`；树读 `ytree-usage`；导出下载读 `file-export-download`。
-5. 先设计 `constant.ts`、`style.less` 和 hooks；独立类型或私有视图确有需要时再增加 `type.ts`/`components/`，最后写 `index.vue` 组合视图。
-6. 对 API 请求使用 Orval 真实生成类型和导出，在 hooks 内封装 loading、分页映射和失败后状态；错误 Toast 由 mutator 统一处理。
-7. 交付前检查导入来源、真实组件 API、分页字段、Formily schema 层级、主题 Token、查询按钮右下角布局、表格工具栏、样式作用域、删除确认和原型对照清单。
-
-## 最小组合示例
-
-```vue
-<script setup lang="ts">
-import { ref } from 'vue';
-import { YButton, YCard, YTable } from '@yss-ui/components';
-import { useTableHeight } from '@yss-ui/hooks';
-import { TABLE_COLUMNS } from './constant';
-import { useRuleList } from './hooks/useRuleList';
-
-const emit = defineEmits<{ create: [] }>();
-const tableAreaRef = ref<HTMLDivElement>();
-const { tableHeight, isReady } = useTableHeight(tableAreaRef, { withPagination: true, withToolbar: true });
-const { loading, dataList, pagination, handlePageChange } = useRuleList();
-
-/** 打开新增表单，实际项目中由表单 Hook 实现。 */
-const openCreate = (): void => {
-  emit('create');
-};
-</script>
-
-<template>
-  <YCard class="page-card">
-    <div ref="tableAreaRef" class="table-area">
-      <YTable
-        v-if="isReady"
-        :height="tableHeight"
-        :data="dataList"
-        :columns="TABLE_COLUMNS"
-        :loading="loading"
-        pageable
-        v-model:pagination="pagination"
-        @page-change="handlePageChange"
-      >
-        <template #toolbar-right>
-          <YButton type="primary" @click="openCreate">新增</YButton>
-        </template>
-      </YTable>
-    </div>
-  </YCard>
-</template>
-
-<style scoped lang="less">
-@import './style.less';
-</style>
-```
-
-## 交付检查清单
-
-- [ ] 已优先复用 `@yss-ui/components`、`@yss-ui/hooks`、`@yss-ui/utils`。
-- [ ] `index.vue` 不超过 150 行，业务逻辑、常量、列配置和样式已按职责拆分。
-- [ ] 未出现未导出的 Y 前缀组件。
-- [ ] 未导入 `@formily/antd-v3`、`@formily/antd` 或业务层 `@formily/antdv` UI 组件。
-- [ ] `YTable` 分页字段为 `current/pageSize/total`。
-- [ ] `YTable` 未臆造 `request/search-params` Prop，也未把实例 `refresh()` 当作远程请求。
-- [ ] 主表格主操作放在 `#toolbar-right`，仅在业务需要列设置时才配置了 `toolbar-config.custom`。
-- [ ] 编辑表格场景使用 `YEditTable`，下拉可输入/多选等能力通过列 `props` 配置。
-- [ ] `YFormily` 未使用不存在的详情开关 prop，表单 label 固定宽度右对齐，`FormGrid` 保持响应式。
-- [ ] 查询区按钮在外部 `.xxx__search-actions` 右对齐独占一行，缩窄后仍处于搜索卡片右下角。
-- [ ] 主题色、状态色、中性色及交互态使用动态 Token；未依赖未同步变量的固定色 fallback。
-- [ ] 导出下载使用 `handleBlobResponse`，且 Blob 配置、响应头、loading 与错误链路已验证。
-- [ ] 已核对 Orval 真实导出，未使用 `if (res?.success)` 或重复错误 Toast。
-- [ ] 若有截图或旧项目参考，已按 `case_id` 配对基准图、实现图、diff/mask 和差异解释，并记录交互、console warning、实际 `pnpm` 命令与退出码。
-
-## 失败兜底策略
-
-- 组件来源不确定时，先用 MCP `list_components/get_component_docs/search_docs` 交叉确认；MCP 不可用时才查 `component-map.md` 和 `llms-full.txt`，仍无法确认时报告待确认项，不得将猜测的导入直接落地。
-- 页面复杂度过高时，先落地最小列表/表单闭环，再拆分私有组件和 hooks。
-- API 契约不稳定时，先在 hook 内做最小字段映射，不把兼容逻辑散落到模板。