create-yss-spec 1.0.0

package/template/.codex/skills/yss-ui/assets/reference-index.md

@@ -0,0 +1,74 @@
+# yss-ui 引用索引
+
+## 说明
+
+- 本索引从以下文件提取依赖引用并校验可达性：
+  - `../SKILL.md`
+  - `../references/quick-recipes.md`
+  - `../references/checklist.md`
+- 目标：集中沉淀到 `assets`，便于快速定位文档与示例。
+- 已将引用文档复制到：`./docs`
+- 已将引用样例复制到：`./demos`
+- 校验结果：以下引用路径均已存在。
+
+---
+
+## A. 文档引用（Docs）
+
+| 分类       | 原引用路径                       | 本地副本路径                            |
+| ---------- | -------------------------------- | --------------------------------------- |
+| Components | `components/table.md`            | `./docs/components/table.md`            |
+| Components | `components/editTable.md`        | `./docs/components/editTable.md`        |
+| Components | `components/formily.md`          | `./docs/components/formily.md`          |
+| Components | `components/tree.md`             | `./docs/components/tree.md`             |
+| Components | `components/split-pane.md`       | `./docs/components/split-pane.md`       |
+| Components | `components/monaco.md`           | `./docs/components/monaco.md`           |
+| Components | `components/echarts.md`          | `./docs/components/echarts.md`          |
+| Components | `components/fileImport.md`       | `./docs/components/fileImport.md`       |
+| Components | `components/conditionBuilder.md` | `./docs/components/conditionBuilder.md` |
+| Components | `components/cron.md`             | `./docs/components/cron.md`             |
+| Components | `components/card.md`             | `./docs/components/card.md`             |
+| Components | `components/button.md`           | `./docs/components/button.md`           |
+| Components | `components/sheet.md`            | `./docs/components/sheet.md`            |
+| Hooks      | `hooks/use-table-height.md`      | `./docs/hooks/use-table-height.md`      |
+| Hooks      | `hooks/use-tree-height.md`       | `./docs/hooks/use-tree-height.md`       |
+| Hooks      | `hooks/useFullscreen.md`         | `./docs/hooks/useFullscreen.md`         |
+| Hooks      | `hooks/useLoading.md`            | `./docs/hooks/useLoading.md`            |
+| Guide      | `guide/index.md`                 | `./docs/guide/index.md`                 |
+| Guide      | `guide/installation.md`          | `./docs/guide/installation.md`          |
+| Guide      | `guide/jsp.md`                   | `./docs/guide/jsp.md`                   |
+| Guide      | `guide/llms.md`                  | `./docs/guide/llms.md`                  |
+| Guide      | `guide/release-workflow.md`      | `./docs/guide/release-workflow.md`      |
+| Guide      | `guide/gitlab-ci-integration.md` | `./docs/guide/gitlab-ci-integration.md` |
+| Guide      | `guide/monorepo-versioning.md`   | `./docs/guide/monorepo-versioning.md`   |
+| Root       | `resources.md`                   | `./docs/root/resources.md`              |
+
+---
+
+## B. 样例引用（Demos）
+
+| 组件              | 原引用模式                                  | 本地副本目录                |
+| ----------------- | ------------------------------------------- | --------------------------- |
+| YTable            | `docs/components/demos/table/*`             | `./demos/table`             |
+| YEditTable        | `docs/components/demos/edit-table/*`        | `./demos/edit-table`        |
+| YFormily          | `docs/components/demos/formily/*`           | `./demos/formily`           |
+| YTree             | `docs/components/demos/tree/*`              | `./demos/tree`              |
+| SplitPane         | `docs/components/demos/split-pane/*`        | `./demos/split-pane`        |
+| YMonaco           | `docs/components/demos/monaco/*`            | `./demos/monaco`            |
+| YEcharts          | `docs/components/demos/echarts/*`           | `./demos/echarts`           |
+| YFileImport       | `docs/components/demos/file-import/*`       | `./demos/file-import`       |
+| YConditionBuilder | `docs/components/demos/condition-builder/*` | `./demos/condition-builder` |
+| YCron             | `docs/components/demos/cron/*`              | `./demos/cron`              |
+| YCard             | `docs/components/demos/card/*`              | `./demos/card`              |
+| YButton           | `docs/components/demos/button/*`            | `./demos/button`            |
+
+---
+
+## C. 快速打开建议
+
+- 组件 API：优先打开 `A. 文档引用` 中对应 `components/*.md`。
+- 真实样例：优先打开 `B. 样例引用` 中对应目录下 `index.vue`。
+- 表格/树高度问题：先看 `hooks/use-table-height.md` 与 `hooks/use-tree-height.md`。
+- DOM 模板插槽命名问题：先看 `guide/jsp.md` 与 `components/table.md` 插槽章节。
+- 业务场景检索：优先打开 `./scenario-index.md` 按场景快速跳转。
+- 关键词反向定位：优先打开 `./keyword-index.md` 按关键词快速跳转。

package/template/.codex/skills/yss-ui/assets/scenario-index.json

@@ -0,0 +1,50 @@
+{
+  "scenarios": [
+    {
+      "name": "列表管理页（查询 + 分页 + 操作）",
+      "docs": ["./docs/components/table.md"],
+      "demos": ["./demos/table/basic", "./demos/table/action", "./demos/table/pagination-remote"]
+    },
+    {
+      "name": "远程筛选列表页",
+      "docs": ["./docs/components/table.md"],
+      "demos": ["./demos/table/filter-remote", "./demos/table/filter-mixed"]
+    },
+    {
+      "name": "可编辑表格（行内编辑）",
+      "docs": ["./docs/components/editTable.md"],
+      "demos": ["./demos/edit-table/row-edit", "./demos/edit-table/required", "./demos/edit-table/custom-rule"]
+    },
+    {
+      "name": "树表联动页面（左树右表）",
+      "docs": ["./docs/components/tree.md", "./docs/components/split-pane.md", "./docs/hooks/use-tree-height.md"],
+      "demos": ["./demos/split-pane/tree-table", "./demos/split-pane/tree-table-layout"]
+    },
+    {
+      "name": "JSON Schema 表单（新增/编辑/查看）",
+      "docs": ["./docs/components/formily.md"],
+      "demos": ["./demos/formily/basic.vue", "./demos/formily/modes.vue", "./demos/formily/steps.vue"]
+    },
+    {
+      "name": "文件导入两步流",
+      "docs": ["./docs/components/fileImport.md"],
+      "demos": ["./demos/file-import/basic.vue", "./demos/file-import/formily.vue"]
+    },
+    {
+      "name": "代码编辑与日志查看",
+      "docs": ["./docs/components/monaco.md", "./docs/hooks/useFullscreen.md"],
+      "demos": ["./demos/monaco/monaco.vue", "./demos/monaco/log-viewer.vue", "./demos/monaco/fullscreen.vue"]
+    },
+    {
+      "name": "图表分析页",
+      "docs": ["./docs/components/echarts.md"],
+      "demos": ["./demos/echarts/line.vue", "./demos/echarts/mix.vue", "./demos/echarts/dark.vue"]
+    },
+    {
+      "name": "高度自适应",
+      "docs": ["./docs/hooks/use-table-height.md", "./docs/hooks/use-tree-height.md"],
+      "demos": ["./demos/table/basic", "./demos/tree/search-toolbar"]
+    }
+  ],
+  "status": "validated"
+}

package/template/.codex/skills/yss-ui/assets/scenario-index.md

@@ -0,0 +1,41 @@
+# yss-ui 场景索引
+
+## 使用方式
+
+- 先按业务场景选条目，再打开对应 API 文档与 Demo 目录。
+- 默认顺序：先看 `docs` 规则，再看 `demos` 实现。
+- 若一个需求覆盖多个场景，按“主流程优先、增强能力补充”组合取用。
+
+---
+
+## 场景映射
+
+| 场景                               | 优先文档                                                                                          | 优先 Demo                                                                                                |
+| ---------------------------------- | ------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
+| 列表管理页（查询 + 分页 + 操作）   | `./docs/components/table.md`                                                                      | `./demos/table/basic`、`./demos/table/action`、`./demos/table/pagination-remote`                         |
+| 远程筛选列表页                     | `./docs/components/table.md`                                                                      | `./demos/table/filter-remote`、`./demos/table/filter-mixed`                                              |
+| 可编辑表格（行内编辑）             | `./docs/components/editTable.md`                                                                  | `./demos/edit-table/row-edit`、`./demos/edit-table/required`、`./demos/edit-table/custom-rule`           |
+| 大数据表格                         | `./docs/components/table.md`、`./docs/components/editTable.md`                                    | `./demos/table/merge-cells`、`./demos/edit-table/big-data`                                               |
+| 树表联动页面（左树右表）           | `./docs/components/tree.md`、`./docs/components/split-pane.md`、`./docs/hooks/use-tree-height.md` | `./demos/split-pane/tree-table`、`./demos/split-pane/tree-table-layout`                                  |
+| 组织树/资源树选择                  | `./docs/components/tree.md`                                                                       | `./demos/tree/search-toolbar`、`./demos/tree/multiple-select`、`./demos/tree/multi-checkable`            |
+| JSON Schema 表单（新增/编辑/查看） | `./docs/components/formily.md`                                                                    | `./demos/formily/basic.vue`、`./demos/formily/modes.vue`、`./demos/formily/steps.vue`                    |
+| 表单联动与异步校验                 | `./docs/components/formily.md`                                                                    | `./demos/formily/linkage.vue`、`./demos/formily/linkage-multi.vue`、`./demos/formily/async-validate.vue` |
+| 文件导入两步流                     | `./docs/components/fileImport.md`                                                                 | `./demos/file-import/basic.vue`、`./demos/file-import/formily.vue`                                       |
+| 条件构造器                         | `./docs/components/conditionBuilder.md`                                                           | `./demos/condition-builder/basic`、`./demos/condition-builder/linked`                                    |
+| Cron 配置                          | `./docs/components/cron.md`                                                                       | `./demos/cron/basic`、`./demos/cron/select`                                                              |
+| 代码编辑与日志查看                 | `./docs/components/monaco.md`、`./docs/hooks/useFullscreen.md`                                    | `./demos/monaco/monaco.vue`、`./demos/monaco/log-viewer.vue`、`./demos/monaco/fullscreen.vue`            |
+| 图表分析页                         | `./docs/components/echarts.md`                                                                    | `./demos/echarts/line.vue`、`./demos/echarts/mix.vue`、`./demos/echarts/dark.vue`                        |
+| 卡片化指标看板                     | `./docs/components/card.md`                                                                       | `./demos/card/layout-metrics`、`./demos/card/basic`                                                      |
+| 权限按钮与操作态                   | `./docs/components/button.md`                                                                     | `./demos/button/permission.vue`、`./demos/button/states.vue`                                             |
+| 表格高度自适应                     | `./docs/hooks/use-table-height.md`                                                                | `./demos/table/basic`                                                                                    |
+| 树高度自适应                       | `./docs/hooks/use-tree-height.md`                                                                 | `./demos/tree/search-toolbar`                                                                            |
+
+---
+
+## 常见任务到场景
+
+- “做一个管理列表页”：使用“列表管理页（查询 + 分页 + 操作）”。
+- “左树右表联动”：使用“树表联动页面（左树右表）”。
+- “表单要支持查看模式”：使用“JSON Schema 表单（新增/编辑/查看）”。
+- “导入模板并校验结果”：使用“文件导入两步流”。
+- “表格/树撑满可视区域”：使用“表格高度自适应”或“树高度自适应”。

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

@@ -0,0 +1,89 @@
+# yss-ui Checklist
+
+## 使用方式
+
+- 开发阶段：按页面类型逐项自检。
+- 联调阶段：重点执行“数据链路与交互”清单。
+- 提交前：至少完成“通用基线”+ 当前页面类型清单。
+
+---
+
+## 通用基线（所有页面必查）
+
+- [ ] 使用 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/*`）
+
+---
+
+## 列表页清单（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` 上下文

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

@@ -0,0 +1,11 @@
+# yss-ui Frontend Documentation
+
+Generated: 2026-06-29T16:11:14+00:00
+
+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/.codex/skills/yss-ui/references/quick-recipes.md

@@ -0,0 +1,280 @@
+# 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/*`
+- YFormily：`../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：列表请求 + Mock 联调
+
+```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：YFormily 模式切换（新增/编辑/查看）
+
+```ts
+const mode = ref<0 | 1 | 2>(0);
+const formData = ref<Record<string, any>>({});
+```
+
+```vue
+<YFormily v-model="formData" :schema="schema" :mode="mode">
+  <template #detail-owner="{ value }">
+    <a-tag color="blue">{{ value || "-" }}</a-tag>
+  </template>
+</YFormily>
+```
+
+规则要点：
+
+- 查看态插槽固定命名：`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/.codex/skills/yss-up-springboot3/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: yss-up-springboot3
+description: YSS Spring Boot 3 / Spring Cloud 升级辅助技能。Use when auditing or migrating YSS backend services/components from Spring Boot 2.x or Spring Cloud 2021-era dependencies toward Spring Boot 3, Jakarta namespace, newer Spring Security, MyBatis, OpenFeign, gateway, validation, and related compatibility changes.
+---
+
+# yss-up-springboot3
+
+Use this skill for YSS backend upgrade analysis and migration tasks around Spring Boot 3 / Spring Cloud compatibility.
+
+中文说明：这个技能是升级核查入口，不替代具体组件技能。遇到缓存、审计、MyBatis、DTO、Excel、JDBC 等组件细节时，应同时读取对应专项技能和源码索引。
+
+## When To Use
+
+- The user asks to upgrade YSS backend code to Spring Boot 3 or newer Spring Cloud baselines.
+- The task mentions `javax.*` to `jakarta.*`, Spring Security migration, validation changes, Servlet API changes, Gateway/OpenFeign compatibility, or dependency BOM changes.
+- The task involves checking whether a YSS component can run on Spring Boot 3.
+
+## Workflow
+
+1. Identify affected modules and current dependency versions from the local repository.
+2. Check for Jakarta namespace changes (`javax.servlet`, `javax.validation`, `javax.annotation`, JPA APIs, and related imports).
+3. Check Spring Security configuration style, deprecated adapters, authorization server dependencies, and filter registration behavior.
+4. Check component-specific integration by loading specialist skills such as `yss-mybatis`, `yss-dto`, `yss-cache`, `yss-audit-log`, `yss-excel-mvc`, or `yss-jdbc`.
+5. Prefer source-backed evidence from the local workspace or a source root resolved via `yss-source-index/references/source-location.md` before recommending code changes.
+6. Produce an upgrade checklist or patch with explicit compatibility risks and verification commands.
+
+## Common Checks
+
+- Maven BOM and plugin versions are aligned before changing code.
+- `javax.*` imports are migrated only where the target framework expects Jakarta APIs.
+- Spring Security configuration no longer depends on removed `WebSecurityConfigurerAdapter` patterns.
+- Validation annotations and exception handlers still map to the expected DTO/Result contract.
+- MyBatis interceptors, auto configurations, and starter metadata are compatible with Spring Boot 3 auto-configuration loading.
+- Tests or sample modules are updated together with framework code.
+
+## Do Not
+
+- Do not blindly rewrite all `javax.*` imports without checking whether the dependency still uses the old namespace.
+- Do not mix unrelated business refactors into migration patches.
+- Do not assume component compatibility from memory; inspect source and specialist skill indexes.

package/template/.codex/skills/yss-up-springboot3/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "YSS Spring Boot 3 Upgrade"
+  short_description: "YSS 后端 Spring Boot 3 升级核查"
+  default_prompt: "Use $yss-up-springboot3 to audit a YSS backend module for Spring Boot 3 compatibility."