create-yss-spec 3.5.6 → 3.5.8

package/template/.cursor/skills/yss-tactical-design/references/tactical-design-contract.md

@@ -2,7 +2,7 @@
 
 ## 输入
 
-必须引用批准且版本当前的 Spec、功能架构、战略 DDD、原型状态矩阵、OpenAPI Draft / Freeze（或无 API 影响记录）、ADR 和工程约束。来自 Strategic Design Handoff 时，额外要求 v3 交接包、`strategic_context_import_ref` 和目标仓 `context_reconciliation_ref`；目标根 `CONTEXT.md` 未完成增量对账前返回 `blocked`。所有引用都必须带版本或 digest；不可读或过期引用返回 `blocked` / `stale`。
+必须引用批准且版本当前的 Spec、功能架构、战略 DDD、适用 UI 状态矩阵、OpenAPI Draft / Freeze（或无 API 影响记录）、ADR 和工程约束。来自 Strategic Design Handoff 时，按仓库 `.template-spec/process/strategic-handoff-package.md` 的版本与消费者规则绑定交接包、`strategic_context_import_ref` 和目标仓 `context_reconciliation_ref`；历史 v3/v4 只按冻结 schema 兼容读取，新交付使用 v5。原型或 existing UI baseline 须符合该包的来源分支；目标根 `CONTEXT.md` 未完成增量对账前返回 `blocked`。所有引用都必须带版本或 digest；不可读或过期引用返回 `blocked` / `stale`。
 
 ## 输出
 

package/template/.cursor/skills/yss-technical-design/SKILL.md

@@ -9,17 +9,18 @@ description: 在 YSS 技术分析中统一承接需求与战略输入，按已
 
 由 `yss-product-lifecycle` 调度，负责 `work-unit.technical-analysis` 的技术设计，不另起生命周期、不生成生产代码。生命周期维护批准和状态；`yss-implementation-contract-compiler` 消费批准且当前的设计，起草实现合同。
 
-文档输出时按 `lifecycle-document-output` 条件调用 `i-have-adhd`，读取 `.template-spec/process/document-writing.md`；作用域仅限当前产物，派发时传递条件及引用。
+## 文档输出
 
-## 文档写作
-
-起草或修订技术设计解释正文前，读取 `.template-spec/process/document-writing.md` 的共用写法及工程契约指引，并在分支派发中传递该引用；结构化合同保持原 schema 和验证要求。
+起草或修订技术设计解释正文时，按 `lifecycle-document-output` 条件调用 `i-have-adhd`，读取 `.template-spec/process/document-writing.md` 的共用写法及工程契约指引。作用域仅限当前产物，分支派发传递条件及引用；结构化合同保持原 schema 和验证要求。
 
 ## 输入与架构选择
 
 先读根 `CONTEXT.md`、已批准且当前的 Spec、业务规则、关键场景、适用的 API 契约、ADR 和工程约束。没有 API 或其他专项影响时记录有依据的不适用，不生成占位设计。
 
-按项目绑定架构选择的来源及摘要。新工程必须先通过 `gate.backend-architecture-platform-approved`：Agent 展示 DDD / MVC 推荐依据及平台清单中的精确 Spring Boot、Java 版本，用户在同一次决定中确认两项内容；决定持久化到 `scaffold-architecture-decisions.yaml`，再进入对应分支，后续脚手架消费同一决定。既有工程核验并沿用当前登记架构及固定工程基线/POM 中的实际 Spring Boot 版本，该门禁记录为 `not-applicable`，不重复询问；架构转换或平台升级另行立项。只有 `domain-driven` 和 `layered-mvc` 两种架构族，不能从目录推断或默认 DDD、MVC 或 Spring Boot 版本。具体 Profile 及模块边界消费技能注册表与 `.template-spec/agents/backend-architecture-profiles.md`。
+按项目绑定架构来源及摘要，架构族只允许 `domain-driven` 与 `layered-mvc`；不从目录推断或默认架构、Spring Boot 版本。具体 Profile 与模块边界消费技能注册表及 `.template-spec/agents/backend-architecture-profiles.md`。
+
+- 新工程先通过 `gate.backend-architecture-platform-approved`：展示 DDD / MVC 推荐依据及平台清单中的精确 Spring Boot、Java，用户在同一次决定确认架构与平台。决定持久化到 `scaffold-architecture-decisions.yaml`，设计与后续脚手架消费同一决定。
+- 既有工程核验并沿用当前登记架构及固定工程基线/POM 的实际 Spring Boot；该门禁记录带依据的 `not-applicable`，不重复询问。架构转换或平台升级单独立项。
 
 - `domain-driven`：调用 `yss-tactical-design`，补齐适用的战略领域输入。
 - `layered-mvc`：由本 skill 直接设计模块职责与依赖方向、用例流程、业务规则、状态转换、事务与回滚、幂等与并发、持久化映射、外部集成和公开测试 seam；不要求战略 DDD、聚合、值对象、Domain Event 或 DDD Gateway。分层边界消费 `.template-spec/agents/backend-architecture-profiles.md`，不得为 MVC 加载 `yss-domain` 或生成 DDD Gateway。

package/template/.cursor/skills/yss-ui/SKILL.md

@@ -22,7 +22,11 @@ description: "选择和核验 YSS Vue 生产页面组件及 Ant Design Vue 兼
 
 ## 2. 执行前版本预检
 
-采用专职前端 profile 或显式 `frontend_delivery` 绑定时，先按 `.template-spec/process/frontend-backend-delivery.md` 实际核验战略与后端联合交付。缺任一输入只能诊断和回交；输入通过后准备计划/合同，正式实现、生成和恢复仍须当前批准的 Slice Contract 冻结接收摘要。接口或部署版本漂移时重新接收，不复用旧成功输出。
+采用专职前端 profile 或显式 `frontend_delivery` 绑定时：
+
+- 按 `.template-spec/process/frontend-backend-delivery.md` 核验战略与后端联合交付；缺任一输入只能诊断和回交。
+- 输入通过后准备计划 / 合同；正式实现、生成和恢复仍须当前批准的 Slice Contract 冻结接收摘要。
+- 接口或部署版本漂移时重新接收，不复用旧成功输出。
 
 进入实现前从前端工程根目录执行：
 
@@ -32,6 +36,8 @@ pnpm why vue @yss-ui/components @yss-ui/hooks ant-design-vue vxe-table
 
 记录实际版本、lockfile、验证命令和环境阻塞。完整策略见 `references/antdv-compatibility.md`。
 
+本次输入还包括批准合同、页面 / 交互范围和实际适用的专项技能；UI 切片使用已校验的 `frontend_implementation_plan`，实现后补 `frontend_implementation_verification`。输入缺失、摘要漂移或组件事实无法确认时，停止受影响的实现并回交原所有者。
+
 产品设计使用的 Antdv Next 或 Ant Design v6 视觉/token 语义，不等于 Vue 生产实现 API。生产代码必须使用项目安装的 Ant Design Vue 4.x API，禁止把原型 props、events、slots、hook 或组件写法当作生产合同。原型统一使用 HTML/CSS/JavaScript；原型阶段不得调用本技能。只有进入前端实现计划、已批准切片的生产实现或实现还原验证后，才从目标 lockfile、类型、本地文档和既有用法取得真实组件事实。
 
 ## 3. 组件选型门禁

package/template/.cursor/skills/yss-ui/assets/docs/guide/gitlab-ci-integration.md

@@ -162,5 +162,5 @@ git push -f origin dev
 
 ## 相关文档
 
-- [发版工作流指南](./guide/release-workflow.md)
-- [Commit 规范说明](./guide/release-workflow.md#-commit-message-规范必须遵守)
+- [发版工作流指南](./release-workflow.md)
+- [Commit 规范说明](./release-workflow.md#-commit-message-规范必须遵守)

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

@@ -1,110 +1,52 @@
-# yss-ui Checklist
+# YSS UI 交付检查
 
-## 使用方式
+开发时按当前页面和影响面自检，联调时核对数据链路，交付时重新绑定当前 Slice 的实现计划、实现还原验证与实际执行证据。未命中项按原合同记录原因；命中但未验证的项保留阻塞，不能用清单勾选替代执行。
 
-- 开发阶段：按页面类型逐项自检。
-- 联调阶段：重点执行“数据链路与交互”清单。
-- 提交前：至少完成“通用基线”+ 当前页面类型清单。
+## 通用基线
 
----
+- [ ] 已从目标工程用 `pnpm why` 确认 Vue、YSS UI、AntDV、VXE 实际版本及 lockfile。
+- [ ] 组件选型符合 [组件路由](component-routing.md)，已导出的组件 / Hook / Utils 使用真实包来源；受控回退有能力缺口、版本和验证证据。
+- [ ] 使用 Vue 3 Composition API 与 `<script setup lang="ts">`，未引入不存在的 Y 前缀组件或违规 `@formily/antd*` UI。
+- [ ] 页面编排、业务 Hook、纯配置和样式按职责组织；容器的间距与可计算高度符合工程基线。
+- [ ] 适用实现已对照匹配版本的组件文档和已验证 Demo；`pending-verification` 示例不作为推荐依据。
+- [ ] loading、empty、error、disabled/no-access 和实际依赖的 selected 状态都有反馈与恢复路径。
 
-## 通用基线（所有页面必查）
+## 主题、Locale、浮层和可访问性
 
-- [ ] 已用 `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`
+- [ ] 通过项目 ConfigProvider、YSS theme 或语义 Token 消费主题，未新增页面级主题色、任意 z-index；状态不只用颜色表达。
+- [ ] locale、时区、日期和金额格式化复用统一能力；Popup/Teleport 目标与宿主、微应用容器一致。
+- [ ] 图标按钮有可访问名称，表单 label 与错误提示有语义关联；主要动作支持键盘，Tab 顺序合理。
+- [ ] Modal/Drawer 打开后焦点合理，关闭时清理状态并恢复触发元素焦点。
+- [ ] 窄屏布局、表格横向滚动、操作收敛及实际采用的大数据 / 搜索 / 按需加载策略已验证。
 
-## 主题、Locale 与浮层
+## 列表与选择
 
-- [ ] 页面通过项目 ConfigProvider/YSS theme/语义 token 消费主题
-- [ ] 未新增页面级主题色和任意 z-index
-- [ ] locale、时区、日期和金额格式化沿用项目统一能力
-- [ ] Popup/Teleport 目标适配宿主和微应用容器
-- [ ] Modal/Drawer 关闭时清理状态并恢复触发元素焦点
+配置 YTable 时由已安装的 `ytable-usage` 核对专项规则，组件公开 API 见 [YTable 文档](../assets/docs/components/table.md)；没有多选或分页的页面不需要引入对应能力。公共包未附的专项及缺失时的停止、恢复条件见 [专项技能的可用性](quick-recipes.md#专项技能的可用性)，组件文档不能替代必要专项。
 
-## 可访问性、响应式与性能
+- [ ] 列使用 `YTableColumn` 与 `field/type`；行键配置实际业务主键和 `useKey: true`。
+- [ ] 自定义单元格与表头使用真实字段插槽，不用 `bodyCell` 分支冒充 YTable 主渲染模式；DOM 模板中的插槽按 kebab-case。
+- [ ] 远程分页使用 `pageable + v-model:pagination`，状态为 `current/pageSize/total/remote`，监听 `@page-change` 的 `{ current, pageSize }`。
+- [ ] 多选场景配置 Checkbox、受控选择和空选择禁用；批量操作成功后受控字段与可见勾选同时清空。
+- [ ] 远程查询由业务 Hook 执行，未把实例 `refresh()` 当作接口重查；危险操作使用组件确认或邻近 `Popconfirm`。
 
-- [ ] 图标按钮有可访问名称，状态不只依赖颜色
-- [ ] 表单 label、错误提示与控件建立语义关联
-- [ ] 主要操作可通过键盘完成，Tab 顺序合理
-- [ ] 窄屏布局、表格横向滚动和操作收敛已检查
-- [ ] 大数据 Table/Tree、远程搜索和复杂组件采用项目已验证的性能策略
+## 抽屉与步骤
 
----
+- [ ] 抽屉开关与当前记录有单一来源，打开前完成回填，关闭时清理临时输入，Tab 切换不引入脏数据。
+- [ ] 抽屉内列表沿用 YTable 列和分页合同；底部危险操作按批准交互设置确认，不默认使用居中 `Modal.confirm`。
+- [ ] 步骤状态有单一来源，当前实例校验成功才前进；跨步骤数据与弹层编辑回填都保留。
+- [ ] 上一步、下一步、取消与完成按钮的状态和文案正确；完成后提供反馈并进入合同约定的目标页面。
 
-## 列表页清单（YTable）
+## API、Mock、路由与菜单
 
-- [ ] 列定义使用 `YTableColumn`，主字段走 `field/type`
-- [ ] 启用 `:row-config="{ keyField: 'id' }"` 或业务主键
-- [ ] 需要选择行时已配置 `type: 'checkbox'`
-- [ ] 自定义单元格走字段插槽（如 `#status`、`#action`）
-- [ ] DOM 模板（JSP/HTML）下插槽命名使用 kebab-case（如 `#toolbar-left`）
-- [ ] 避免以 `bodyCell` 分支作为主渲染模式
-- [ ] 分页状态包含 `current/pageSize/total`
-- [ ] `@change` 中同步更新分页并触发刷新
-- [ ] 加载态与空态行为正确
+- [ ] API 经项目统一 mutator，导入当前真实生成函数与 DTO；URL 未重复拼接 `/api`。
+- [ ] 请求分页、筛选和响应映射均匹配冻结合同；Mock 路径、字段、状态码和包装复现同一 wire shape，不另定通用包装。
+- [ ] 查询回第一页，翻页保留筛选；API 失败只由 mutator 提示，Hook 维护状态与恢复，不重复错误 Toast。
+- [ ] 路由位于实际模块层级，`meta.title` 和唯一 `name` 符合页面语义；已有工程采用 `MENU_TYPE.INNER_MENU` 时，详情 / 创建页沿用其配置。
 
----
+## 实际验证与限制
 
-## 抽屉详情页清单
-
-- [ ] 抽屉开关状态单一来源（`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
+- [ ] 类型、静态检查和目标文件诊断没有新增问题；无调试输出遗留。格式检查优先使用工程现有检查模式，避免重写无关文件。
+- [ ] 适用组件测试、关键交互、E2E、响应式与视觉回归已执行，浏览器 console 无新增 warning/error。
+- [ ] `frontend_implementation_plan` / `frontend_implementation_verification` 绑定当前输入；视觉场景按 `case_id` 配对基准图、实现图、diff/mask 与差异解释。
+- [ ] 验证记录含工作目录、实际命令、退出码、环境及证据。失败报告实际现象和已确认原因；原因未知时保留未知，未执行项不写通过。
+- [ ] 文档查询按 [组件来源判定](component-routing.md#导入来源判定)选择 MCP、匹配版本的本地资料或源码，不因生成代码就预读完整 `llms-full.txt`。

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

@@ -15,7 +15,7 @@
 | 条件构建 | `YConditionBuilder` | YSS domain component | required | 标准模型与校验边界见 `specialized-components.md` |
 | 月历 | `YMonthCalendar` | YSS domain component | required | 日期、月份、高度与事件边界见 `specialized-components.md` |
 | Cron | `YCron` | YSS domain component | required | 七段表达式边界见 `specialized-components.md` |
-| 图表 | `YssEcharts` | ECharts | required | 主题、更新和尺寸边界见 `specialized-components.md` |
+| 图表 | `YEcharts` | ECharts | required | 主题、更新和尺寸边界见 `specialized-components.md` |
 | 编辑器 | `YMonaco` / `YMonacoDiff` | Monaco | required | 按需加载和尺寸治理见 `specialized-components.md` |
 | Sheet | `YSheet` | Univer | required | Facade、释放和依赖边界见 `specialized-components.md` |
 | 输入、选择、日期 | 无独立通用 Wrapper | AntDV Input/Select/DatePicker 等 | fallback | 读取实际 AntDV 版本；服从 theme/locale/popup 规则 |
@@ -23,6 +23,8 @@
 | 服务式反馈 | 无统一 Wrapper | message/notification | fallback | 检查 App/ConfigProvider 上下文 |
 | 布局与导航 | 按项目现状 | AntDV Layout/Grid/Menu/Tabs 等 | fallback | 不复制 React Ant Design v6 API |
 
+图表名称按本地快照的 [Vue Demo 导入](../assets/demos/echarts/line.vue) 使用 `YEcharts`；文档标题中的旧名称不作为导出依据。目标工程仍须按 lockfile、类型和真实导出核验。
+
 ## 受控回退
 
 YSS `required` wrapper 缺少必要能力时，记录组件、能力缺口、依赖版本、替代方案、主题/locale/浮层影响和验证证据。没有记录不得回退。

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

@@ -1,280 +1,25 @@
-# yss-ui Quick Recipes
+# YSS UI 场景与示例入口
 
-## 使用说明
+新建页面时，按当前任务选择下面的示例；重构时依次核对列与插槽、请求与分页、路由和交付证据。示例用于说明组件组合，不决定业务字段、接口包装或实现资格。先消费批准合同、目标 lockfile、类型和真实导出；本地快照与目标版本不同的部分需重新核验。
 
-- 当任务是“新建页面”时，优先选用最接近的模板再改字段与交互。
-- 当任务是“重构页面”时，按“列定义 -> 插槽 -> 请求 -> 分页 -> 路由”顺序迁移。
-- 模板默认基于 Vue 3 + TypeScript + `@yss-ui/components`。
-- 组件与 Demo 先对照 `../assets/reference-index.md` 和 `../assets/demos/*` 再编码。
+## 专项技能的可用性
 
----
+下表链接的公共路由、API 资料和 Demo 随公开包提供；`ytable-usage`、`ytree-usage`、`formily-*`、`file-export-download`、`theme-token-usage` 专项不随该包附带。任务命中时仍加载消费工程已安装的对应专项，由原专项持有唯一规则；部分组件资料、Demo 或 Blob 响应说明不能替代完整专项与批准合同。
 
-## 组件样例速查（docs 对照）
+必要专项未安装或不可读时，停止受影响的实现，记录缺失 Skill 与来源；从消费工程已登记的技能来源恢复，核验版本与项目基线一致并重新读取后再继续。只读诊断可以使用随包资料确认组件事实，不据此跳过必需专项或批准输入。分步场景仍由 `formily-step-flow` 决定，不以快照中的 FormStep Demo 替代其方案。
 
-- 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/*`
+## 按场景读取
 
----
+| 当前任务 | 按需读取 | 必须保留的场景差异 |
+|---|---|---|
+| 列表管理：选择、分页、状态和操作 | [YTable 组件 API](../assets/docs/components/table.md) 与 [列表请求及分页](../../yss-hook/references/list-pagination.md)；选择和批量操作由已加载的 `ytable-usage` 核对 | `pageable`、`pagination.remote` 和 `@page-change` 单对象 `{ current, pageSize }`；危险操作确认与成功后选择态清理 |
+| 待办审批：列表与详情抽屉 | [业务页面生成](../../yss-ui-business-page-generation/SKILL.md) 与 [模式及插槽路由](../../yss-formily/SKILL.md)，按命中条件加载 `formily-mode-slot-detail` | 抽屉打开前准备记录，关闭时清理临时状态；同意、拒绝等行为消费冻结规则与当前权限 |
+| 分步创建与步骤中的节点列表 | [分步场景路由](../../yss-formily/SKILL.md)加载 `formily-step-flow`；节点列表再按已安装的 YTable 专项 | 当前步骤校验成功才前进，前序数据跨步骤保留，编辑弹层保存后回填源数据，确认步骤不另造提交数据源 |
+| 列表请求与 Mock 接入 | [API 集成](../../yss-api-integration/SKILL.md) 与 [列表分页 Hook](../../yss-hook/references/list-pagination.md) | 请求、响应与 Mock 均遵循目标冻结 DTO，分页字段在 Hook 边界映射；不固定 `page`、`data.list` 或响应包装 |
+| 左树右表 | [YTree 组件 API](../assets/docs/components/tree.md) 与 [页面组合](../../yss-ui-business-page-generation/references/page-composition-example.md)；树与删除确认由已加载的 `ytree-usage` 核对 | `YSplitPane + YCard + YTree + YTable`，树选中后右表回第一页，高度偏移只扣实际启用区域 |
+| 同一表单新增、编辑与查看 | [三态与插槽路由](../../yss-formily/SKILL.md)加载 `formily-mode-slot-detail` | 新代码使用 `YFormily`；历史 `YssFormily` 只在真实兼容导出已确认时维护；详情路径与编辑 Slot 分开 |
+| 文件导入两步流 | [YFileImport 边界](specialized-components.md#yfileimport) 与 [导入 Demo](../assets/demos/file-import/basic.vue) | 文件选择 / 结果确认、`nextStep` / `finalImport` / `exportErrorData`；下载失败数据时先加载已安装的 `file-export-download`，响应边界另核对 [API 集成](../../yss-api-integration/SKILL.md)的 Blob 契约 |
 
-## 模板 1：列表管理页（带勾选、分页、状态、操作）
+完整组件与 Demo 入口见 [场景索引](../assets/scenario-index.md)和[文档索引](../assets/reference-index.md)。仅加载当前使用的表格、编辑表格、Formily、树、分栏、Monaco、图表、文件导入、条件构建、Cron、Card 或 Button；不预读所有示例。
 
-```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` 示例模式
+样例中的视觉表达消费 [设计系统](../../yss-design-system/SKILL.md)和[主题、Locale 与浮层基线](theme-locale-overlay.md)；涉及 Token 实现与换肤时仍加载已安装的 `theme-token-usage`，由原专项决定规则。错误提示服从项目 mutator，操作失败不能继续执行成功动作。页面验收保留当前 Slice 的 `frontend_implementation_plan` / `frontend_implementation_verification`，以及所需截图、交互、console warning 和实际 `pnpm` 退出码。

package/template/.cursor/skills/yss-ui/references/specialized-components.md

@@ -13,7 +13,7 @@
 - 根值是 `ConditionGroup`；叶子保持字段、操作符和值的标准模型。接口 DSL 的序列化、恢复与错误兜底放入 Hook。
 - 字段切换需要动态操作符或候选值时使用组件公开的加载入口；提交前执行公开校验。
 - 默认严格校验，只有明确允许未完成草稿时才关闭；展示态使用 `disabled`，不使用已废弃的 `readonly`。
-- 组件资料见 `../assets/component-docs/condition-builder-*`，实现前仍须核对目标项目安装版本。
+- 组件资料见 [条件构建器快照](../assets/docs/components/conditionBuilder.md)，实现前仍须核对目标项目安装版本。
 
 ## YMonthCalendar
 
@@ -27,7 +27,7 @@
 - 文件选择、预检、结果回显和最终确认组成两步流程；业务上传与校验由 `nextStep` / `finalImport` 接入。
 - 默认 `beforeUpload=false`，不能期待 `action` 自动上传；直传只通过 `upload-props.customRequest`。
 - `importResult` 展示结果，失败数据通过 `exportErrorData` 下载。弹窗配置与上传器配置保持分离。
-- 组件资料见 `../assets/component-docs/file-import-*`。
+- 组件资料见 [文件导入快照](../assets/docs/components/fileImport.md)。
 
 ## YMonaco / YMonacoDiff
 
@@ -46,7 +46,7 @@
 - 初始化后只通过公开 Facade API 修改工作簿，并通过公开保存入口取值；不得直接修改工作簿原始数据对象。
 - 卸载时释放实例，接入前确认 Univer、React、RxJS 等可选依赖及包体影响。
 
-## YssEcharts
+## YEcharts
 
 - option、更新策略和容器尺寸以目标版本手册与项目已验证实践为准。
 - 不在页面层重复原生 ECharts 初始化、销毁或 ResizeObserver 管理。

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

@@ -87,7 +87,7 @@ description: "生成或改造完整 YSS UI CRUD、列表、表单、详情或左
 ## 交付检查清单
 
 - [ ] 已优先复用 `@yss-ui/components`、`@yss-ui/hooks`、`@yss-ui/utils`。
-- [ ] `index.vue` 不超过 150 行，业务逻辑、常量、列配置和样式已按职责拆分。
+- [ ] `index.vue` 负责 Hook 组合、视图编排和事件转发；业务逻辑、常量、列配置和样式已按职责拆分。
 - [ ] 未出现未导出的 Y 前缀组件。
 - [ ] 未导入 `@formily/antd-v3`、`@formily/antd` 或业务层 `@formily/antdv` UI 组件。
 - [ ] `YTable` 分页字段为 `current/pageSize/total`。

package/template/.cursor/skills/yss-up-springboot3/SKILL.md

@@ -5,15 +5,13 @@ description: "审查或迁移 YSS Spring Boot 2 到 3 的依赖、Jakarta 与 Sp
 
 # yss-up-springboot3
 
-Use this skill for catalog-driven YSS backend upgrade analysis and approved migrations from an exact Spring Boot 2 platform to an exact Spring Boot 3 platform.
+本 Skill 从精确 Spring Boot 2 平台分析并执行已批准的 Spring Boot 3 迁移，不替代具体组件 Skill。源平台、目标平台和组件能力只从 `.template-spec/engineering/backend-platforms.json`、批准的 `platform_configuration`、工程 Manifest、effective POM 与实际依赖树解析，不按版本记忆或源码可编译状态推断兼容。
 
-中文说明：这个技能是平台迁移编排入口，不替代具体组件 Skill。源平台、目标平台和组件能力只从 `.template-spec/engineering/backend-platforms.json`、批准的 `platform_configuration`、工程 Manifest、effective POM 与实际依赖树解析，不按版本记忆或源码可编译状态推断兼容。
+## 何时使用
 
-## When To Use
-
-- The user asks to assess or migrate a YSS backend from Spring Boot 2 to Spring Boot 3.
-- 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.
+- 评估或迁移 YSS 后端的 Spring Boot 2 → 3 平台。
+- 平台迁移涉及 `javax.*` → `jakarta.*`、Spring Security、Validation、Servlet、Gateway/OpenFeign 或依赖 BOM。
+- 核验 YSS 组件在指定 Spring Boot 3 平台的兼容状态。
 
 ## 准入与阻断
 
@@ -22,7 +20,7 @@ Use this skill for catalog-driven YSS backend upgrade analysis and approved migr
 - 既有工程的源码编译、单元测试或 `javax`→`jakarta` 替换不等于平台认证。没有目标架构的真实构件、启动和组件 seam 证据时不得宣称迁移完成。
 - 平台迁移不得夹带业务重构、架构族转换或组件替换。发现这些影响时返回 `new_impacts`，交实现合同编译器重新路由。
 
-## Workflow
+## 迁移流程
 
 1. 从工程登记、Manifest、父/BOM、effective POM 和依赖树冻结源 `platform_configuration`、架构 Profile、全部 YSS GAV、组件绑定及基线验证命令；缺失或相互冲突时停止。
 2. 从平台目录选择一个精确 Spring Boot 3 目标 profile，记录 compatibility id/digest；不得使用 `3.x`、`latest`、范围版本或自行拼装父/BOM。
@@ -33,22 +31,22 @@ Use this skill for catalog-driven YSS backend upgrade analysis and approved migr
 7. 使用工程根 `./mvnw` 记录 effective POM、依赖树、`validate`、`test`、`package`、随机端口启动和真实组件 seam；DDD 与 MVC 证据不可互相代替。
 8. 重新解析全部组件绑定并比较摘要；通过只表示该工程的批准迁移结果，不自动把共享平台或其他工程标记为 verified。
 
-## 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.
+- 改代码前核对 Maven BOM 与插件版本。
+- 仅目标框架要求 Jakarta 的 API 迁移 `javax.*` import。
+- Spring Security 配置不依赖已移除的 `WebSecurityConfigurerAdapter` 模式。
+- Validation 注解与异常处理仍映射到冻结 DTO/Result 合同。
+- MyBatis 拦截器、自动配置与 starter metadata 符合目标 Boot 3 装载机制。
+- 受影响测试或样例模块与框架代码同步。
 - Jackson 2 的 Result/PageResult、日期、枚举、nullability 和错误响应 wire fixture 与冻结 OpenAPI 一致。
 - `spring.factories` 与 `AutoConfiguration.imports` 的目标机制以真实 starter 为准，不能仅移动文件名后宣称自动配置生效。
 - 输出包含源/目标 profile、compatibility digest、组件逐项结论、阻塞项、实际命令与回滚点。
 
-## 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.
-- Do not bypass a blocked component by excluding its starter, copying component code into the service, or substituting an unapproved third-party dependency.
-- Do not execute a Boot 4 migration under this Skill or reuse Boot 3 evidence for Boot 4.
+- 先核验依赖实际命名空间，不批量替换全部 `javax.*`。
+- 迁移不夹带无关业务重构。
+- 组件兼容结论使用源码、专项索引和平台证据，不使用版本记忆。
+- 不能通过排除 starter、复制组件源码到服务或换未批准第三方依赖绕过组件阻断。
+- Boot 4 另行路由，不复用 Boot 3 证据执行其迁移。