create-yss-spec 3.4.5 → 3.4.7

package/template/.cursor/skills/yss-use-tree-height/SKILL.md

@@ -1,98 +0,0 @@
----
-name: yss-use-tree-height
-description: "用 useTreeHeight 实现 YTree 独立滚动，修复搜索区、Tab 或抽屉切换后的高度。"
----
-
-# useTreeHeight 使用
-
-## 触发条件
-
-- YTree 或左树右表需要独立滚动区和自适应高度。
-- 树区域含内置搜索，或在 Tab/抽屉/折叠面板切换后高度不正确。
-
-## 不适用场景
-
-- 树节点很少、无需独立滚动，且父级布局已托管高度。
-- 主要问题是树节点与右侧数据联动，而非布局高度。
-
-## 文档检索
-
-1. MCP 可用时，先用 `get_component_docs` 精确查询 `useTreeHeight`，需要示例时再调用 `get_demo`；不要仅凭 Skill 中的静态签名推断当前 API。
-2. 精确查询无结果时，先用 `search_docs` 校正名称；仅在 MCP 不可用、调用失败或仍无结果时，回退读取最新 `llms-full.txt`。文档版本与当前依赖不一致时，再核对 Hook 源码、CodeGraph 和真实导出。
-
-## 硬约束（禁止/必须）
-
-- 把树区域的直接父容器 `ref` 传给 `useTreeHeight(treeAreaRef, options)`，并使用真实返回值 `treeHeight/recalculateHeight`。
-- 最外层必须有可计算高度；树区域使用 `flex: 1; min-height: 0; overflow: hidden;`。
-- 计算结果绑定到 `YTree` 的 `:height="treeHeight"`，不用固定魔法高度替代 Hook，也不为了触发虚拟滚动默认添加 `:virtual="true"`。
-- 使用 YTree 内置搜索时配置 `extraOffset: YTREE_SEARCH_HEIGHT`；搜索区已放在 `treeAreaRef` 外部时不再扣除。
-- `extraOffset` 只用于树区域内部实际占位的搜索、padding 或边框，禁止无依据叠加 `+16` 等偏移。
-- Hook 仅在挂载时为当时存在的 `treeAreaRef` 建立 `ResizeObserver`。优先保持树区域外层容器挂载（如使用 `v-show`）；Tab/抽屉可见后在 `nextTick` 调用 `recalculateHeight()`。
-- 隐藏态容器可能得到 `minHeight` 而不是真实可用高度；不把该值当成最终布局结果。
-
-## 标准代码骨架
-
-```vue
-<script setup lang="ts">
-import { ref } from 'vue';
-import { YTree } from '@yss-ui/components';
-import { useTreeHeight, YTREE_SEARCH_HEIGHT } from '@yss-ui/hooks';
-
-const treeAreaRef = ref<HTMLDivElement>();
-const treeData = ref([]);
-const { treeHeight, recalculateHeight } = useTreeHeight(treeAreaRef, {
-  extraOffset: YTREE_SEARCH_HEIGHT,
-});
-</script>
-
-<template>
-  <div ref="treeAreaRef" class="tree-area">
-    <YTree :height="treeHeight" :tree-data="treeData" filterable />
-  </div>
-</template>
-
-<style scoped lang="less">
-@import './style.less';
-</style>
-```
-
-```less
-/* style.less */
-.tree-layout {
-  height: 100%;
-  display: flex;
-  flex-direction: column;
-}
-
-.tree-area {
-  flex: 1;
-  min-height: 0;
-  overflow: hidden;
-}
-```
-
-## 容器切换时机
-
-```typescript
-import { nextTick } from 'vue';
-
-/** 容器显示后补充一次高度计算。 */
-const handleVisibleChange = async (visible: boolean) => {
-  if (!visible) return;
-  await nextTick();
-  recalculateHeight();
-};
-```
-
-## 交付检查清单
-
-- [ ] `treeAreaRef` 在 Hook 挂载时可用，父级高度可计算。
-- [ ] 内置搜索开关与 `YTREE_SEARCH_HEIGHT` 偏移一致，没有重复扣减。
-- [ ] Tab/抽屉切换后使用真实的 `recalculateHeight()` 重算。
-- [ ] 节点较少时未裁剪 DOM 被识别为正常虚拟滚动阈值行为。
-
-## 失败兜底策略
-
-- 树高度显示为 `minHeight` 且与容器不符时，检查是否在隐藏态完成首次计算，并在可见后重算。
-- `treeAreaRef` 由 `v-if` 延迟创建且尺寸不再自动更新时，保持外层容器挂载后重新初始化 Hook，或使用 `v-show + recalculateHeight()`。
-- 节点较少未触发 DOM 裁剪时，核对虚拟滚动阈值，不加 `virtual=true` 伪装修复。

package/template/.cursor/skills/yss-use-tree-height/agents/openai.yaml

@@ -1,5 +0,0 @@
-version: 1
-interface:
-  display_name: "YSS Tree Height"
-  short_description: "YTree 自适应高度计算、搜索偏移与布局处理规范"
-  default_prompt: "Use $yss-use-tree-height to wire a responsive tree height calculation for a YSS page."

package/template/.cursor/skills/yss-use-tree-height/references/frontend-docs.md

@@ -1,9 +0,0 @@
-# yss-use-tree-height 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.
-
-- hooks: http://192.168.164.27:3200/hooks
-
-When documentation and local code differ, inspect the current project code before editing and prefer established local usage.

package/template/.pi/skills/component-selection-imports/SKILL.md

@@ -1,64 +0,0 @@
----
-name: component-selection-imports
-description: 指导 YSS UI 业务页面、CRUD、列表页、表单页和组件评审在编码前判定组件、Hook 与工具函数的真实导出来源；当需要在 @yss-ui/components、@yss-ui/hooks、@yss-ui/utils 与 ant-design-vue 之间选择，或需要排查虚构 Y 前缀组件、错误导入、Formily UI 边界时使用。
----
-
-# 组件选择与导入
-
-## 触发条件
-
-- 生成 YSS UI 业务页面前需要判定组件、Hook 或工具函数来源。
-- 出现错误 Y 前缀、导入冲突、Formily UI 跨层或者组件是否已封装不明确。
-
-## 不适用场景
-
-- 只修改与 UI 导入无关的纯数据逻辑。
-- 组件库内部组件开发；该场景应按组件开发规范处理内部依赖。
-
-## 判定流程
-
-1. 当前会话可用 yss-ui MCP 时，先用 `list_components` 确认组件、Hook 或 Utils 是否真实存在，再用 `get_component_docs` 确认名称、导出包、Props、Events 和 Slots，不只看 demo 标签名。
-2. `get_component_docs` 未命中时，先用 `search_docs` 和 `list_components` 校正别名与归属，不得立即判定为未封装。
-3. MCP 工具不可用、调用失败或校正后仍无结果时，读取当前上下文或文档站的最新 `llms-full.txt`。
-4. 必要时读取 `../yss-ui-business-page-generation/references/component-map.md`、`hooks-map.md`、`utils-map.md` 快速缩小范围；文档与当前项目依赖版本不一致时，最终以当前源码和可编译导出为准。
-5. 已导出的 YSS 能力优先从 `@yss-ui/components`、`@yss-ui/hooks`、`@yss-ui/utils` 导入；确认未封装后才从 `ant-design-vue` 导入原组件。
-6. 若文档与导出源码不一致，记录差异并按当前仓库可编译的导出处理，不猜测 API。
-
-## 硬约束（禁止/必须）
-
-- 业务层已封装组件必须从 `@yss-ui/components` 导入；可编辑表格必须优先使用 `YEditTable`，业务主表格必须优先使用 `YTable`。
-- 当前公共导出包含 `YButton`、`YCard`、`YTable`、`YEditTable`、`YTree`、`YSplitPane`、`YFormily` 等；未导出 `YModal`、`YDrawer`、`YInput`、`YPopconfirm`，禁止臆造这些名称。
-- 当前未封装的 `Modal`、`Drawer`、`Popconfirm`、`Input` 等从 `ant-design-vue` 导入。删除操作使用按钮附近的 `Popconfirm`，不默认使用居中 `Modal.confirm`。
-- 业务层禁止导入 `@formily/antdv` 或 `@formily/antd*` UI 组件；使用 `YFormily` 提供的 Schema 与组件边界。
-- 禁止因文档暂时不可达就把猜测的 `Y*` 组件改成 Ant Design Vue “先落地”。只能复用当前仓库已证明可用的导入，或明确报告待确认项。
-- 接口错误提示由 `mutator.ts` 的响应拦截器统一处理。API Hook 不得在 `success === false` 分支或 `catch` 内重复调用 `message.error`；`message` 只用于非 API 错误的本地交互反馈或成功提示。
-
-## 标准代码骨架
-
-```typescript
-import {
-  YButton,
-  YCard,
-  YEditTable,
-  YTable,
-  YTree,
-  YFormily,
-  type YEditTableColumn,
-  type YTableColumn,
-} from '@yss-ui/components';
-import { useLoading, useTableHeight, useTreeHeight } from '@yss-ui/hooks';
-import { copyToClipboard, formatDate } from '@yss-ui/utils';
-import { Drawer, Input, Modal, Popconfirm } from 'ant-design-vue';
-```
-
-## 交付检查清单
-
-- [ ] 每个关键导入都能在最新文档或包的 `src/index.ts` 中追溯。
-- [ ] 未导出的 Y 前缀组件没有出现在业务代码中。
-- [ ] 删除、表格、编辑表格和 Formily 导入边界符合项目约束。
-- [ ] API Hook 中没有重复 `message.error`，异常仍由 `Promise.reject` 中断后续流程。
-
-## 失败兜底策略
-
-- MCP 与 `llms-full.txt` 都不可用时，用 CodeGraph/源码 `src/index.ts` 和当前项目已编译的相近页面交叉确认，不猜测导出。
-- 文档与源码不一致时，优先保证当前仓库可编译，并在交付中明确标注文档差异。

package/template/.pi/skills/page-form-module/SKILL.md

@@ -1,168 +0,0 @@
----
-name: page-form-module
-description: "实现 YSS UI 新增、编辑、查看表单模块及弹窗闭环；排查回显丢失、重置、提交与列表刷新。"
----
-
-# Page Form Module Skill
-
-## 触发条件
-
-- 实现新增、编辑、查看表单页，或 Drawer/Modal 中的表单闭环。
-- 需要处理 Schema、mode 0/1/2、回填、校验、提交和成功后列表刷新。
-
-## 不适用场景
-
-- 页面只包含列表查询，不包含任何表单编辑。
-- 表单为分步流程：使用 `formily-step-flow`。
-- 仅修复单个联动表达式：使用 `formily-linkage-effects`。
-
-## 必读依赖
-
-- 表单基础：`../formily-foundation/SKILL.md`
-- 联动副作用：`../formily-linkage-effects/SKILL.md`
-- 模式与详情：`../formily-mode-slot-detail/SKILL.md`
-- 分步表单：`../formily-step-flow/SKILL.md`
-- 接口与错误处理：`../yss-api-integration/SKILL.md`
-
-## 文档检索
-
-1. MCP 可用时，先用 `get_component_docs` 查询 `YFormily` 的 `mode`、`detail-options`、实例提交与回填 API，再按场景用 `get_demo` 获取 `formily/modes`、`formily/group`、`formily/linkage` 或 `formily/steps` 示例。
-2. 精确查询无结果时，先用 `search_docs` 或 `list_components` 校正名称；仅在 MCP 不可用、调用失败或校正后仍无结果时，回退读取最新 `llms-full.txt`。文档版本与当前依赖不一致时，再核对当前源码、CodeGraph 和真实导出。
-3. 当前会话已经加载上述本地 Skill 时，不要再通过 MCP 重复查询同一 Skill；仅在依赖 Skill 缺失时使用 `list_skills`、`get_skill` 补齐规则。
-
-## 硬约束（禁止/必须）
-
-- 提交前必须调用 `formRef.submit()` 或 `Submit.onSubmit` 进入完整校验链路。
-- `open/mode/currentId/formModel/submitting` 和回填、提交、关闭方法收敛在同一 Hook。
-- **数据前置同步原则（必守）**：表单数据必须在 `openCreate`/`openEdit` 触发前**同步赋好 `formModel.value`**；**严禁**在弹窗/抽屉组件内部通过 `watch(visible) + await nextTick() + initForm()` 异步回填数据（会导致首次编辑正常，切换新增再编辑时因时序差读取到残留空对象导致回显变空白的经典 Bug）。
-- **单一信任源**：使用 `v-model="formModel"` + `ref="formRef"` 调用 `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="open"` 随容器打开挂载、关闭销毁，避免宽度为 0 导致栅格退化，并彻底回收脏状态。
-- 新增/编辑/查看使用 `YFormily :mode="mode"`，`mode=2` 不渲染保存按钮。
-- Drawer 默认使用响应式宽度；基础表单设置 `FormLayout { labelWidth: 140, labelAlign: 'right' }`。
-- Drawer/Modal 中的 `FormGrid` 默认使用 `maxColumns: 2`、`minColumns: 1`、`minWidth: 320~360`；禁止 `minColumns: 2` 锁死两列。
-- 备注、说明和长文本通过 `x-decorator-props.gridSpan` 跨满整行。
-- 下拉选择器异步数据源必须使用 `enum` 或 `x-reactions` / `field.dataSource` 注入，严禁写入 `x-component-props.options`；基础字典下拉优先在弹窗打开前 `await` 拉取完成或在页面初始化提前拉取。
-- **表单校验规则规范**：必填文本字段声明 `whitespace: true`（如 `{ required: true, whitespace: true, message: '请输入xxx' }`）；自定义长度与格式校验必须使用条件式函数，空值放行交由 `required` 报错，非空才校验具体规则，禁止多个自定义校验重复承担必填职责。YFormily 适配层虽会归一化反馈展示，但不能代替正确的 Schema 语义。
-- 长整型 ID 按字符串原样回填和提交，禁止 `Number()`/`parseInt()`；表单中的普通数值按生成 DTO 真实类型处理。
-- 禁止使用 `if (res?.success)` 包裹保存成功逻辑，也禁止在 `catch` 重复 `message.error`。
-
-## 标准代码骨架
-
-```typescript
-import { ref } from 'vue';
-
-/** 默认表单模型 */
-const createDefaultModel = () => ({
-  name: '',
-  code: '',
-  description: '',
-});
-
-/** YFormily 业务侧仅需的实例方法。 */
-interface FormilyFormRef {
-  submit: () => Promise<Record<string, unknown>>;
-}
-
-/** 管理表单的模式、可见性、数据模型与提交链路。 */
-export const useRuleForm = (onSuccess: () => void) => {
-  const open = ref(false);
-  const mode = ref<0 | 1 | 2>(0);
-  const currentId = ref<string>();
-  const formModel = ref(createDefaultModel());
-  const submitting = ref(false);
-  const formRef = ref<FormilyFormRef>();
-
-  /** 打开新增：同步赋空值 */
-  const openCreate = (): void => {
-    mode.value = 0;
-    currentId.value = undefined;
-    formModel.value = createDefaultModel();
-    open.value = true;
-  };
-
-  /** 打开编辑：同步赋目标行数据，前置完成回填 */
-  const openEdit = (record: Record<string, any>): void => {
-    mode.value = 1;
-    currentId.value = record.id;
-    formModel.value = {
-      name: record.name ?? '',
-      code: record.code ?? '',
-      description: record.description ?? '',
-    };
-    open.value = true;
-  };
-
-  /** 关闭并清理 */
-  const close = (): void => {
-    open.value = false;
-    formModel.value = createDefaultModel();
-  };
-
-  /** 校验并保存表单。 */
-  const submit = async (): Promise<void> => {
-    if (mode.value === 2 || submitting.value || !formRef.value) return;
-
-    submitting.value = true;
-    try {
-      const values = await formRef.value.submit();
-      await saveRule({ ...formModel.value, ...values, id: currentId.value });
-      close();
-      onSuccess();
-    } catch {
-      // Formily 校验反馈或 mutator 已展示错误，此处不重复 Toast。
-    } finally {
-      submitting.value = false;
-    }
-  };
-
-  return { open, mode, currentId, formModel, submitting, formRef, openCreate, openEdit, close, submit };
-};
-```
-
-`saveRule` 必须替换为当前 Orval 真实生成方法，不得照抄占位名。
-
-```vue
-<YFormily
-  v-if="open"
-  ref="formRef"
-  v-model="formModel"
-  :schema="schema"
-  :mode="mode"
-  :detail-options="{ bordered: true, maxColumns: 2, minColumns: 1, minWidth: 320 }"
-/>
-```
-
-```typescript
-/** Drawer 表单的基础布局 Schema。 */
-export const drawerFormLayout = {
-  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: 340, columnGap: 24, rowGap: 16 },
-      properties: {},
-    },
-  },
-};
-```
-
-## 交付检查清单
-
-- [ ] `mode=0/1/2` 语义、回填和查看态渲染正确。
-- [ ] 提交先校验，又防重入，loading 始终在 `finally` 恢复。
-- [ ] Drawer/Modal 内 `YFormily` 按可见性条件挂载与销毁。
-- [ ] label 宽度和右对齐一致，FormGrid 能从 2 列响应式收缩为 1 列。
-- [ ] 长字段已跨行，长整型 ID 未转 number。
-- [ ] 没有 `if (res?.success)` 和重复错误 Toast。
-- [ ] 成功后关闭表单并通知上层刷新。
-- [ ] 业务层未导入 `@formily/antdv` UI 组件。
-
-## 失败兜底策略
-
-- 提交无响应时，先确认 `submit()` 是否实际调用并查看 Formily 校验反馈。
-- 编辑回填异常时，核对真实 DTO、字段路径与 Schema path，不在模板散落转换。
-- 表单过大时，拆分 Schema 生成函数、字典 Hook 和提交 Hook，保持 `index.vue` 不超过 150 行。

package/template/.pi/skills/page-list-module/SKILL.md

@@ -1,137 +0,0 @@
----
-name: page-list-module
-description: 指导实现 YSS UI 标准列表、远程分页、查询重置、YTable 工具栏、行操作、批量操作和左树右表模块；当页面需要查询、表格、分页或 CRUD 列表闭环时使用。
----
-
-# Page List Module Skill
-
-## 触发条件
-
-- 实现查询、表格、分页、行操作或批量操作组合的业务列表。
-- 实现左树右表、远程分页、工具栏或列设置。
-
-## 不适用场景
-
-- 仅实现表单提交，没有列表或分页。
-- 仅展示本地静态数据，不涉及业务查询与列表操作。
-
-## 必读依赖
-
-- 组件选型：`../component-selection-imports/SKILL.md`
-- 表格 API：`../ytable-usage/SKILL.md`
-- 查询表单：`../yss-formily/SKILL.md`
-- 接口、错误链路和长整型：`../yss-api-integration/SKILL.md`
-- 左树右表高度：`../ytree-usage/SKILL.md`、`../yss-use-tree-height/SKILL.md`、`../yss-use-table-height/SKILL.md`
-
-## 文档检索
-
-1. MCP 可用时，按当前页面实际使用的能力调用 `get_component_docs` 查询 `YTable`、`YFormily`、`useTableHeight` 或 `useTreeHeight`，再用 `get_demo` 获取对应官方示例；不要只凭 Skill 内的静态片段推断 API。
-2. 精确查询无结果时，先用 `search_docs` 或 `list_components` 校正名称；仅在 MCP 不可用、调用失败或校正后仍无结果时，回退读取最新 `llms-full.txt`。文档版本与当前依赖不一致时，再核对当前源码、CodeGraph 和真实导出。
-3. 当前会话已经加载上述本地 Skill 时，不要再通过 MCP 重复查询同一 Skill；仅在依赖 Skill 缺失时使用 `list_skills`、`get_skill` 补齐规则。
-
-## 硬约束（禁止/必须）
-
-- 列表请求必须收敛在 `useXxxList`，模板不直接请求。
-- 后端查询参数可用 `pageIndex/pageSize`；YTable 分页状态必须使用 `current/pageSize/total`。
-- 远程分页必须配置 `pageable`、`pagination.remote = true`、`v-model:pagination` 和 `@page-change`；事件参数固定为 `{ current, pageSize }`，禁止读取 `currentPage`。
-- 禁止臆造 `request`/`search-params` 等 Prop，也禁止把实例 `refresh()` 当成远程重新查询；该方法只调用 vxe `updateData()` 刷新当前表格数据，远程查询/重置/刷新必须调用业务 Hook。
-- 查询区使用纵向 `search-content`：`YFormily` 仅渲染字段，查询/重置按钮在外部 `.xxx__search-actions` 独占下一行并右对齐。
-- 新增、导入、批量操作等主操作直接放入 `#toolbar-right` 插槽即可自动渲染；**无需配置 `:toolbar-config="{ custom: true }"`**，避免无端展示列设置图标；**仅在业务明确需要列设置时才传入 `:toolbar-config="{ custom: true }"`**。
-- 删除等危险操作默认使用 `actionConfig.buttons[].isConfirm` 按钮项气泡确认，禁止默认使用居中 `Modal.confirm`。
-- 列定义、状态映射和筛选配置放入 `constant.ts`；超过 10 行的列不得内联在 `index.vue`。
-- 长整型 ID 保持字符串透传，禁止 `Number()`/`parseInt()` 等会丢失精度的转换；页码、状态值等普通 number 按真实生成类型使用。
-- 禁止使用 `if (res?.success)` 包裹成功逻辑，也禁止在 `else`/`catch` 重复调用 `message.error`；mutator 已对 `success === false` 提示并 reject。
-
-## 标准代码骨架
-
-```typescript
-import { reactive, ref } from 'vue';
-
-/** 管理规则列表数据、查询条件和远程分页。 */
-export const useRuleList = () => {
-  const loading = ref(false);
-  const dataList = ref<RuleItem[]>([]);
-  const query = reactive<RuleQuery>({ pageIndex: 1, pageSize: 20, keyword: '' });
-  const pagination = reactive({ current: 1, pageSize: 20, total: 0, remote: true });
-
-  /** 请求规则列表；错误 Toast 由 mutator 处理。 */
-  const fetchData = async (): Promise<void> => {
-    loading.value = true;
-    try {
-      query.pageIndex = pagination.current;
-      query.pageSize = pagination.pageSize;
-      const res = await queryRuleList(query);
-      dataList.value = res.data ?? [];
-      pagination.total = res.totalCount ?? 0;
-    } catch {
-      dataList.value = [];
-      pagination.total = 0;
-    } finally {
-      loading.value = false;
-    }
-  };
-
-  /** 处理页码或每页数量变化。 */
-  const handlePageChange = ({ current, pageSize }: { current: number; pageSize: number }): void => {
-    pagination.current = current;
-    pagination.pageSize = pageSize;
-    void fetchData();
-  };
-
-  /** 从第一页执行查询。 */
-  const handleSearch = (): void => {
-    pagination.current = 1;
-    void fetchData();
-  };
-
-  /** 重置查询条件并回到第一页。 */
-  const handleReset = (): void => {
-    Object.assign(query, { pageIndex: 1, pageSize: pagination.pageSize, keyword: '' });
-    pagination.current = 1;
-    void fetchData();
-  };
-
-  return { loading, dataList, query, pagination, fetchData, handlePageChange, handleSearch, handleReset };
-};
-```
-
-`RuleItem`、`RuleQuery`、`queryRuleList` 必须替换为当前 Orval 生成类型和真实方法，禁止照抄占位名。
-
-```vue
-<YTable
-  v-if="isReady"
-  ref="tableRef"
-  v-model:selected-row-keys="selectedRowKeys"
-  :row-config="{ keyField: 'id', useKey: true }"
-  :data="dataList"
-  :columns="TABLE_COLUMNS"
-  :loading="loading"
-  :height="tableHeight"
-  pageable
-  v-model:pagination="pagination"
-  @page-change="handlePageChange"
->
-  <template #toolbar-right>
-    <YButton :disabled="selectedRowKeys.length === 0" @click="handleBatchDelete">批量删除</YButton>
-    <YButton type="primary" @click="openCreate">新增</YButton>
-  </template>
-</YTable>
-```
-
-## 交付检查清单
-
-- [ ] 已确认真实 Orval 导出、查询 DTO 和响应字段。
-- [ ] 查询参数与 YTable 分页字段已映射，`page-change` 回调读取 `current/pageSize` 而非 `currentPage`。
-- [ ] 若包含批量操作，首列已配置 `type: 'checkbox'`，设置了 `:row-config="{ keyField: 'xxx', useKey: true }"`，批量按钮配置了 `:disabled="selectedRowKeys.length === 0"`，操作成功后已清空选中态。
-- [ ] 查询/重置会回到第一页，远程分页配置完整。
-- [ ] 主操作在 `#toolbar-right`，列设置已开启。
-- [ ] 删除使用气泡确认，操作按钮的 loading/close 在成功与失败后都会恢复。
-- [ ] 长整型 ID 未转 number，普通 number 仍符合真实类型。
-- [ ] 没有 `if (res?.success)` 和重复错误 Toast。
-- [ ] loading、空态和失败后数据状态可预期。
-
-## 失败兜底策略
-
-- 分页字段混乱时，在 Hook 中分离 YTable 状态和后端参数，不直接把 `pageIndex/totalCount` 绑到组件。
-- 列表逻辑过大时，拆分 `useListData` 和 `useListActions`，不得回填到 `index.vue`。
-- 响应字段不稳定时，在 Hook API 边界做最小映射，禁止在模板散落兼容分支。

package/template/.pi/skills/page-skeleton/SKILL.md

@@ -1,76 +0,0 @@
----
-name: page-skeleton
-description: "创建或拆分 Vue3 YSS UI 页面模块骨架，明确页面、配置、hooks 与私有组件职责。"
----
-
-# Page Skeleton Skill
-
-## 触发条件
-
-- 新建业务页面模块（列表、表单、详情、弹窗任意组合）。
-- 需要快速搭建目录结构、类型文件、hooks、组件分层。
-- 需要把页面代码控制在可维护结构，而不是单文件堆叠。
-
-## 不适用场景
-
-- 仅补一个局部交互逻辑，不涉及页面骨架重建。
-- 仅改 API 请求细节：使用 `../yss-api-integration/SKILL.md`。
-- 仅做 Formily 细节：使用 `../formily-*` 系列 skill。
-
-## 硬约束（禁止/必须）
-
-- 开发前必须先执行组件选型：`../component-selection-imports/SKILL.md`。
-- 页面目录默认拆分：`index.vue + constant.ts + style.less + hooks/`；存在多个私有视图或大量独立类型时再增加 `components/` 和 `type.ts`。
-- `index.vue` 只做 hooks 组合和视图编排，原则上控制在 150 行以内；超过 150 行或包含多个独立职责时必须拆分。
-- 表格列超过 10 行时放入 `constant.ts`；状态、API 调用、副作用和事件处理放入 `hooks/useXxx.ts`。
-- 所有样式放入 `style.less`，SFC 只保留 `<style scoped lang="less">@import './style.less';</style>`。
-- 所有导出函数、hooks、类型和静态配置必须有中文 JSDoc。
-- 表单方案默认用 `YFormily`；分步场景默认用 `formily-step-flow`。
-- 不得导入 `@formily/antdv` 作为业务 UI 方案。
-
-## 标准代码骨架
-
-```text
-packages/src/views/{ModuleName}/
-├── index.vue
-├── constant.ts
-├── style.less
-├── hooks/
-│   ├── use{Module}List.ts
-│   └── use{Module}Form.ts
-├── type.ts              # 独立类型较多时增加
-└── components/          # 存在多个私有视图时增加
-    ├── {Module}Table.vue
-    └── {Module}Modal.vue
-```
-
-```vue
-<script setup lang="ts">
-import { useModuleList } from './hooks/useModuleList';
-import { useModuleForm } from './hooks/useModuleForm';
-
-const list = useModuleList();
-const form = useModuleForm({ onSuccess: list.fetchData });
-</script>
-```
-
-## 交付检查清单
-
-- [ ] 目录拆分完整，职责清晰。
-- [ ] `index.vue` 不超过 150 行，且仅负责组合和渲染。
-- [ ] 类型定义与常量已抽离，不在页面内硬编码。
-- [ ] hooks 可复用且命名清晰（`useXxx`）。
-- [ ] 样式已抽离到 `style.less`，SFC 样式块已 scoped。
-- [ ] 页面导入组件来源符合组件选型规则。
-- [ ] 若包含表单，已选择对应 Formily skill。
-
-## 失败兜底策略
-
-- 当需求不清晰时，先落地最小骨架（列表区 + 操作区 + 弹窗占位），再增量填充。
-- 当页面复杂度超预期时，优先继续拆 hooks 和私有组件，而不是在 `index.vue` 堆逻辑。
-- 若组件是否封装存在歧义，回退到 `component-selection-imports` 先判定导入来源。
-
-## 示例
-
-- `./examples/StandardListPage/`
-- `./examples/AdvancedFormPage/`

package/template/.pi/skills/page-skeleton/examples/AdvancedFormPage/constant.ts

@@ -1,34 +0,0 @@
-import type { OperatorOption, OptionItem } from '@yss-ui/components';
-
-/** 表单字典选项。 */
-export interface FormOptions {
-  intensity: Array<{ label: string; value: string }>;
-  errorStorageType: Array<{ label: string; value: string }>;
-}
-
-/** 规则配置表单字典。 */
-export const FORM_OPTIONS: FormOptions = {
-  intensity: [
-    { label: '弱规则', value: 'WEAK' },
-    { label: '强规则', value: 'STRONG' },
-  ],
-  errorStorageType: [
-    { label: '文件服务', value: 'FILE_SYSTEM' },
-    { label: '数据落地表', value: 'DATATABLE_SYSTEM' },
-  ],
-};
-
-/** 条件构建器可选字段。 */
-export const FIELD_OPTIONS: OptionItem[] = [
-  { label: '用户编号', value: 'userId' },
-  { label: '金额', value: 'amount' },
-  { label: '状态', value: 'status' },
-];
-
-/** 条件构建器操作符。 */
-export const RULE_OPERATOR_OPTIONS: OperatorOption[] = [
-  { label: '等于', value: '=', kind: 'single' },
-  { label: '大于', value: '>', kind: 'single' },
-  { label: '介于', value: 'between', kind: 'between' },
-  { label: '包含于', value: 'in', kind: 'multiple' },
-];

package/template/.pi/skills/page-skeleton/examples/AdvancedFormPage/hooks/useRuleConfig.ts

@@ -1,75 +0,0 @@
-import { reactive, ref } from 'vue';
-import { message } from 'ant-design-vue';
-import type { ConditionGroup, OptionItem } from '@yss-ui/components';
-import { FIELD_OPTIONS, RULE_OPERATOR_OPTIONS } from '../constant';
-
-/** 创建空条件组。 */
-const createEmptyGroup = (id: string): ConditionGroup => ({
-  id,
-  type: 'GROUP',
-  logicalOp: 'AND',
-  children: [],
-});
-
-/** 按关键词筛选条件字段。 */
-const filterFields = (keyword: string): OptionItem[] => {
-  const normalizedKeyword = keyword.trim().toLowerCase();
-  if (!normalizedKeyword) return FIELD_OPTIONS;
-  return FIELD_OPTIONS.filter(item =>
-    [item.label, item.value].some(value =>
-      String(value ?? '')
-        .toLowerCase()
-        .includes(normalizedKeyword)
-    )
-  );
-};
-
-/** 管理条件构建器与预览状态。 */
-export const useRuleConfig = () => {
-  const filterCondition = ref<ConditionGroup>(createEmptyGroup('filter-root'));
-  const checkCondition = ref<ConditionGroup>(createEmptyGroup('check-root'));
-  const filterPreview = ref('');
-  const checkPreview = ref('');
-  const loading = reactive({ filterPreview: false, checkPreview: false });
-
-  /** 为 YConditionBuilder 加载可搜索字段。 */
-  const loadFields = async (keyword: string): Promise<OptionItem[]> => filterFields(keyword);
-
-  /** 生成条件 JSON 预览。 */
-  const generatePreview = async (
-    condition: ConditionGroup,
-    target: 'filterPreview' | 'checkPreview'
-  ): Promise<void> => {
-    if (!condition.children.length) {
-      message.warning('请先配置完整条件');
-      return;
-    }
-
-    loading[target] = true;
-    try {
-      const preview = JSON.stringify(condition, null, 2);
-      if (target === 'filterPreview') filterPreview.value = preview;
-      else checkPreview.value = preview;
-    } finally {
-      loading[target] = false;
-    }
-  };
-
-  /** 生成校验范围预览。 */
-  const generateFilterPreview = (): Promise<void> => generatePreview(filterCondition.value, 'filterPreview');
-
-  /** 生成校验表达式预览。 */
-  const generateCheckPreview = (): Promise<void> => generatePreview(checkCondition.value, 'checkPreview');
-
-  return {
-    filterCondition,
-    checkCondition,
-    filterPreview,
-    checkPreview,
-    loading,
-    operatorOptions: RULE_OPERATOR_OPTIONS,
-    loadFields,
-    generateFilterPreview,
-    generateCheckPreview,
-  };
-};