create-yss-spec 3.4.6 → 3.4.8

package/template/.cursor/skills/yss-mvc-data-analysis-project-initializer/scripts/generate_project.mjs

@@ -1,18 +0,0 @@
-#!/usr/bin/env node
-import process from "node:process";
-import { fileURLToPath } from "node:url";
-
-export function deprecatedInitializerError() {
-  const error = new Error("skill-deprecated: yss-mvc-data-analysis-project-initializer 已由 yss-layered-mvc-scaffold-generator 的 mvc-data-analysis-v1 Profile 替代；旧合同必须标记 stale 并重新编译");
-  error.code = "skill-deprecated";
-  return error;
-}
-
-export async function initialize() {
-  throw deprecatedInitializerError();
-}
-
-if (process.argv[1] === fileURLToPath(import.meta.url)) {
-  process.stderr.write(`${deprecatedInitializerError().message}\n`);
-  process.exitCode = 1;
-}

package/template/.cursor/skills/yss-mvc-data-analysis-project-initializer/scripts/run_scaffold_verification.mjs

@@ -1,9 +0,0 @@
-#!/usr/bin/env node
-import { run } from "../../yss-ddd-scaffold-generator/scripts/run_scaffold_verification.mjs";
-try {
-  const [projectRoot, evidenceDir] = process.argv.slice(2);
-  if (!projectRoot || !evidenceDir) throw new Error("用法: run_scaffold_verification.mjs <project-root> <evidence-dir>");
-  const report = await run(projectRoot, evidenceDir);
-  process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
-  process.exitCode = report.status === "passed" ? 0 : 1;
-} catch (error) { process.stderr.write(`${error.message}\n`); process.exitCode = 1; }

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

@@ -1,12 +0,0 @@
----
-name: yss-mvc-design
-description: 迁移历史 yss-mvc-design 引用到 yss-technical-design；不再承接新的 MVC 技术设计。
----
-
-# YSS MVC 技术设计（Deprecated）
-
-本入口处于 `migration-only`。新的 MVC 技术设计统一使用 `yss-technical-design`；本入口不再拥有 capability、Recipe、typed dependency 或设计批准责任，也不得进入新的 Technical Design 或 Slice Contract。
-
-发现旧合同、任务包或调用方引用本 ID 时，返回 `skill-deprecated`，报告替代入口 `yss-technical-design`，并把旧合同标记为 `stale` 后重新编译。不得静默替换 Skill、继承旧批准或自动设置 `ready-for-agent`。
-
-`references/mvc-design.schema.json` 在退役期保持只读，仅用于与 `yss-technical-design/references/mvc-design.schema.json` 做语义等价检查。新合同不得引用本目录。迁移关系由 `docs/agents/skill-migrations.md` 记录；硬退役后不保留 alias。

package/template/.cursor/skills/yss-mvc-design/agents/openai.yaml

@@ -1,4 +0,0 @@
-interface:
-  display_name: "YSS MVC 技术设计迁移"
-  short_description: "迁移已退役的 MVC 设计入口"
-  default_prompt: "返回 skill-deprecated，并将历史 yss-mvc-design 引用迁移到 yss-technical-design；不得继承旧批准。"

package/template/.cursor/skills/yss-mvc-design/references/mvc-design.schema.json

@@ -1,315 +0,0 @@
-{
-  "type": "object",
-  "properties": {
-    "module_catalog": {
-      "type": "array",
-      "minItems": 1,
-      "items": {
-        "type": "object",
-        "properties": {
-          "module_id": {
-            "type": "string",
-            "minLength": 1
-          },
-          "responsibility": {
-            "type": "string",
-            "minLength": 1
-          },
-          "layer": {
-            "enum": [
-              "server",
-              "service",
-              "core",
-              "repository",
-              "adapter",
-              "client",
-              "feign-client"
-            ]
-          },
-          "depends_on": {
-            "type": "array",
-            "items": {
-              "type": "string",
-              "minLength": 1
-            },
-            "uniqueItems": true
-          }
-        },
-        "required": [
-          "module_id",
-          "responsibility",
-          "layer",
-          "depends_on"
-        ],
-        "additionalProperties": false
-      }
-    },
-    "use_case_catalog": {
-      "type": "array",
-      "minItems": 1,
-      "items": {
-        "type": "object",
-        "properties": {
-          "use_case_id": {
-            "type": "string",
-            "minLength": 1
-          },
-          "module_ref": {
-            "type": "string",
-            "minLength": 1
-          },
-          "flow": {
-            "type": "array",
-            "items": {
-              "type": "string",
-              "minLength": 1
-            },
-            "uniqueItems": true,
-            "minItems": 1
-          },
-          "rule_refs": {
-            "type": "array",
-            "items": {
-              "type": "string",
-              "minLength": 1
-            },
-            "uniqueItems": true,
-            "minItems": 1
-          },
-          "failure_handling": {
-            "type": "string",
-            "minLength": 1
-          }
-        },
-        "required": [
-          "use_case_id",
-          "module_ref",
-          "flow",
-          "rule_refs",
-          "failure_handling"
-        ],
-        "additionalProperties": false
-      }
-    },
-    "rule_catalog": {
-      "type": "array",
-      "minItems": 1,
-      "items": {
-        "type": "object",
-        "properties": {
-          "rule_id": {
-            "type": "string",
-            "minLength": 1
-          },
-          "statement": {
-            "type": "string",
-            "minLength": 1
-          },
-          "use_case_refs": {
-            "type": "array",
-            "items": {
-              "type": "string",
-              "minLength": 1
-            },
-            "uniqueItems": true,
-            "minItems": 1
-          }
-        },
-        "required": [
-          "rule_id",
-          "statement",
-          "use_case_refs"
-        ],
-        "additionalProperties": false
-      }
-    },
-    "state_transition_catalog": {
-      "type": "array",
-      "minItems": 0,
-      "items": {
-        "type": "object",
-        "properties": {
-          "transition_id": {
-            "type": "string",
-            "minLength": 1
-          },
-          "use_case_ref": {
-            "type": "string",
-            "minLength": 1
-          },
-          "from": {
-            "type": "string",
-            "minLength": 1
-          },
-          "to": {
-            "type": "string",
-            "minLength": 1
-          },
-          "guard": {
-            "type": "string",
-            "minLength": 1
-          }
-        },
-        "required": [
-          "transition_id",
-          "use_case_ref",
-          "from",
-          "to",
-          "guard"
-        ],
-        "additionalProperties": false
-      }
-    },
-    "state_not_applicable_reason": {
-      "type": "string"
-    },
-    "consistency_policy": {
-      "type": "object",
-      "properties": {
-        "transaction_boundary": {
-          "type": "string",
-          "minLength": 1
-        },
-        "rollback": {
-          "type": "string",
-          "minLength": 1
-        },
-        "concurrency": {
-          "type": "string",
-          "minLength": 1
-        },
-        "idempotency": {
-          "type": "string",
-          "minLength": 1
-        }
-      },
-      "required": [
-        "transaction_boundary",
-        "rollback",
-        "concurrency",
-        "idempotency"
-      ],
-      "additionalProperties": false
-    },
-    "persistence_mapping": {
-      "type": "array",
-      "minItems": 1,
-      "items": {
-        "type": "object",
-        "properties": {
-          "mapping_id": {
-            "type": "string",
-            "minLength": 1
-          },
-          "use_case_ref": {
-            "type": "string",
-            "minLength": 1
-          },
-          "repository_ref": {
-            "type": "string",
-            "minLength": 1
-          },
-          "storage_model": {
-            "type": "string",
-            "minLength": 1
-          },
-          "notes": {
-            "type": "string",
-            "minLength": 1
-          }
-        },
-        "required": [
-          "mapping_id",
-          "use_case_ref",
-          "repository_ref",
-          "storage_model",
-          "notes"
-        ],
-        "additionalProperties": false
-      }
-    },
-    "integration_catalog": {
-      "type": "array",
-      "minItems": 0,
-      "items": {
-        "type": "object",
-        "properties": {
-          "integration_id": {
-            "type": "string",
-            "minLength": 1
-          },
-          "adapter_ref": {
-            "type": "string",
-            "minLength": 1
-          },
-          "capability": {
-            "type": "string",
-            "minLength": 1
-          },
-          "failure_handling": {
-            "type": "string",
-            "minLength": 1
-          }
-        },
-        "required": [
-          "integration_id",
-          "adapter_ref",
-          "capability",
-          "failure_handling"
-        ],
-        "additionalProperties": false
-      }
-    },
-    "integration_not_applicable_reason": {
-      "type": "string"
-    },
-    "test_seams": {
-      "type": "array",
-      "minItems": 1,
-      "items": {
-        "type": "object",
-        "properties": {
-          "seam_id": {
-            "type": "string",
-            "minLength": 1
-          },
-          "kind": {
-            "type": "string",
-            "minLength": 1
-          },
-          "subject_ref": {
-            "type": "string",
-            "minLength": 1
-          },
-          "assertion": {
-            "type": "string",
-            "minLength": 1
-          }
-        },
-        "required": [
-          "seam_id",
-          "kind",
-          "subject_ref",
-          "assertion"
-        ],
-        "additionalProperties": false
-      }
-    }
-  },
-  "required": [
-    "module_catalog",
-    "use_case_catalog",
-    "rule_catalog",
-    "state_transition_catalog",
-    "state_not_applicable_reason",
-    "consistency_policy",
-    "persistence_mapping",
-    "integration_catalog",
-    "integration_not_applicable_reason",
-    "test_seams"
-  ],
-  "additionalProperties": false,
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://yss.dev/schemas/mvc-design-v1.json",
-  "title": "YSS MVC 技术设计内容"
-}

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

@@ -1,130 +0,0 @@
----
-name: yss-use-table-height
-description: "用 useTableHeight 修复 YTable、YEditTable 自适应高度、双滚动条及分页或工具栏偏移。"
----
-
-# useTableHeight 使用
-
-## 触发条件
-
-- YTable/YEditTable 需要自适应滚动高度，或页面出现双滚动条、底部空白和容器撑开闪烁。
-- 表格内含分页、工具栏、添加按钮，或位于弹窗/抽屉/shrink-wrap 容器内。
-
-## 不适用场景
-
-- 纯短表且页面不需要独立滚动区。
-- 当前布局组件已完整托管表格高度，且没有内部偏移需要扣减。
-
-## 实施流程
-
-1. MCP 可用时，先用 `get_component_docs` 精确查询 `useTableHeight`，需要示例时再调用 `get_demo`；不要仅凭 Skill 中的静态签名推断当前 API。
-2. 精确查询无结果时，先用 `search_docs` 校正名称；仅在 MCP 不可用、调用失败或仍无结果时，回退读取最新 `llms-full.txt`。文档版本与当前依赖不一致时，再核对 Hook 源码、CodeGraph 和真实导出。
-3. 先确认容器是稳定 flex 区域还是被表格内容撑开的 shrink-wrap 区域。
-4. 盘点表格内部实际开启的分页、工具栏、YEditTable 添加按钮和额外 padding。
-5. 把受约束的容器 `ref` 传给 Hook，将 `tableHeight` 绑定到表格 `height`。
-6. 在弹窗/抽屉动画结束或布局切换后视情况调用 `recalculateHeight()` 验证最终高度。
-
-## 硬约束（禁止/必须）
-
-- 使用真实签名 `useTableHeight(tableAreaRef, options)` 和真实返回值 `tableHeight/isReady/recalculateHeight`。
-- `tableAreaRef` 支持原生 DOM 或 Vue 组件实例（如 `YCard`）。绑定 DOM 时使用表格的直接父容器；绑定 Card 时 Hook 会尝试获取 `.ant-card-body`。
-- 稳定布局使用“外层可计算高度 + flex column，表格区 `flex: 1; min-height: 0; overflow: hidden`”。禁止用大常量高度替代 Hook。
-- YTable 开启 `pageable` 时设置 `withPagination: true`；开启 `toolbarConfig.custom` 或工具栏插槽时设置 `withToolbar: true`；YEditTable 显示 `addable` 按钮时设置 `withAddButton: true`。
-- 默认偏移常量分别是分页 48px、工具栏 48px、添加按钮 40px；只在实际样式不同时使用 `paginationHeight/toolbarHeight/addButtonHeight` 覆盖。
-- 把结果绑定到 `YTable/YEditTable` 的 `:height="tableHeight"`，不只设置 `max-height`。
-- 直属容器由表格内容撑开时，不要观察该容器形成“子元素改变父高度、父高度又改变子元素”循环；传入更外层稳定容器 `boundaryRef`，并用 `extraOffset` 扣除边界内其他区域。
-- Hook 已用 `ResizeObserver` 监听容器尺寸。不强制为每个弹窗/抽屉写 watch；只在动画或隐藏初始化导致高度不准时，于可见后 `nextTick(recalculateHeight)`。
-
-## 标准代码骨架
-
-```vue
-<script setup lang="ts">
-import { ref } from 'vue';
-import { YTable, type YTableColumn } from '@yss-ui/components';
-import { useTableHeight } from '@yss-ui/hooks';
-
-const tableAreaRef = ref<HTMLDivElement>();
-const dataList = ref<Array<{ id: string; name: string }>>([]);
-const columns: YTableColumn[] = [
-  { type: 'seq', title: '序号', width: 70 },
-  { field: 'name', title: '名称', minWidth: 180 },
-];
-const { tableHeight, isReady, recalculateHeight } = useTableHeight(tableAreaRef, {
-  withPagination: true,
-  withToolbar: true,
-});
-</script>
-
-<template>
-  <div class="page">
-    <div ref="tableAreaRef" class="table-area">
-      <YTable
-        v-if="isReady"
-        :height="tableHeight"
-        :data="dataList"
-        :columns="columns"
-        :toolbar-config="{ custom: true }"
-        pageable
-      />
-    </div>
-  </div>
-</template>
-
-<style scoped lang="less">
-@import './style.less';
-</style>
-```
-
-```less
-/* style.less */
-.page {
-  height: 100%;
-  display: flex;
-  flex-direction: column;
-}
-
-.table-area {
-  flex: 1;
-  min-height: 0;
-  overflow: hidden;
-}
-```
-
-## shrink-wrap 容器
-
-```typescript
-const tableAreaRef = ref<HTMLDivElement>();
-const boundaryRef = ref<HTMLDivElement>();
-
-const { tableHeight } = useTableHeight(tableAreaRef, {
-  boundaryRef,
-});
-```
-
-`extraOffset` 必须来自可说明的实际布局占位；如果区域高度会变，优先改成稳定 flex 布局，不固定一个近似大数。
-
-## 弹层可见后补算
-
-```typescript
-import { nextTick } from 'vue';
-
-/** 弹层完全展开后重算表格高度。 */
-const handleAfterOpenChange = async (open: boolean) => {
-  if (!open) return;
-  await nextTick();
-  recalculateHeight();
-};
-```
-
-## 交付检查清单
-
-- [ ] 观察容器具有稳定高度，需要时已使用 `boundaryRef`。
-- [ ] 分页、工具栏、添加按钮的偏移与实际开关一致，未重复扣减。
-- [ ] 表格绑定 `height`，容器有 `min-height: 0`，无双滚动条和底部大空白。
-- [ ] 只在实际出现隐藏态/动画时机问题时手动调用 `recalculateHeight()`。
-
-## 失败兜底策略
-
-- 高度持续闪烁时，检查被观察容器是否由表格内容撑开；是则使用稳定 `boundaryRef` 或改为 flex 布局。
-- 底部空白或内容被遮挡时，逐项核对 `withPagination/withToolbar/withAddButton` 与实际开关，不反复调大 `extraOffset`。
-- 弹层首次打开高度不准时，在可见或动画结束后 `nextTick(recalculateHeight)`；正常 ResizeObserver 已生效时不增加重复 watch。

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

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

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

@@ -1,9 +0,0 @@
-# yss-use-table-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/.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.