@deppon/deppon-skills 2.4.16 → 2.4.20

package/dist/deppon-prd-generator/template/backend-form-edit-prd-template.md

@@ -0,0 +1,116 @@
+# [页面名称] PRD (产品需求文档)
+
+> **生成时对照**：整页表单编辑类 PRD 生成前阅读本技能目录 `examples/form-edit/prd.md`（及将交付原型时的 `prototype.html`）。
+
+> **交互原型链接（有 `prototype.html` 时必填）**：文首加入 `- **交互原型**：[打开 prototype.html](./prototype.html)`；仅无原型时删除。见 `SKILL.md`「PRD 与原型互链」。
+
+## 1. 引言
+
+### 1.1 背景
+
+> 简要说明该元素/页面的核心定位、解决的问题、用户价值（控制在50字左右）。
+
+```
+[需求背景内容]
+```
+
+### 1.2 功能清单
+
+> 以表格形式梳理出所有模块、功能点及功能描述。
+>
+> 功能清单不包含：页面顶栏、左侧菜单栏的样式、交互需求内容！
+
+| 模块             | 功能点         | 功能描述       |
+| ---------------- | -------------- | -------------- |
+| `[功能模块标题]` | `[功能点标题]` | `[功能点描述]` |
+
+## 2. 页面菜单与权限规划
+
+### 2.1 页面菜单
+
+> 参考菜单栏，描述页面菜单路径。仅描述菜单路径即可！不要做其他内容说明。
+
+**菜单路径**：[一级菜单名称] / [二级菜单名称]
+
+### 2.2 权限规划
+
+> 表格呈现权限点规划，仅定义权限点、可执行操作范围、数据范围（如：个人数据/全量数据），不定义具体角色；
+>
+> **权限点规划的基本原则：**查看类操作归集在【查看】一个权限点；编辑类操作归集在【编辑】一个权限点；导出类操作归集在【导出】一个权限点。
+
+| 权限点         | 操作范围           | 数据范围      |
+| -------------- | ------------------ | ------------- |
+| `[权限点名称]` | `[支持的操作名称]` | `[个人/全量]` |
+
+## 3. [模块名称]需求说明
+
+### 3.1 表单字段说明
+
+> 按表单字段逐一描述，包含字段名称、类型、必填性、校验规则、默认值、说明等
+
+| 字段名称 | 字段类型 | 必填 | 默认值 | 校验规则 | 说明 |
+|---------|---------|------|--------|---------|------|
+| `[字段名]` | `[文本/下拉/日期/数字等]` | 是/否 | `[默认值]` | `[校验规则，如：长度1-50，手机号格式等]` | `[字段说明]` |
+
+### 3.2 字段详细说明
+
+> 对每个字段进行更详细的说明，特别是有特殊逻辑的字段
+
+#### 3.2.1 [字段名称]
+
+- **字段说明**：[详细说明]
+- **输入限制**：[具体限制]
+- **校验规则**：
+  - 规则1：[描述]
+  - 规则2：[描述]
+- **错误提示**：[校验失败时的提示信息]
+
+### 3.3 字段联动逻辑
+
+> 描述字段之间的联动关系，如：选择A后，B字段显示/隐藏、变为必填等
+
+| 触发字段 | 触发条件 | 影响字段 | 影响效果 |
+|---------|---------|---------|---------|
+| `[字段A]` | `[选择某个值]` | `[字段B]` | `[显示/隐藏/必填/可选等]` |
+
+### 3.4 操作按钮
+
+#### 3.4.1 保存/提交
+
+- **按钮位置**：表单底部
+- **点击逻辑**：
+  1. 前端校验所有必填字段和格式校验
+  2. 校验失败：显示错误提示，光标定位到第一个错误字段
+  3. 校验通过：调用后端接口提交数据
+  4. 提交成功：显示成功提示，跳转至列表页
+  5. 提交失败：显示失败提示，保留表单数据
+
+#### 3.4.2 取消
+
+- **按钮位置**：保存按钮旁边
+- **点击逻辑**：
+  1. 若表单有修改，弹出二次确认："您有未保存的修改，确定要离开吗？"
+  2. 确认：跳转至列表页
+  3. 取消：停留在当前页面
+
+#### 3.4.3 重置
+
+- **按钮位置**：表单底部（可选）
+- **点击逻辑**：
+  1. 弹出二次确认："确定要重置表单吗？"
+  2. 确认：恢复所有字段为默认值
+  3. 取消：不做操作
+
+## 4. 交互设计
+
+### 4.1 全局交互
+
+- **加载状态**：数据请求过程中需展示 Loading 状态。
+- **空状态**：无数据时需展示统一的 Empty 状态图。
+- **响应式**：页面需适配不同分辨率屏幕，保证内容不遮挡、不错位。
+
+### 4.2 表单交互
+
+- **实时校验**：字段失焦时进行校验，即时显示错误提示
+- **必填标识**：必填字段前显示红色星号（*）
+- **Tab键导航**：支持Tab键在字段间顺序切换

package/dist/deppon-prd-generator/template/backend-form-preview-prd-template.md

@@ -0,0 +1,112 @@
+# [页面名称] PRD (产品需求文档)
+
+> **生成时对照**：只读详情/预览类 PRD 生成前阅读本技能目录 `examples/form-preview/prd.md`（及将交付原型时的 `prototype.html`）。
+
+> **交互原型链接（有 `prototype.html` 时必填）**：文首加入 `- **交互原型**：[打开 prototype.html](./prototype.html)`；仅无原型时删除。见 `SKILL.md`「PRD 与原型互链」。
+
+## 1. 引言
+
+### 1.1 背景
+
+> 简要说明该元素/页面的核心定位、解决的问题、用户价值（控制在50字左右）。
+
+```
+[需求背景内容]
+```
+
+### 1.2 功能清单
+
+> 以表格形式梳理出所有模块、功能点及功能描述。
+>
+> 功能清单不包含：页面顶栏、左侧菜单栏的样式、交互需求内容！
+
+| 模块             | 功能点         | 功能描述       |
+| ---------------- | -------------- | -------------- |
+| `[功能模块标题]` | `[功能点标题]` | `[功能点描述]` |
+
+## 2. 页面菜单与权限规划
+
+### 2.1 页面菜单
+
+> 参考菜单栏，描述页面菜单路径。仅描述菜单路径即可！不要做其他内容说明。
+
+**菜单路径**：[一级菜单名称] / [二级菜单名称]
+
+### 2.2 权限规划
+
+> 表格呈现权限点规划，仅定义权限点、可执行操作范围、数据范围（如：个人数据/全量数据），不定义具体角色；
+>
+> **权限点规划的基本原则：**查看类操作归集在【查看】一个权限点；编辑类操作归集在【编辑】一个权限点；导出类操作归集在【导出】一个权限点。
+
+| 权限点         | 操作范围           | 数据范围      |
+| -------------- | ------------------ | ------------- |
+| `[权限点名称]` | `[支持的操作名称]` | `[个人/全量]` |
+
+## 3. [模块名称]需求说明
+
+### 3.1 信息展示区域
+
+> 描述页面展示的所有信息字段
+
+| 字段名称 | 展示格式 | 说明 |
+|---------|---------|------|
+| `[字段名]` | `[文本/日期/金额/状态标签等]` | `[字段说明]` |
+
+### 3.2 字段详细说明
+
+> 对重要字段进行详细说明
+
+#### 3.2.1 [字段名称]
+
+- **字段说明**：[详细说明]
+- **展示格式**：[具体格式，如：YYYY-MM-DD、¥#,##0.00等]
+- **空值展示**：[空值时显示的内容，如：-、暂无等]
+- **特殊规则**：[特殊展示规则，如：状态颜色、超长省略等]
+
+### 3.3 操作按钮
+
+> 描述页面上的操作按钮
+
+| 按钮名称 | 按钮位置 | 点击逻辑 | 权限要求 |
+|---------|---------|---------|---------|
+| `[编辑]` | `[页面右上角/底部等]` | `[跳转至编辑页面]` | `[需要编辑权限]` |
+| `[删除]` | `[页面右上角/底部等]` | `[弹出二次确认，确认后删除]` | `[需要删除权限]` |
+| `[返回]` | `[页面左上角/底部等]` | `[返回上一页/列表页]` | `[无权限要求]` |
+
+#### 3.3.1 编辑按钮
+
+- **按钮样式**：主按钮样式
+- **点击逻辑**：
+  1. 校验编辑权限
+  2. 有权限：跳转至编辑页面，携带当前记录ID
+  3. 无权限：显示无权限提示
+
+#### 3.3.2 删除按钮
+
+- **按钮样式**：危险按钮样式
+- **点击逻辑**：
+  1. 校验删除权限
+  2. 弹出二次确认："确定要删除该记录吗？删除后不可恢复。"
+  3. 确认：调用删除接口
+  4. 删除成功：显示成功提示，跳转至列表页
+  5. 删除失败：显示失败提示
+
+#### 3.3.3 返回按钮
+
+- **按钮样式**：次要按钮样式
+- **点击逻辑**：
+  1. 跳转至上一页或列表页
+
+## 4. 交互设计
+
+### 4.1 全局交互
+
+- **加载状态**：数据请求过程中需展示 Loading 状态。
+- **空状态**：无数据时需展示统一的 Empty 状态图。
+- **响应式**：页面需适配不同分辨率屏幕，保证内容不遮挡、不错位。
+
+### 4.2 页面交互
+
+- **数据加载**：进入页面时，根据ID加载详情数据
+- **权限控制**：根据用户权限控制操作按钮的显示/隐藏
+- **复制功能**：（可选）支持一键复制某些字段内容

package/dist/deppon-prd-generator/template/backend-list-prd-template.md

@@ -0,0 +1,110 @@
+# [页面名称] PRD (产品需求文档)
+
+> **生成时对照**：若本页含典型 **列表 + 筛选 + CRUD（详情/新增编辑/删除）**，生成前阅读本技能目录 `examples/list-crud/prd.md`，对齐章节拆分、表格字段密度与「原型与 PRD 对应关系」小节（交付 `prototype.html` 时）。若仅为**筛选 + 列表 + 分页**（无弹层 CRUD），阅读 `examples/backend-list/prd.md`。
+
+> **交互原型链接（有 `prototype.html` 时必填）**：在文首「文档说明」或标题下第一段加入 Markdown 相对链接，例如 `- **交互原型**：[打开 prototype.html](./prototype.html)`（文件名随实际交付调整）；仅无原型时删除本行链接。见本技能 `SKILL.md`「PRD 与原型互链」。
+
+## 1. 引言
+
+### 1.1 背景
+
+> 简要说明该元素/页面的核心定位、解决的问题、用户价值（控制在50字左右）。
+
+```
+[需求背景内容]
+```
+
+### 1.2 功能清单
+
+> 以表格形式梳理出所有模块、功能点及功能描述。
+>
+> 功能清单不包含：页面顶栏、左侧菜单栏的样式、交互需求内容！
+
+| 模块             | 功能点         | 功能描述       |
+| ---------------- | -------------- | -------------- |
+| `[功能模块标题]` | `[功能点标题]` | `[功能点描述]` |
+
+## 2. 页面菜单与权限规划
+
+### 2.1 页面菜单
+
+> 参考菜单栏，描述页面菜单路径。仅描述菜单路径即可！不要做其他内容说明。
+
+**菜单路径**：[一级菜单名称] / [二级菜单名称]
+
+### 2.2 权限规划
+
+> 表格呈现权限点规划，仅定义权限点、可执行操作范围、数据范围（如：个人数据/全量数据），不定义具体角色；
+>
+> **权限点规划的基本原则：**查看类操作归集在【查看】一个权限点；编辑类操作归集在【编辑】一个权限点；导出类操作归集在【导出】一个权限点。
+
+| 权限点         | 操作范围           | 数据范围      |
+| -------------- | ------------------ | ------------- |
+| `[权限点名称]` | `[支持的操作名称]` | `[个人/全量]` |
+
+## 3. [模块名称]需求说明
+
+### 3.1 筛选查询区
+
+> 用表格呈现筛选字段、控件类型（如：文本输入/下拉选择/下拉多选/日期范围选择器等）、输入限制（明确长度/枚举值/默认值/必填性/其他条件依赖）、匹配规则（精准/模糊/范围）。
+
+支持多维度组合筛选，筛选条件变更后需点击"查询"按钮生效。
+
+| 筛选字段         | 类型         | 输入限制         | 匹配规则     |
+| :--------------- | :----------- | :--------------- | :----------- |
+| `[筛选字段名称]` | `[控件类型]` | `[输入限制内容]` | `[匹配规则]` |
+
+- **操作按钮**：
+
+  - **查询**：根据当前筛选条件刷新页面数据。
+
+  - **重置**：恢复所有筛选条件为默认值。
+
+### 3.2 数据列表
+
+> 按页面里列表形式的子模块循环撰写
+
+以列表形式，按需展示详细的数据表格。
+
+- **列表字段**：
+
+  | 列表字段     | 字段说明         | 排序 |
+  | :----------- | :--------------- | :--- |
+  | `[字段名称]` | `[字段定义描述]` | 是/否 |
+
+- **分页规则**：
+  - 每页默认显示：[X]条
+  - 可切换显示：[X/X/X]条
+  - 分页控件位置：列表底部
+
+- **批量操作**：
+  > 描述支持的批量操作，如批量删除、批量导出等
+
+  - **批量删除**：选中多条记录后点击删除，弹出二次确认
+
+- **行操作**：
+  > 描述每行支持的操作，如编辑、删除、查看详情等
+
+  - **编辑**：点击编辑按钮，跳转至编辑页面
+  - **删除**：点击删除按钮，弹出二次确认
+
+- **交互说明**：
+  > 简述数据列表的操作说明，包括导出/排序/行操作说明
+
+  - **排序**：点击表头排序图标，支持升序/降序切换
+  - **导出**：点击导出按钮，导出当前筛选条件下的全部数据（CSV格式）
+
+## 4. 交互设计
+
+### 4.1 全局交互
+
+- **加载状态**：数据请求过程中需展示 Loading 状态。
+- **空状态**：无数据时需展示统一的 Empty 状态图。
+- **响应式**：页面需适配不同分辨率屏幕，保证内容不遮挡、不错位。
+
+### 4.2 特殊交互
+
+> 描述页面中特殊的交互逻辑，如：
+> - 筛选条件联动
+> - 数据刷新机制
+> - 弹窗交互等

package/dist/deppon-prd-generator/template/data-prd-template.md

@@ -0,0 +1,194 @@
+# [页面名称] PRD (产品需求文档)
+
+> **生成时对照**：数据看板类 PRD 生成前阅读本技能目录 `examples/data-dashboard/prd.md`（含 §3 子模块、§4 指标总览、§5 交互；交付原型时对照同目录 `prototype.html`）。
+
+> **交互原型链接（有 `prototype.html` 时必填）**：文首加入 `- **交互原型**：[打开 prototype.html](./prototype.html)` 等相对链接；仅无原型时删除。见 `SKILL.md`「PRD 与原型互链」。
+
+## 1. 引言
+
+### 1.1 背景
+
+> 简要说明该元素/页面的核心定位、解决的问题、用户价值（控制在50字左右）。
+
+```
+[需求背景内容]
+```
+
+
+
+### 1.2 功能清单
+
+> 以表格形式梳理出所有模块、功能点及功能描述。
+>
+> 功能清单不包含：页面顶栏、左侧菜单栏的样式、交互需求内容！
+
+| 模块             | 功能点         | 功能描述       |
+| ---------------- | -------------- | -------------- |
+| `[功能模块标题]` | `[功能点标题]` | `[功能点描述]` |
+
+
+
+## 2. 页面菜单与权限规划
+
+### 2.1 页面菜单
+
+> 参考菜单栏，描述页面菜单路径。仅描述菜单路径即可！不要做其他内容说明。
+
+**菜单路径**：[一级菜单名称] / [二级菜单名称]
+
+
+
+### 2.2 权限规划
+
+> 表格呈现权限点规划，仅定义权限点、可执行操作范围、数据范围（如：个人数据/全量数据），不定义具体角色；
+>
+> **权限点规划的基本原则：**查看类操作归集在【查看】一个权限点；编辑类操作归集在【编辑】一个权限点；导出类操作归集在【导出】一个权限点。
+
+| 权限点         | 操作范围           | 数据范围      |
+| -------------- | ------------------ | ------------- |
+| `[权限点名称]` | `[支持的操作名称]` | `[个人/全量]` |
+
+
+
+## 3. [模块名称]需求说明
+
+> 按模块循环撰写
+
+
+
+### 3.1 筛选查询区
+
+> 用表格呈现筛选字段、控件类型（如：文本输入/下拉选择/下拉多选/日期范围选择器等）、输入限制（明确长度/枚举值/默认值/必填性/其他条件依赖）、匹配规则（精准/模糊/范围）。
+
+支持多维度组合筛选，筛选条件变更后需点击“查询”按钮生效。
+
+| 筛选字段         | 类型         | 输入限制         | 匹配规则     |
+| :--------------- | :----------- | :--------------- | :----------- |
+| `[筛选字段名称]` | `[控件类型]` | `[输入限制内容]` | `[匹配规则]` |
+
+- **操作按钮**：
+
+  - **查询**：根据当前筛选条件刷新页面数据。
+
+  - **重置**：恢复所有筛选条件为默认值。
+
+    
+
+### 3.2 [子模块标题]卡片说明
+
+> 按页面里卡片形式**的子模块循环撰写，请严格按照一个子模块一个说明的要求进行撰写，严禁对同类型模块进行合并描述！！！
+
+- **指标列表**：
+
+  > 用表格呈现卡片里展示业务指标的业务价值、指标定义
+
+  | 指标名称     | 业务价值         | 指标定义                            |
+  | :----------- | :--------------- | :---------------------------------- |
+  | `[指标名称]` | `[指标业务价值]` | `[指标具体的定义（取数逻辑/范围）]` |
+
+
+
+- **交互说明**：
+
+  > 简述指标卡片模块的交互说明
+
+
+
+### 3.3 [子模块名称]图表说明
+
+> 按页面里**图表形式**的每个子模块独立循环撰写，请严格按照一个子模块一个说明的要求进行撰写，不要对同类型模块进行合并描述！！！
+>
+> 请识别模块是否包含多个部分，如：即包含图表部分、又包含指标卡片部分，须对每个部分分别进行描述！！！不可遗漏某个部分。
+
+- **[图表名称]说明**：
+
+  > 描述图表模型的图表内容
+
+  - **图表描述**：以`[图标形式]`展示`[图片内容描述]`
+
+  - **图表指标列表**：
+
+    > 用表格呈现图表里展示所有业务指标的业务价值、指标定义，不要用概括性的语言。
+
+    | 指标名称     | 业务价值         | 指标定义                            |
+    | :----------- | :--------------- | :---------------------------------- |
+    | `[指标名称]` | `[指标业务价值]` | `[指标具体的定义（取数逻辑/范围）]` |
+
+  - **交互说明：**
+
+    > 简述数据列表的操作说明，包括导出/排序/行操作说明
+
+- **[指标卡片名称]说明**：
+
+  > 描述图表模块的指标卡片内容，梳理出所有指标清单，不要进行概括性总结，不要对指标有遗漏！！
+
+  - **卡片指标列表**：
+
+    | 指标名称     | 业务价值         | 指标定义                            |
+    | :----------- | :--------------- | :---------------------------------- |
+    | `[指标名称]` | `[指标业务价值]` | `[指标具体的定义（取数逻辑/范围）]` |
+
+  - **交互说明**：
+
+    > 简述数据列表的操作说明，包括导出/排序/行操作说明
+
+- **[数据列表名称]说明**：
+
+  > 描述图表模块的数据列表内容，梳理出所有列表字段清单，不要进行概括性总结，不要对字段有遗漏！！
+
+  - **列表字段**：
+
+    | 列表字段     | 字段说明         |
+    | :----------- | :--------------- |
+    | `[字段名称]` | `[字段定义描述]` |
+
+  - **交互说明**：
+
+    > 简述数据列表的操作说明，包括导出/排序/行操作说明
+
+
+
+### 3.4 [子模块名称]数据列表
+
+> 按页面里列表形式**的子模块循环撰写
+
+以列表形式，按需展示详细的数据表格。
+
+- **列表字段**：
+
+  | 列表字段     | 字段说明         |
+  | :----------- | :--------------- |
+  | `[字段名称]` | `[字段定义描述]` |
+
+  
+
+- **交互说明**：
+
+  > 简述数据列表的操作说明，包括导出/排序/行操作
+
+
+
+## 4. 指标总览
+
+> 以表格的形式，梳理出整个数据看板的全量指标清单（**包含所有子模块的所有指标, 包括卡片、图表、数据列表**），描述指标名称、指标筛选维度（日期/场景/终端/用户身份/等）、数据来源（埋点/业务数据）、指标定义（取数逻辑/范围）。
+>
+> **重点**：一定要全面梳理完整整个数据看板，数据研发需要加工的所有指标内容，该部分内容将作为数据研发的需求清单。整理出来的指标总览需要满足数据看板的全部需求！不可以有遗漏！不可以有遗漏！不可以有遗漏！重点关注：
+>
+> - 提取每个页面的每个子模块中的指标；
+> - 提取指标的范围包含：指标卡片、图表（饼图/折线图/漏斗/等）、数据列表的等
+>
+> 完成梳理后务必对比所有数据看板模块，仔细检查每个指标是否都已经囊括？如果没有囊括，请进行补充！！！确保没有遗漏！！！
+
+| 指标名称     | 筛选维度                     | 数据来源         | 指标定义           |
+| ------------ | ---------------------------- | ---------------- | ------------------ |
+| `[指标名称]` | `[筛选维度，用无序列表展示]` | `[指标数据来源]` | `[指标的具体定义]` |
+
+
+
+## 5. 交互设计
+
+### 5.1 全局交互
+
+- **加载状态**：数据请求过程中需展示 Loading 状态。
+- **空状态**：无数据时需展示统一的 Empty 状态图。
+- **响应式**：页面需适配不同分辨率屏幕，保证内容不遮挡、不错位。

package/dist/deppon-prd-generator/template/user-frontend-prd-template.md

@@ -0,0 +1,59 @@
+# [页面名称] PRD (产品需求文档)
+
+> **生成时对照**：用户前台 / C 端活动类 PRD 生成前阅读本技能目录 `examples/user-frontend/prd.md`（及将交付原型时的 `prototype.html`）。
+
+> **交互原型链接（有 `prototype.html` 时必填）**：文首加入 `- **交互原型**：[打开 prototype.html](./prototype.html)`；仅无原型时删除。见 `SKILL.md`「PRD 与原型互链」。
+
+## 1. 引言
+
+### 1.1 背景
+
+> 简要说明该元素/页面的核心定位、解决的问题、用户价值（控制在50字左右）。
+
+```
+[需求背景内容]
+```
+
+### 1.2 用户角色
+
+> 简要说明不同类型的用户角色，包括但不限于：游客、个人用户、供方普通企业用户、供方会员企业用户、采方企业用户。
+
+| 用户角色 | 描述 | 使用场景 |
+|---------|------|---------|
+| `[角色1]` | `[角色描述]` | `[使用场景]` |
+| `[角色2]` | `[角色描述]` | `[使用场景]` |
+
+### 1.3 功能清单
+
+> 以表格形式梳理出所有模块、功能点及功能描述。
+
+| 模块             | 功能点         | 功能描述       |
+| ---------------- | -------------- | -------------- |
+| `[功能模块标题]` | `[功能点标题]` | `[功能点描述]` |
+
+
+## 2. [功能名称]需求说明
+
+> 按功能模块循环撰写
+
+### 2.1 [子模块名称]
+
+#### 2.1.1 功能描述
+
+> 详细描述该子模块的功能
+
+#### 2.1.2 交互流程
+
+> 描述用户操作流程，包括触发条件、操作步骤、反馈等
+
+1. **触发条件**：[用户操作，如点击按钮、进入页面等]
+2. **操作步骤**：
+   - 步骤1：[描述]
+   - 步骤2：[描述]
+3. **操作反馈**：
+   - 成功：[成功反馈，如弹窗提示、页面跳转等]
+   - 失败：[失败反馈，如错误提示等]
+
+### 2.2 [子模块名称]
+
+> 按同样格式描述其他子模块