@deppon/deppon-skills 2.4.12

package/README.md

@@ -0,0 +1,49 @@
+# `@deppon/deppon-skills`
+
+本仓库维护的 **Cursor Agent Skills**（`SKILL.md` 集合），用于对齐 `@deppon/deppon-template`、`@deppon/deppon-ui` 等私有 npm 包的前端生成与 PRD 流程。
+
+## 与 Cursor 的关系
+
+- Cursor 会从**项目目录下的** `.cursor/skills/<name>/SKILL.md` 加载技能。
+- **不会**自动从 `node_modules` 读 skill，因此安装本 npm 包后需要执行一次**安装脚本**（见下文）。
+
+## 发布（维护方）
+
+在 `deppon-npm` 根目录维护 `.cursor/skills/`；`npm pack` / `npm publish` 前会通过 `prepack` → `npm run build` 将其中内容复制到包内 **`dist/`**：
+
+```bash
+cd packages/deppon-skills
+npm run build         # 可选手动执行；prepack 会再次执行
+npm pack
+npm run publish:auto  # 等同 npm publish，需已登录 publishConfig 中的私有 registry
+```
+
+版本可与 monorepo 一起做 lerna 发布，或单独改本包 `version` 后 `npm run publish:auto`。
+
+## 使用（消费方）
+
+1. 安装：
+
+```bash
+npm install @deppon/deppon-skills -D
+```
+
+2. 将包内 **`dist/`** 下各 skill 目录复制到当前项目：
+
+```bash
+npx deppon-skills-install
+```
+
+会在当前目录创建/覆盖 `.cursor/skills/*`。
+
+3. 用 Cursor 打开该项目即可。业务运行时仍需安装 `@deppon/deppon-template` 等，参见 skill `deppon-npm-private-registry`。
+
+## 更新
+
+升级 `@deppon/deppon-skills` 后重新执行：
+
+```bash
+npx deppon-skills-install
+```
+
+若在 monorepo 内直接维护 `.cursor/skills` 而不通过 npm，则无需安装本包。

package/dist/deppon-npm-prd/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: deppon-npm-prd
+description: >-
+    根据业务描述输出可评审的产品 PRD（背景、范围、用户与场景、功能需求、非功能、验收标准、风险），
+    并给出与私有 npm 包 @deppon/* 及 Cursor skills 对齐的「原型实现蓝图」（页面类型、专项 skill、
+    主要依赖包）。在用户要 PRD、deppon-npm-prd、产品需求文档、需求说明书、产品原型、功能规格、
+    BRD/PRD、评审材料 或 从想法到可开发说明 时应用。
+---
+
+# deppon-npm-prd：PRD + 可落地原型蓝图
+
+## 与其它 skill 的配合
+
+-   **选型总索引**：实现侧对照用 **`deppon-npm-skills`**（场景 → skill → `@deppon/*`），外仓先读 **`deppon-npm-private-registry`**。
+-   **落地编码**：PRD 定稿后按专项 skill 生成或修改 Vue 页面；本 skill **不负责直接写大量业务代码**，负责 **结构化需求 + 对齐 npm 包与技能体系**。
+
+## 信息不足时的处理
+
+先用简短追问补齐（可列表形式），缺失则标注「待产品确认」：
+
+-   目标用户 / 角色、核心使用场景、成功指标（可选）
+-   必须做 / 不做（范围边界）、里程碑或上线时间约束（可选）
+-   关键名词、状态机、与现有系统的关系（登录态、权限、数据来源）
+
+用户明确要求「先出一版草稿」时，可用合理假设并在文中用 **「假设：…」** 标出。
+
+## PRD 输出结构（按顺序输出）
+
+使用 Markdown 标题，保持可粘贴到飞书/Confluence/Notion：
+
+1. **文档信息**：产品/模块名称、版本或草案日期、作者占位、关联需求单号（若有）
+2. **背景与目标**：要解决什么问题、不做会怎样、可衡量的目标（如有数据再说）
+3. **范围**：In Scope / Out of Scope（列表）
+4. **用户与场景**：角色表；每个场景 触发条件 → 主流程 → 异常分支（表格或编号步骤）
+5. **功能需求**：按模块编号 **FR-001…**，每条含：描述、输入输出、业务规则、与其它模块边界、错误与空态
+6. **界面与交互（原型级）**：页面/弹窗清单；每页：布局要点、主操作、校验提示、权限/只读（若有）
+7. **数据与接口（初稿）**：核心实体字段表（字段名、类型、含义、必填、备注）；接口 **若未知** 写「待接口文档」并列举需提供的 API 能力
+8. **非功能需求**（可选）：性能、兼容性、埋点、审计、国际化
+9. **验收标准**：每条 FR 或每场景对应 **可测试** 的 Given-When-Then 或检查清单
+10. **依赖与风险**：跨团队依赖、技术风险、开放问题（Open Questions）
+
+## 「原型实现蓝图」小节（必含）
+
+在 PRD 末尾增加固定小节 **`## 原型实现蓝图（deppon-npm）`**，与 **`deppon-npm-skills`** 中的场景表一致：
+
+| 建议页面/能力                   | 推荐专项 skill              | 主要 npm 包（以项目实际安装为准）                                                                    |
+| ------------------------------- | --------------------------- | ---------------------------------------------------------------------------------------------------- |
+| 由 Agent 根据 FR 表**逐行填写** | 从 `deppon-npm-skills` 选取 | `@deppon/deppon-template` / `@deppon/deppon-ui` / `@deppon/deppon-router` / `@deppon/deppon-request` |
+
+补充说明（skill 名速查，细节见各专项 skill 与包内 `.d.ts`）：
+
+-   多表单分块 / 锚点 / 统一提交 → `deppon-pro-form-group`
+-   列表 + 内置搜索 + 工具栏 → `deppon-pro-table`；tab 内多表组合 → `deppon-pro-table-advanced-tabs`
+-   上查询条 + 下表格 + 底部编辑区 → `deppon-pro-page-crud`
+-   弹窗表单 → `deppon-pro-dialog` + `deppon-pro-form`
+-   多产品 × 线路多表单 → `deppon-product-route-multi-form` / `deppon-pro-form-performance`
+-   行编辑 / 单元格编辑表 → `deppon-pro-table-row-edit` / `deppon-pro-table-cell-editable`
+-   路由与页签 → `deppon-router-push-viewtab`；请求封装 → `deppon-request-package-demo`
+
+## 写作原则
+
+-   **可开发**：研发能据 FR 与蓝图拆任务；避免纯形容词需求。
+-   **可追溯**：需求编号在验收标准中可回指。
+-   **包名真实**：只使用团队已发布的 `@deppon/*` 名称；具体 API 以消费者 **`node_modules`** 内文档与类型为准。
+
+## 交付自检
+
+-   [ ] 范围边界清晰，开放问题已列出
+-   [ ] 每条核心 FR 有对应验收项
+-   [ ] 「原型实现蓝图」表覆盖主要页面，且 skill/npm 映射能在 `deppon-npm-skills` 中找到对应行

package/dist/deppon-npm-private-registry/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: deppon-npm-private-registry
+description: >-
+    在使用 deppon 系列 Cursor skills 生成代码前，说明如何通过团队私有 npm 安装 @deppon/* 包、以包内
+    README 与类型定义为权威依据（而非依赖 deppon-npm  monorepo 的 site 示例）。在用户分发 skill、
+    外仓接入、私有 registry、.npmrc、@deppon 安装 时应用。
+---
+
+# deppon 私有 npm 接入（skills 分发前提）
+
+## 结论
+
+**可以**：把 `.cursor/skills/` 复制给任意 Vue 3 工程；对方只要从**同一私有源**安装约定的 `@deppon/*` 包，skills 中的模式即可落地。  
+**不要求**对方克隆 `deppon-npm` 或存在 `site/src/views/examples`。
+
+## 安装与源
+
+-   使用团队提供的 **registry 与认证方式**（`~/.npmrc` 或项目级 `.npmrc`：**勿把 token 写进 skill 或提交仓库**）。
+-   常见包（以实际发布名为准）：
+    -   `@deppon/deppon-template` — `ProForm`、`ProTable`、`ProLayout`、`ProDialog`、`ProField` 等
+    -   `@deppon/deppon-ui` — 基础 UI（与 template 联用）
+    -   `@deppon/deppon-router` — 路由与 `depponPush` / viewTab 等
+    -   `@deppon/deppon-request` — HTTP 封装
+    -   `@deppon/deppon-skills` — Cursor Agent Skills（`npm install` 后可用 `deppon-skills-install` 同步到 `.cursor/skills`）
+
+具体版本与 peer 依赖（如 `vue`、样式/less）以**各包在 npm 上声明的 `peerDependencies` 与 README**为准。
+
+## 权威依据（生成代码时读哪里）
+
+按优先级：
+
+1. **`node_modules/@deppon/<包名>/README.md`** 及包内链出的 **`USAGE.md`、`VITE_USAGE.md`**（若 tarball 中包含）。
+2. **`node_modules/@deppon/<包名>/es/**/\*.d.ts`\*\*（或包文档指明的 typings 目录）— props、事件、导出组件名。
+3. 团队内部文档 / Storybook（若有 URL，以用户项目配置为准，skill 不硬编码内网地址）。
+
+**不要**默认 `Read` `deppon-npm` 仓库下的 `site/src/views/examples/*.vue`；仅在用户**明确打开该 monorepo** 且要求对齐内部 demo 时再查。
+
+## 给 Skill 分发方的说明
+
+-   专项 skills（如 `deppon-pro-form`）描述的是 **API 用法模式**；细节必须与**消费者已安装的包版本**一致。
+-   若对方包版本落后，可能出现 props 不一致 — 以对方 `node_modules` 内类型为准。
+
+## 自检
+
+-   [ ] 目标项目已能从私有源安装 `@deppon/*` 且构建通过
+-   [ ] 生成/修改代码前已结合 **README + d.ts** 核对组件名与 props

package/dist/deppon-npm-skills/SKILL.md

@@ -0,0 +1,68 @@
+---
+name: deppon-npm-skills
+description: >-
+    deppon 业务前端专项 Cursor skills 的总索引：按场景选用 skill，并映射到私有 npm 包
+    @deppon/deppon-template、@deppon/deppon-ui、@deppon/deppon-router、@deppon/deppon-request。
+    用户提到 deppon-npm-skills、选型、不知用哪个 skill、外仓接入 deppon 时先读本 skill。
+---
+
+# deppon-npm-skills：专项技能索引（npm 为准）
+
+## 前置（外仓必读）
+
+接入与文档来源：**`deppon-npm-private-registry`**（私有 registry、以 `node_modules/@deppon/*` 内 README / `.d.ts` 为权威，**不依赖** `deppon-npm` 的 `site/` 示例路径）。
+
+## 场景 → 专项 skill → 主要 npm 包
+
+| 场景摘要                              | 专项 skill                          | 主要 npm 包                                       |
+| ------------------------------------- | ----------------------------------- | ------------------------------------------------- |
+| ProLayout 壳、侧栏、菜单路由          | `deppon-pro-layout-page`            | `@deppon/deppon-template`                         |
+| 单字段 ProField（非整表）             | `deppon-pro-field`                  | `@deppon/deppon-template`                         |
+| 单页 ProForm、规则、actions           | `deppon-pro-form`                   | `@deppon/deppon-template`，UI `@deppon/deppon-ui` |
+| 多卡片多表单、锚点、统一提交          | `deppon-pro-form-group`             | 同上                                              |
+| 多卡片只读切换、头部自定义按钮        | `deppon-pro-form-advanced-customer` | 同上                                              |
+| 多实例表单性能（可见/缓存/数据分离）  | `deppon-pro-form-performance`       | 同上                                              |
+| 多产品 × 线路组合表单                 | `deppon-product-route-multi-form`   | 同上                                              |
+| 列表搜索、分页、工具栏、插槽列        | `deppon-pro-table`                  | `@deppon/deppon-template`，UI `@deppon/deppon-ui` |
+| 多 Tab 内多套 ProTable                | `deppon-pro-table-advanced-tabs`    | 同上                                              |
+| 多级表头                              | `deppon-pro-table-multi-header`     | 同上                                              |
+| 展开行、嵌套子表                      | `deppon-pro-table-expand-nested`    | 同上                                              |
+| 单元格可编辑表                        | `deppon-pro-table-cell-editable`    | 同上                                              |
+| 行编辑 `row-edit`                     | `deppon-pro-table-row-edit`         | 同上                                              |
+| 非 fixed、自定义表头区、滚动容器      | `deppon-pro-table-nofixed-scroll`   | 同上                                              |
+| 独立查询 Form + Table + 底部编辑 Form | `deppon-pro-page-crud`              | 同上                                              |
+| ProDialog、表单弹窗、自定义 body      | `deppon-pro-dialog`                 | 同上                                              |
+| ElCard / Button / Message 基础用法    | `deppon-ui-examples-primitives`     | `@deppon/deppon-ui`                               |
+| depponPush、viewTab、路由参数         | `deppon-router-push-viewtab`        | `@deppon/deppon-router`，常配合 `vue-router`      |
+| 请求封装与错误结构                    | `deppon-request-package-demo`       | `@deppon/deppon-request`                          |
+| 产品 PRD + 原型实现蓝图（映射到上表） | `deppon-npm-prd`                    | 文档输出；落地时依赖上表包                        |
+
+## 选用专项 Skill（与上表一致，便于 @ 引用）
+
+-   私有 registry 与包文档：`deppon-npm-private-registry`
+-   产品 PRD + 蓝图：`deppon-npm-prd`
+-   表单单页：`deppon-pro-form`
+-   表单分组/多表单：`deppon-pro-form-group`
+-   高级客户类表单：`deppon-pro-form-advanced-customer`
+-   多表单性能：`deppon-pro-form-performance`、`deppon-product-route-multi-form`
+-   列表：`deppon-pro-table`
+-   多级表头：`deppon-pro-table-multi-header`
+-   列表高级 tab：`deppon-pro-table-advanced-tabs`
+-   展开行/子表：`deppon-pro-table-expand-nested`
+-   单元格可编辑：`deppon-pro-table-cell-editable`
+-   行编辑：`deppon-pro-table-row-edit`
+-   非 fixed + 自定义头：`deppon-pro-table-nofixed-scroll`
+-   查询条+表+编辑：`deppon-pro-page-crud`
+-   弹窗：`deppon-pro-dialog`
+-   单字段：`deppon-pro-field`
+-   布局壳：`deppon-pro-layout-page`
+-   路由：`deppon-router-push-viewtab`
+-   请求：`deppon-request-package-demo`
+-   基础 UI：`deppon-ui-examples-primitives`
+
+## Agent 工作方式
+
+0. 外仓或未确认依赖时：先 **`deppon-npm-private-registry`**，再生成代码。
+1. 需求对标：用本表选 **专项 skill**；需要长文档时用 **`deppon-npm-prd`**。
+2. 实现时：**以消费者项目内 `node_modules/@deppon/*` 的 README 与 `*.d.ts` 为准**；不要默认读取 `deppon-npm` 的 `site/src/views/examples`，除非用户当前工作区就是该 monorepo 并明确要求对齐 demo。
+3. `import` 路径与 peer 依赖版本遵守各包 README。

package/dist/deppon-pro-dialog/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: deppon-pro-dialog
+description: >-
+    使用 @deppon/deppon-template 的 ProDialog 生成弹窗（基础、内置 ProForm、自定义 body 插槽）。
+    在用户需要模态框、编辑弹窗、pro-dialog 时应用。
+---
+
+# deppon-pro-dialog：ProDialog（私有 npm）
+
+## 依据来源（私有 npm）
+
+-   **`deppon-npm-private-registry`**。
+-   **`@deppon/deppon-template`**：`ProDialog`、`ProForm` — 插槽名（`#footer`、`#body-content` 等）以包内 `*.d.ts` 为准。
+-   **`@deppon/deppon-ui`**。
+-   **`deppon-npm-skills`**。不默认读取 `deppon-npm` 的 `site/`。
+
+## 导入
+
+```js
+import { ProDialog, ProForm } from '@deppon/deppon-template';
+import { ElButton, ... } from '@deppon/deppon-ui';
+```
+
+## 基础用法
+
+-   `v-model` 绑定 `ref` 布尔值；`title`、`width`；可选 `draggable`。
+-   底部按钮放在 `<template #footer>`。
+
+## 表单弹窗（常见模式）
+
+-   `pro-dialog` 包一层 `pro-form`：`ref`、` :columns`、` :initial-values`、` :rules`、` :label-width`、` :cols`（弹窗内常用 `cols=1`）。
+-   `:close-on-click-modal="false"` 防误触。
+-   `@closed` 里重置表单或清空 `initial-values`。
+-   确定：`handleFormSubmit(dialogFormRef)` 内通过 `dialogFormRef.value` 调用 **`ProForm` 实例** 的校验/取值方法（方法名以类型定义为准）。
+
+## 自定义内容
+
+-   使用 `<template #body-content>` 包裹复杂布局（非默认 slot 时）。
+
+## 组合建议
+
+-   列表页的「新建/编辑」可：父级只切换 `visible` + 传入 `initial-values`；columns 定义见 `deppon-pro-form` skill。

package/dist/deppon-pro-field/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: deppon-pro-field
+description: >-
+    在非 ProForm 场景下单独使用 ProField：valueType、v-model 绑定、read/edit 模式、fieldProps。
+    在用户提到 ProField、单字段组件、与 el-form-item 组合时应用。
+---
+
+# deppon-pro-field
+
+## 依据来源（私有 npm）
+
+-   **`deppon-npm-private-registry`**。
+-   **`@deppon/deppon-template`**：`ProField` — README / `*.d.ts` 中 `value-type`、v-model、 `fieldProps`、 `mode`。
+-   **`@deppon/deppon-ui`**：`el-form`、`el-form-item`（或包文档推荐包裹方式）。
+-   **`deppon-npm-skills`**。不默认读取 `deppon-npm` 的 `site/`。
+
+## 要点
+
+-   `import { ProField } from '@deppon/deppon-template'`。
+-   包裹在 `el-form` + `el-form-item` 中；`v-model:text` 等绑定随 `value-type` 变化（支持的类型以 **`ProField` 文档/类型** 为准）。
+-   `:mode="'read' | 'edit'"` 切换展示与编辑。
+-   `:field-props` 传占位、前后缀、图标、`rangeFormat: 'array'` 等。
+
+## 生成清单
+
+-   [ ] 选对 `value-type` 与对应 v-model 后缀（以 **`ProField` 类型定义** 为准）。
+-   [ ] 图标类使用 `@deppon/deppon-ui/icons-vue` 传入 `field-props`。
+-   [ ] 需要整表单校验时优先用 `ProForm`；仅少量展示/编辑时用本模式。

package/dist/deppon-pro-form/SKILL.md

@@ -0,0 +1,95 @@
+---
+name: deppon-pro-form
+description: >-
+    使用 Vue 3 script setup、@deppon/deppon-template 的 ProForm 与 @deppon/deppon-ui
+    生成或改写表单页。在用户需要新建/编辑表单、ProForm columns、校验规则、actions 插槽，
+    或提到 ProForm、表单页、deppon-template 表单 时应用。
+---
+
+# deppon-pro-form：ProForm 页面（私有 npm）
+
+## 依据来源（私有 npm）
+
+-   **`deppon-npm-private-registry`**：外仓安装 `@deppon/*` 与文档位置。
+-   **`@deppon/deppon-template`**：`ProForm` — `node_modules` 内 README、`VITE_USAGE.md`、`USAGE.md`、`es/**/*.d.ts`。
+-   **`@deppon/deppon-ui`**：`ElButton`、`ElMessage`、`ElCard` 等。
+-   专项索引：**`deppon-npm-skills`**。不默认读取 `deppon-npm` 的 `site/`；若用户工作区为该 monorepo 且要求对齐内部 demo，再查阅其本地示例。
+
+## 必须遵守的栈与风格
+
+-   Vue 3：`script setup`，组件从模板里用到的再 `import`。
+-   表单：`import { ProForm } from '@deppon/deppon-template'`。
+-   UI：`import { ElButton, ElMessage, ElCard, ... } from '@deppon/deppon-ui'`（与包文档一致；勿混用未约定包除非项目已采用）。
+-   样式：`scoped` + `lang="less"` 时与项目及组件库要求一致。
+
+## 页面骨架（常见布局）
+
+```vue
+<template>
+    <div class="xxx">
+        <el-card>
+            <template #header><span>标题</span></template>
+            <pro-form
+                ref="formRef"
+                :columns="columns"
+                :label-width="'120px'"
+                :cols="2"
+                :initial-values="formData"
+                @submit="handleSubmit"
+                @values-change="handleValuesChange"
+            >
+                <template #actions="{ form }">
+                    <div class="form-actions">
+                        <el-button type="primary" @click="form.submit()">提交</el-button>
+                        <el-button @click="form.reset()">重置</el-button>
+                    </div>
+                </template>
+            </pro-form>
+        </el-card>
+    </div>
+</template>
+```
+
+## columns 字段约定（ProForm）
+
+每条 column 常见键：
+
+-   `name`：字段名，对应 `initial-values` / 提交对象中的 key。
+-   `label`：标签文案。
+-   `valueType`：`text` | `textarea` | `select` | `dateTime` 等（以 **`ProForm` 列配置文档/类型** 为准）。
+-   `required`：布尔；可与 `rules` 并用。
+-   `fieldProps`：传给内部输入组件的属性（`placeholder`、`clearable`、`maxlength`、`rows` 等）。
+-   `options`：`{ label, value }[]`，用于 `select`。
+-   `rules`：Element Plus 风格校验数组；复杂逻辑用 `validator`。
+-   `warningTooltip`：必填警示提示（可选）。
+-   自定义组件：`component: 'el-input-number'` + `componentProps: { ... }`（以包内可注册组件名为准）。
+
+内联查询表单：给 `pro-form` 增加 `:inline="true"`，并缩小 `label-width`（模式对齐 **`deppon-pro-page-crud`** 顶部查询条）。
+
+## 脚本状态约定
+
+-   `const formRef = ref(null);`
+-   `const formData = ref({});` 或与业务字段对齐的初始对象。
+-   `const columns = ref([...])` 或 `computed(() => [...])`（依赖字典时用 `computed`）。
+-   `handleSubmit`：接入真实 API 时 `async`，成功/失败用 `ElMessage`。
+-   `handleValuesChange`：需要联动、清空关联字段时同步 `formData` 或记录上一次关键字段（适用于「主键字段 blur/清空联动」等模式）。
+
+## actions 区样式（可选）
+
+```less
+.form-actions {
+    margin-top: 20px;
+    padding-top: 20px;
+    border-top: 1px solid #ebeef5;
+    display: flex;
+    gap: 12px;
+    justify-content: flex-end;
+}
+```
+
+## 生成清单（交付前自检）
+
+-   [ ] `name` 与 `initial-values` / 提交 payload 键一致。
+-   [ ] 选择类字段有 `options` 或远程搜索占位说明。
+-   [ ] 必填在业务上是否同时需要 `rules`（与项目表单规范一致）。
+-   [ ] 是否需要 `cols`、`colSpan`（textarea 常 `colSpan: 2`）。

package/dist/deppon-pro-form-advanced-customer/SKILL.md

@@ -0,0 +1,27 @@
+---
+name: deppon-pro-form-advanced-customer
+description: >-
+    生成多块 el-card + pro-form 的「客户类」高级页：只读/编辑切换、card 头部自定义操作按钮（含样式与
+    handler）。在用户提到多卡片高级表单、只读模式、表单头部操作、多表单配置数组时应用。
+---
+
+# deppon-pro-form-advanced-customer
+
+## 依据来源（私有 npm）
+
+-   **`deppon-npm-private-registry`**。
+-   **`@deppon/deppon-template`**：`ProForm`（`readonly` 等 props 以 `*.d.ts` 为准）。
+-   **`@deppon/deppon-ui`**：`ElCard`、`ElRadioGroup`、`ElButton` 等。
+-   **`deppon-npm-skills`**。不默认读取 `deppon-npm` 的 `site/`。
+
+## 结构要点
+
+-   `el-radio-group` 或同类控件切换 `isReadonly`，传给各 `pro-form` 的 `:readonly`（props 名以 **`ProForm` 类型定义** 为准）。
+-   `v-for="form in formConfigs"`：`el-card` 的 `#header` 左侧标题 + 右侧 `form.headerActions` 渲染 `el-button`（支持自定义 border/color/hover 回调）。
+-   每个 `pro-form`：`ref`、`columns`、`initial-values`、`rules`、`@submit` 等与 **`@deppon/deppon-template`** 文档及类型一致。
+
+## 生成清单
+
+-   [ ] `headerActions` 为数据驱动：`:key`、`handler(form.key)`、可选箭头图标。
+-   [ ] 只读切换后校验与提交策略与业务一致（默认可参照 `ProForm` 文档行为）。
+-   [ ] 多表单时 `formConfigs` 可扩展为从接口拉取的配置。

package/dist/deppon-pro-form-group/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: deppon-pro-form-group
+description: >-
+    生成多段 ProForm 组合页：横向锚点、可折叠 ElCard、每段独立 columns/rules、底部统一提交/校验/重置。
+    在用户提到表单分组、锚点导航、统一提交多个 pro-form 时应用。
+---
+
+# deppon-pro-form-group
+
+## 依据来源（私有 npm）
+
+-   **`deppon-npm-private-registry`**。
+-   **`@deppon/deppon-template`**：`ProForm`。
+-   **`@deppon/deppon-ui`**：`ElCard`、`ElAnchor`、`ElScrollbar`、`ElButton` 等 — 以包内导出与 `*.d.ts` 为准。
+-   **`deppon-npm-skills`**。不默认读取 `deppon-npm` 的 `site/`。
+
+## 结构要点
+
+-   顶部 `el-anchor`（`direction="horizontal"`）+ `el-anchor-link`：`href` 指向各 `#form.id`。
+-   中部 `el-scrollbar`，内层 `v-for="form in formConfigs"`：`el-card` 带 `collapsible`、`v-model:collapsed`、`:id="form.id"`。
+-   每张卡内一个 `pro-form`：`:ref="el => (formRefs[form.key] = el)"`，`:columns`、`:initial-values`、`:rules`，监听 `@validate` 汇总状态。
+-   底部固定操作条：`handleSubmitAll` / `handleValidateAll` / `handleResetAll` / 汇总取值——通过 `formRefs` 遍历实例；**具体可调方法名以 `ProForm` 实例类型为准**。
+
+## 导入约定
+
+与 **`deppon-npm-private-registry`** 及包文档一致：`ProForm` 来自 `@deppon/deppon-template`；`ElCard`、`ElButton`、`ElAnchor`、`ElScrollbar`、`ElIcon` 等来自 `@deppon/deppon-ui`；图标 `@deppon/deppon-ui/icons-vue`。
+
+## 生成清单
+
+-   [ ] `formConfigs` 每项有稳定 `key`、`id`（与锚点一致）、`title`、`columns`。
+-   [ ] 折叠态用 `ref`/`reactive` 存 `cardCollapsed`，与 `v-model:collapsed` 同步。
+-   [ ] 统一提交流程里处理异步与 `ElMessage`/`ElMessageBox` 与项目惯例一致。

package/dist/deppon-pro-form-performance/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: deppon-pro-form-performance
+description: >-
+    大量 ProForm 实例时的性能写法：仅渲染可见表单、keep-alive 缓存、数据与 UI 分离、产品/线路切换保留已填数据。
+    在用户提到多表单卡顿、ProFormOptimization、可见表单数、全网模式时应用。
+---
+
+# deppon-pro-form-performance
+
+## 依据来源（私有 npm）
+
+-   **`deppon-npm-private-registry`**。
+-   **`@deppon/deppon-template`**：`ProForm` 多实例与 `keep-alive`、动态 ref — 以类型定义为实施准绳。
+-   业务化多产品 × 线路组合见专项 **`deppon-product-route-multi-form`**。
+-   **`deppon-npm-skills`**。不默认读取 `deppon-npm` 的 `site/`。
+
+## 模式要点（与常见性能优化范式一致）
+
+-   **组合枚举**：如产品与线路笛卡尔积得到 `allFormPairs`；**可见子集** `visibleFormPairs` 仅当前选中 product/line（或全网）对应项。
+-   **渲染**：`v-for` 只遍历 `visibleFormPairs`；外层可包 `keep-alive`（按性能需求与 **`ProForm` 文档**）。
+-   **状态**：用 `Map`/对象以 `getPairKey(pair)` 为键持久化各表单 values，避免切走即丢。
+-   **单实例**：每个 `pro-form` 带稳定 `:id`、`:ref="el => setFormRef(key, el)"`，`@values-change` 写回缓存。
+-   **批量校验**：遍历已缓存 ref 调用表单校验方法（方法名以 **ProForm 类型定义** 为准）。
+
+## 生成清单
+
+-   [ ] key 生成规则稳定且唯一（产品 code + 线路 code 等）。
+-   [ ] 不一次性挂载全部表单；确认 `visibleFormPairs.length` 小于总量。
+-   [ ] UI 提示（如 `el-alert`）标明可见数/总数，便于排查。

package/dist/deppon-pro-layout-page/SKILL.md

@@ -0,0 +1,30 @@
+---
+name: deppon-pro-layout-page
+description: >-
+    使用 ProLayout 搭建管理台壳层：collapsed、menu-items、top-menu、active-menu、menu-router、logo、插槽 header-right。
+    在用户提到 ProLayout、侧栏菜单、管理台壳层 时应用。
+---
+
+# deppon-pro-layout-page
+
+## 依据来源（私有 npm）
+
+-   **`deppon-npm-private-registry`**。
+-   **`@deppon/deppon-template`**：`ProLayout` — props / 插槽以 `*.d.ts` 为准。
+-   **`@deppon/deppon-ui`**。
+-   **`deppon-npm-skills`**。不默认读取 `deppon-npm` 的 `site/`。
+
+## 要点
+
+-   `import { ProLayout } from '@deppon/deppon-template'`。
+-   常用 props：`:collapsed` + `@update:collapsed`、`:menu-items`、`:top-menu-items`、`:active-menu`、`:menu-router="true"`、`:title`、`:logo`、`:fixed-header`、`:show-header-search` 等——**以已安装包类型定义与环境为准**。
+-   内容区默认放在默认 slot；`#header-right` 放用户区等。
+
+## 与嵌套关系
+
+业务项目可能在根布局已套一层壳；**页面内再嵌 `ProLayout`** 时，仅关注包文档中的 props/slot，勿与外层布局冲突。
+
+## 生成清单
+
+-   [ ] `active-menu` 与路由 path 同步。
+-   [ ] `menuItems` 结构与子路由一致；如需图标，按包文档与项目惯例使用 `markRaw` 等。

package/dist/deppon-pro-page-crud/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: deppon-pro-page-crud
+description: >-
+    生成「独立查询 ProForm + ProTable +（可选）底部/弹窗编辑 ProForm」的整页骨架。
+    在用户需要列表页带单独查询条、上下布局表单、分页列表联动，或提到「查询条 + 表格 + 编辑区」时应用。
+---
+
+# deppon-pro-page-crud：查询条 + 表格 + 编辑区
+
+## 依据来源（私有 npm）
+
+-   **`deppon-npm-private-registry`**。
+-   **`@deppon/deppon-template`**：同一页组合 `ProForm`（`inline` 查询）、`ProTable`、底部 `ProForm` — 以类型与文档为准。
+-   **`@deppon/deppon-ui`**。
+-   **`deppon-npm-skills`**。若搜索仅放在表格自带头里，改用 **`deppon-pro-table`**。不默认读取 `deppon-npm` 的 `site/`。
+
+## 布局结构
+
+1. **顶部**：`<pro-form ref="queryFormRef" :inline="true" :columns="queryColumns" :initial-values="queryForm" @submit="handleQuery">`，`#actions` 内「查询 / 重置」。
+2. **中部**：`<pro-table ...>`，`#paginationBefore` 可放摘要或按钮。
+3. **底部（可选）**：`<pro-form ref="editFormRef" :columns="editColumns" :initial-values="editForm" :rules="editFormRules" :cols="2" @submit="handleSubmit">`。
+
+## 导入约定
+
+```js
+import { ProTable, ProForm } from '@deppon/deppon-template';
+import { ElButton, ElMessage, ElCard } from '@deppon/deppon-ui';
+```
+
+若项目中仍使用 `element-plus` 的 `ElMessage`，与项目统一即可；skills 以 **`@deppon/deppon-ui`** 为默认。
+
+## 关键交互模式（分页与查询联动）
+
+-   **查询**：`handleQuery(values)` → 保存 `queryForm` → `currentPage = 1` → `fetchData()`。
+-   **重置查询**：`form.reset()` → 恢复 `queryForm` 初值对象 → `currentPage = 1` → `fetchData()`。
+-   **分页**：`watch([currentPage, pageSize], () => fetchData())`，`fetchData` 内防重入（`loading` 守卫）。
+-   **编辑提交**：`handleSubmit(values)` 更新本地 `editForm` 或调保存 API。
+
+## columns 分拆原则
+
+-   `queryColumns`：仅查询需要字段；`valueType`、`fieldProps`、`options` 与 `deppon-pro-form` 一致。
+-   `columns`（表格）：`prop`/`label`/`width`/`formatter`；展示用 `formatter`，避免在模板里写过多逻辑。
+-   `editColumns`：与表单实体字段一致；数字用 `el-input-number` + `component`/`componentProps` 模式。
+
+## 样式区块（可复制语义）
+
+-   `.query-form`：上 margin/padding、浅色底与边框（见 PaginationTest）。
+-   `.edit-form`：下 margin/padding，与查询区对称。
+
+## 生成清单
+
+-   [ ] 查询与编辑的字段命名空间清晰，不共用同一 ref 的 columns。
+-   [ ] `fetchData` 使用查询条件与分页参数（预留接到真实 API 的位置）。
+-   [ ] 表格 `total` 与后端一致；mock 阶段注明替换点。
+-   [ ] 路由与菜单不在此 skill 范围；仅生成视图组件时可在末尾提醒接入**当前项目的路由配置**。

package/dist/deppon-pro-table/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: deppon-pro-table
+description: >-
+    使用 Vue 3 script setup、@deppon/deppon-template 的 ProTable 与 @deppon/deppon-ui
+    生成或改写列表页（搜索、分页、工具栏、行操作、插槽列）。在用户需要数据表格、CRUD 列表、
+    ProTable columns，或提到 ProTable、数据表格 时应用。
+---
+
+# deppon-pro-table：ProTable 列表（私有 npm）
+
+## 依据来源（私有 npm）
+
+-   **`deppon-npm-private-registry`**：外仓安装与文档位置。
+-   **`@deppon/deppon-template`**：`ProTable` — README、`VITE_USAGE.md`、`USAGE.md`、`es/**/*.d.ts`。
+-   **`@deppon/deppon-ui`**：表格区按钮、`ElTag` 等。
+-   **`deppon-npm-skills`**：多级表头、展开行等见其它专项 skill。不默认读取 `deppon-npm` 的 `site/`。
+
+## 必须遵守的栈与风格
+
+-   `import { ProTable } from '@deppon/deppon-template'`。
+-   `import { ElButton, ElMessage, ElTag, ... } from '@deppon/deppon-ui'`。
+-   `script setup` + `ref`/`onMounted`/`watch` 与项目惯例一致。
+
+## 模板骨架（ProTable 常见 props）
+
+核心 props：
+
+-   数据：` :data-source="tableData"`
+-   列：` :columns="columns"`
+-   分页：`:show-pagination="true"` + `:current-page` + `:page-size` + `:page-sizes` + `:total`
+-   加载：`:loading="loading"`
+-   搜索区（内置）：`:search-label-width`、`:search-cols`、`search-title`、`@search`、`@reset`、`@values-change`
+-   行操作：`:show-operations="true"` + `#operations` / `#batchOperations`
+-   事件：`@size-change`、`@current-change`、`@selection-change`
+
+常用增强：
+
+-   `stripe`、` :fixed-table="true"`、` :row-selection="rowSelection"`、` :draggable="true"`
+-   ` :toolbar-options="{ reload, density, setting, fullScreen }"`
+-   ` :empty-text` / ` :empty-image`
+
+## columns 约定（ProTable）
+
+与列表+搜索共用时，单列常见字段：
+
+-   `prop`：数据字段名。
+-   `label`：表头。
+-   `width` / `minWidth` / `fixed` / `align`
+-   `hideInSearch: false`：参与搜索（按需显式写出参与搜索的列）。
+-   `valueType`：如 `textRange`（双框范围，以 **`ProTable` 文档/类型** 为准）。
+-   `initialValue` / `initialValue: [...]`：搜索区初值。
+-   `fieldProps`：搜索控件的 props（含 `placeholder`、`isClearInitialValue` 等）。
+-   `rules`：搜索表单项校验。
+-   `slots: { default: 'slotName' }`：表格体插槽；模板里写 `<template #slotName="{ row }">`。
+-   `sorter: true` 或自定义 `(a,b)=>...`
+-   `filters` + `filterMethod`：列头筛选（若当前版本列类型支持）。
+
+操作列通常在列配置里留 `prop: 'action'`，并用 `#action` 插槽渲染按钮。
+
+## 状态与数据流
+
+-   `loading`、`currentPage`、`pageSize`、`total`、`tableData` 全用 `ref`。
+-   分页：`handleSizeChange` 更新 `pageSize`，常把 `currentPage` 重置为 1；`handleCurrentChange` 更新页码。
+-   查询：`handleSearch(values)` 里合并条件、`currentPage=1`、拉取列表。
+-   重置：`handleReset` 调用表格暴露的重置或清空搜索表单（与 **`ProTable` 事件/方法** 对齐）。
+-   远程列表：在 `fetchList` 里统一处理 `loading`、错误提示与 `total`。
+
+## 插槽命名速查
+
+-   `#tableTitle`：表头标题区。
+-   `#paginationBefore`：分页条左侧（如「新建」）。
+-   `#operations`：表格上方操作按钮行。
+-   `#batchOperations="{ selectedRows, clearSelection }"`：批量操作。
+-   列体：`#status`、`#action` 等与 `slots.default` 名称一致。
+
+## 生成清单
+
+-   [ ] 列 `prop` 与接口字段一致；`label` 中文业务名。
+-   [ ] 需要搜索的列未误设 `hideInSearch: true`。
+-   [ ] 分页与查询联动时重置到第一页。
+-   [ ] 操作列固定宽度，避免挤压。

package/dist/deppon-pro-table-advanced-tabs/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: deppon-pro-table-advanced-tabs
+description: >-
+    在一个页面用 el-tabs 组织多个 ProTable 场景：基础表、搜索表、行选、操作列、工具栏等，彼此独立 data/columns/ref。
+    在用户提到分 tab、多表格并列 demo、同一页多套 ProTable 时应用。
+---
+
+# deppon-pro-table-advanced-tabs
+
+## 依据来源（私有 npm）
+
+-   **`deppon-npm-private-registry`**。
+-   **`@deppon/deppon-template`**：`ProTable`。
+-   **`@deppon/deppon-ui`**：`ElTabs`、`ElTabPane`、`ElCard` 等 — 以 `*.d.ts` 为准。
+-   **`deppon-npm-skills`**。不默认读取 `deppon-npm` 的 `site/`。
+
+## 要点
+
+-   外层 `el-card` + `el-tabs`。每个 `el-tab-pane` 内独立：`ref`、`data-source`、`columns`、分页 ref、`@search`/`@reset`/`@selection-change` 等。
+-   **搜索 tab**：`search-title`、`table-title`、`@search`、`@reset`、`search-cols`。
+-   **行选 tab**：`:row-selection` + `@selection-change`，上方可展示已选 `el-tag`。
+-   **操作列 tab**：列里配置 `slots` + `#action`；或 `:show-operations` + 操作插槽（按 **`ProTable`** 约定）。
+-   **工具栏 tab**：`:toolbar-options`；`#paginationBefore` 放新建/导出等。
+
+## 生成清单
+
+-   [ ] 各 tab 的 `columns` 不要共享引用（避免联动污染）。
+-   [ ] 每个 `pro-table` 有独立 `ref` 便于调试与调用暴露方法。

package/dist/deppon-pro-table-cell-editable/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: deppon-pro-table-cell-editable
+description: >-
+    ProTable 单元格编辑模式：editable、readonly、field-size、增删行、校验与 validation-change、范围列 onAfterAddRange。
+    在用户提到可编辑表格、单元格编辑、添加行、表格内校验 时应用。
+---
+
+# deppon-pro-table-cell-editable
+
+## 依据来源（私有 npm）
+
+-   **`deppon-npm-private-registry`**。
+-   **`@deppon/deppon-template`**：`ProTable` 的 `editable`、`readonly`、`field-size`、增删行、校验事件 — 以 `*.d.ts` 为准。
+-   **`deppon-npm-skills`**。不默认读取 `deppon-npm` 的 `site/`。
+
+## 要点
+
+-   `:editable="true"`，`:readonly` 与界面开关绑定；`:field-size="'small'"`。
+-   `:show-header="false"`、`:show-toolbar="false"`、`:show-pagination="false"`（纯编辑表常见组合，以业务为准）。
+-   事件：`@add`、`@delete`、`@update`、`@validation-change`；可选 `:on-after-add-range`。
+-   列配置、`valueType`、范围列等以类型定义为准；**生成前读透**当前版本 `ProTable` 可编辑列约定。
+
+## 生成清单
+
+-   [ ] `#action`/`#empty` 等与当前 `ProTable` 插槽约定一致。
+-   [ ] 校验、只读切换后按钮禁用逻辑与业务一致。

package/dist/deppon-pro-table-expand-nested/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: deppon-pro-table-expand-nested
+description: >-
+    ProTable 展开行与嵌套子表：主表 row-key、#expand 插槽、子表独立 columns 与插槽列。
+    在用户提到父子表、展开行、嵌套子表 时应用。
+---
+
+# deppon-pro-table-expand-nested
+
+## 依据来源（私有 npm）
+
+-   **`deppon-npm-private-registry`**。
+-   **`@deppon/deppon-template`**：`ProTable` 展开行、`#expand`、嵌套子表 — 以 `*.d.ts` 为准。
+-   **`deppon-npm-skills`**。不默认读取 `deppon-npm` 的 `site/`。
+
+## 要点
+
+-   主表：`row-key` 稳定；提供 `#expand` 插槽。展开行为是否在列上显式配置，以 **ProTable 文档/类型** 为准。
+-   `#expand="{ row }"`：内层第二个 `pro-table`，`:data-source="row.subPOList"`，通常关掉工具栏/分页/表头 `.show-toolbar` / `.show-pagination` / `.show-header`。
+-   子表列仍可用 `#ruleType` 等具名插槽做展示格式化。
+
+## 生成清单
+
+-   [ ] 后端嵌套字段名与 `row.xxx` 一致；无数据时子表空态。
+-   [ ] 必要时对子表数据做懒加载（主表行数据很大时）。

package/dist/deppon-pro-table-multi-header/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: deppon-pro-table-multi-header
+description: >-
+    ProTable 多级表头 columns 配置（列嵌套 children）。在用户提到多级表头、分组表头、
+    在用户提到多级表头、分组表头 时应用。
+---
+
+# deppon-pro-table-multi-header
+
+## 依据来源（私有 npm）
+
+-   **`deppon-npm-private-registry`**。
+-   **`@deppon/deppon-template`**：`ProTable` 列 `children` 多级表头 — 以类型与 README 为准。
+-   **`deppon-npm-skills`**。不默认读取 `deppon-npm` 的 `site/`。
+
+## 要点
+
+-   与常规 `prop`/`label` 列并列，父列使用 `children: [...]` 嵌套子列（列字段名以 **`ProTable` 列类型** 为准）。
+-   搜索、分页、操作区与 `deppon-pro-table` 通用模式一致；本 skill **侧重列头 `children` 结构**。
+
+## 生成清单
+
+-   [ ] `width`/`minWidth`/`align` 与多级头对齐，避免错位。
+-   [ ] 需要搜索字段时子列或父列上正确配置 `hideInSearch`、`valueType`。

package/dist/deppon-pro-table-nofixed-scroll/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: deppon-pro-table-nofixed-scroll
+description: >-
+    非 fixed-table 场景：外层 el-scrollbar、表格 editable 切换、自定义 #header 区域、高度随数据切换。
+    在用户提到长页面滚动、自定义表格顶栏、non-fixed 表格 时应用。
+---
+
+# deppon-pro-table-nofixed-scroll
+
+## 依据来源（私有 npm）
+
+-   **`deppon-npm-private-registry`**。
+-   **`@deppon/deppon-template`**：`ProTable` 的 `editable`、`#header`、高度、`fixed-table` — 以 **`es/**/\*.d.ts`\*\* 为准。
+-   **`@deppon/deppon-ui`**：`ElScrollbar` 等。
+-   **`deppon-npm-skills`**。不默认读取 `deppon-npm` 的 `site/`。
+
+## 要点
+
+-   外层 `el-scrollbar` 包裹页面块与 `pro-table`（按业务决定是否在表格外加垫高区块）。
+-   主表可不使用 `fixed-table`；`:height` 可用三元：`tableData.length > 0 ? '480' : 'auto'`（按业务改）。
+-   `:editable` 与按钮切换联动；`@update`、`@delete` 处理编辑态数据。
+-   `#header` 插槽自定义标题区与「进入编辑/退出编辑」等按钮。
+-   `#status` 等插槽展示 `el-tag`。
+
+## 生成清单
+
+-   [ ] 确认业务是否需要 fixed 列；本模式侧重 **non-fixed + 外层滚动容器**。
+-   [ ] 分页与 `loading` 与 `deppon-pro-table` 通用模式一致。

package/dist/deppon-pro-table-row-edit/SKILL.md

@@ -0,0 +1,27 @@
+---
+name: deppon-pro-table-row-edit
+description: >-
+    ProTable 行编辑模式：row-edit、v-model:editing-row-index、保存/取消、行高 tableHeight 计算。
+    在用户提到行内编辑、一次只编一行、整行编辑 时应用。
+---
+
+# deppon-pro-table-row-edit
+
+## 依据来源（私有 npm）
+
+-   **`deppon-npm-private-registry`**。
+-   **`@deppon/deppon-template`**：`ProTable` 的 `row-edit`、`v-model:editing-row-index`、行高与插槽 — 以 **`es/**/\*.d.ts`\*\* 为准。
+-   **`@deppon/deppon-ui`**。
+-   **`deppon-npm-skills`**。不默认读取 `deppon-npm` 的 `site/`。
+
+## 要点
+
+-   `v-model:editing-row-index="editingRowIndex"`，`-1` 表示无编辑行。
+-   `:row-edit="true"`；`:height="tableHeight"` 用 `computed` 按行数在 `auto` 与固定高度间切换。
+-   `#action` 内按 `editingRowIndex === index` 切换「保存/取消」与「编辑/删除」。
+-   未保存新行、取消时删除等状态，按 **`ProTable` 行编辑语义** 与业务规则实现（以类型定义中的事件/方法为准）。
+
+## 与 cell-editable 的区分
+
+-   **row-edit**：整行进入编辑态，适合字段较少、流程清晰的行。
+-   **editable**（`deppon-pro-table-cell-editable`）：单元格级编辑，适合密集填报/规则表。

package/dist/deppon-product-route-multi-form/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: deppon-product-route-multi-form
+description: >-
+    多产品×多线路（或可推广为多 key 组合）下，为每个组合生成 ProForm：标签选择、错误提示、仅渲染可见组合、
+    keep-alive、数据按 key 持久化。在用户提到多产品、多线路、组合配置表单、报价矩阵 时应用。
+---
+
+# deppon-product-route-multi-form
+
+## 依据来源（私有 npm）
+
+-   **`deppon-npm-private-registry`**。
+-   **`@deppon/deppon-template`**：`ProForm` 动态 `columns`、ref、`values-change` — 以 `*.d.ts` 为准；性能模式见 **`deppon-pro-form-performance`**。
+-   **`@deppon/deppon-ui`**：标签、提示等。
+-   **`deppon-npm-skills`**。不默认读取 `deppon-npm` 的 `site/`。
+
+## 要点
+
+-   产品与线路（或同类维度）选择 UI；`active*` 控制**当前可见**组合。
+-   `allFormPairs` 与 `visibleFormPairs`；未挂载实例的数据放入 Map/对象，键稳定（如 `getPairKey`）。
+-   `getFormColumns` / `getInitialValues` / 共用 `rules` 按业务拆分；校验失败时在标签上高亮等交互以类型与状态机为准。
+
+## 与 deppon-pro-form-performance 的关系
+
+同属「多实例 + 可见性」优化模式；本 skill 偏**业务组合**，细节以 **`@deppon/deppon-template`** 与项目数据模型为准。

package/dist/deppon-request-package-demo/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: deppon-request-package-demo
+description: >-
+    使用 @deppon/deppon-request 发起 HTTP 请求、处理错误结构。在用户提到 deppon-request、封装请求、
+    超时、401/500 时应用。
+---
+
+# deppon-request-package-demo
+
+## 依据来源（私有 npm）
+
+-   **`deppon-npm-private-registry`**。
+-   **`@deppon/deppon-request`**：包根 `README` 与源码/类型导出路径以 **`node_modules`** 内为准。
+-   **`deppon-npm-skills`**。不默认读取 `deppon-npm` 的 `site/`。
+
+## 要点
+
+-   在项目已有封装（如统一 client、拦截器、baseURL）上扩展；具体方法名、返回结构以类型定义为准。
+-   错误对象字段（status、data、message 等）以 **包实现与 README** 为准。
+
+## 生成清单
+
+-   [ ] 不臆造 baseURL；与项目环境配置一致。

package/dist/deppon-router-push-viewtab/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: deppon-router-push-viewtab
+description: >-
+    使用 @deppon/deppon-router 与 useRouter：router.push、router.depponPush、pushByName、query/params、
+    defaultViewTab、_viewTab 覆盖。在用户提到 deppon-router、页签标题、uums 功能码、路由跳转 时应用。
+---
+
+# deppon-router-push-viewtab
+
+## 依据来源（私有 npm）
+
+-   **`deppon-npm-private-registry`**。
+-   **`@deppon/deppon-router`**：README、`*.d.ts`（`useRouter`、`useRoute`、`createDepponRouter` 或包导出名以实际为准）。
+-   **`vue-router`**：与各包 peer 声明一致。
+-   **`deppon-npm-skills`**。不默认读取 `deppon-npm` 的 `site/`。
+
+## 要点
+
+-   `import { useRouter, useRoute } from '@deppon/deppon-router'`（若包导出路径不同则以类型定义为准）。
+-   常见能力：标准 `push`（query / params / 字符串 path）、`depponPush`（可带 `_viewTab`）、`pushByName`（若包提供）。
+-   目标页可读 `route.path` / `query` / `params`；辅助方法名以 **`@deppon/deppon-router`** 导出为准。
+
+## 生成清单
+
+-   [ ] 新路由在**当前项目**的路由配置文件中注册，并与侧栏/菜单 `meta` 一致。
+-   [ ] 若使用页签 / viewTab 扩展能力，遵循 **`createDepponRouter`（或项目封装）** 中与 `_viewTab`、`defaultViewTab` 相关的选项。

package/dist/deppon-ui-examples-primitives/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: deppon-ui-examples-primitives
+description: >-
+    使用 @deppon/deppon-ui 的基础组件：Card、Button、Message（及同类 El* 反馈）。在用户要对照
+    按钮样式、卡片结构、消息提示写法且不需要 Pro 组件时应用。
+---
+
+# deppon-ui-examples-primitives
+
+## 依据来源（私有 npm）
+
+-   **`deppon-npm-private-registry`**。
+-   **`@deppon/deppon-ui`**：`README`、`es/**/*.d.ts`；`ElCard`、`ElButton`、`ElMessage` 等 API 以**已安装版本**为准。
+-   **`deppon-npm-skills`**。不默认读取 `deppon-npm` 的 `site/`。
+
+## 要点
+
+-   统一从 `@deppon/deppon-ui` 引入。
+-   `ElMessage` / `ElMessageBox` 参数与样式可能与上游 Element Plus 版本相关；以 **包内类型与 README** 为准，勿硬套公网文档其它大版本。
+
+## 生成清单
+
+-   [ ] 与项目内已有页面的反馈、按钮风格一致。

package/install.cjs

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+/**
+ * 将本包内 dist/* 安装到当前工作目录 .cursor/skills/（覆盖同名 skill 目录）。
+ */
+const fs = require('fs');
+const path = require('path');
+
+const pkgRoot = __dirname;
+const src = path.join(pkgRoot, 'dist');
+const dest = path.join(process.cwd(), '.cursor', 'skills');
+
+if (!fs.existsSync(src)) {
+    console.error(
+        '[@deppon/deppon-skills] 未找到 dist 目录，请确认包已正确安装（npm 发布的包应包含 dist）。',
+    );
+    process.exit(1);
+}
+
+fs.mkdirSync(dest, { recursive: true });
+
+for (const name of fs.readdirSync(src, { withFileTypes: true })) {
+    if (!name.isDirectory()) continue;
+    const from = path.join(src, name.name);
+    const to = path.join(dest, name.name);
+    fs.rmSync(to, { recursive: true, force: true });
+    fs.cpSync(from, to, { recursive: true });
+}
+
+console.log('[@deppon/deppon-skills] 已复制到', dest);

package/package.json

@@ -0,0 +1,34 @@
+{
+    "name": "@deppon/deppon-skills",
+    "version": "2.4.12",
+    "description": "Cursor Agent Skills for @deppon/* (ProForm, ProTable, PRD, private npm workflow)",
+    "license": "MIT",
+    "keywords": [
+        "cursor",
+        "cursor-agent",
+        "skills",
+        "deppon"
+    ],
+    "bin": {
+        "deppon-skills-install": "install.cjs"
+    },
+    "scripts": {
+        "build": "node scripts/sync-skills.cjs",
+        "sync": "npm run build",
+        "prepack": "npm run build",
+        "publish:auto": "npm publish"
+    },
+    "files": [
+        "dist",
+        "install.cjs",
+        "README.md"
+    ],
+    "publishConfig": {
+        "registry": "https://registry.npmjs.org/",
+        "access": "public"
+    },
+    "repository": {
+        "type": "git",
+        "url": ""
+    }
+}