persagy-vant 0.0.21

package/skills/use-persagy-vant/references/component-catalog.md

@@ -0,0 +1,31 @@
+# 基础组件目录
+
+本文件用于快速选型，不替代 API 文档。props、事件、插槽、样式变量和导入方式必须以 `src/<component>/README.zh-CN.md`、类型定义和 demo 为准。
+
+## 页面骨架与状态
+
+- `nav-bar`、`tabbar`、`tab`、`tabs`、`sidebar`：页面与分区导航。
+- `cell`、`cell-group`、`row`、`col`、`space`、`divider`：信息布局与分组。
+- `empty`、`loading`、`skeleton`、`overlay`、`pull-refresh`、`list`、`pagination`：加载、空态、刷新与列表分页。
+- `bottom-action-bar`、`action-bar`、`submit-bar`：固定操作区；不要自行实现 fixed footer。
+
+## 表单与通用选择
+
+- `form`、`field`：表单结构、校验、输入与只读选择入口。
+- `checkbox`、`radio`、`switch`、`stepper`、`rate`、`slider`：布尔、单选、多选与数值录入。
+- `picker`、`datetime-picker`、`calendar`、`area`、`cascader`、`tree-select`：普通选项、日期、地区、级联与树形数据选择。
+- `search`、`filter-tag`、`dropdown-menu`、`dropdown-item`：搜索与轻量筛选。
+
+## 内容与反馈
+
+- `card`、`tag`、`badge`、`notice-bar`、`image`、`icon`：内容展示与状态标识。
+- `popup`、`action-sheet`、`share-sheet`、`popover`：动作选择与自定义容器。
+- `dialog`、`toast`、`notify`：确认、短反馈与通知；不得重复封装确认弹窗或全局提示。
+- `swipe`、`swipe-item`、`swipe-cell`、`collapse`、`grid`、`index-bar`：浏览、滑动操作、折叠和网格内容。
+
+## 选型规则
+
+- 需要承载自定义表单/内容：使用 `popup`；仅确认操作：使用 `dialog`；短暂提示：使用 `toast` 或 `notify`。
+- 可分页的业务列表：组合 `list`、`pull-refresh`、`empty`、`loading`，不要手写重复加载状态。
+- 选择入口默认使用 `field` 或 `cell`，具体选择面板优先从 `business-component-catalog.md` 选择。
+- 页面有主操作时优先使用 `bottom-action-bar`；在表单提交语义明确时使用 `submit-bar`。

package/skills/use-persagy-vant/references/component-gap-template.md

@@ -0,0 +1,16 @@
+# 组件缺口说明模板
+
+在已有组件无法覆盖需求时使用本模板；不要在页面内新建替代组件。
+
+```md
+## 组件缺口说明
+
+- 场景：<用户要完成的业务任务>
+- 已检查组件：<组件名及不适用原因>
+- 缺失能力：<最小的交互/API/视觉缺口>
+- 建议组件名称：<建议名称；如无法确认则留空>
+- 最小输入数据：<数据结构示例>
+- 预期输出/事件：<选择值、确认事件等>
+- 影响页面：<当前页面及可能复用的页面>
+- 临时方案：<仅说明是否可调整已有流程，不编写新基础/业务组件>
+```

package/skills/use-persagy-vant/references/page-recipes.md

@@ -0,0 +1,30 @@
+# 页面配方
+
+配方限定页面结构，不替代具体组件 API。开始编码前先选择最接近的一项。
+
+## 创建/编辑业务单据
+
+1. `nav-bar` 放置标题和返回操作。
+2. `form` + `field` 组织输入与校验；选择字段仅作为触发器。
+3. 需要人员、位置、对象或物料时，接入对应 Persagy 业务组件。
+4. 使用 `bottom-action-bar` 放置保存、提交或次操作；提交中禁用重复点击。
+5. 成功使用 `toast`，离开未保存页面使用 `dialog` 确认。
+
+## 可筛选的业务列表
+
+1. 顶部使用 `search` 或已有的筛选触发入口。
+2. 工单场景使用 `work-order-filter`；其他复杂条件使用 `popup` + `form` + 现有选择组件。
+3. 使用 `pull-refresh` + `list` 呈现数据，首屏/分页加载使用 `loading`，无结果使用 `empty`。
+4. 列表项使用 `cell` 或 `card`；状态使用 `tag` 或 `badge`。
+
+## 详情与处理页
+
+1. 用 `cell-group`、`card`、`divider` 组织信息分组。
+2. 需要展开内容使用 `collapse`，需要图文使用 `image`，需要状态标记使用 `tag`/`badge`。
+3. 主要处理动作使用 `bottom-action-bar`；可能造成数据变更的操作先经 `dialog`。
+
+## 选择型流程
+
+1. 使用 `field` 或 `cell` 显示当前选择结果并触发面板。
+2. 使用业务组件完成选择；仅在通用场景选择 `picker`、`cascader`、`tree-select`、`calendar` 等。
+3. 使用对应 `change`、`confirm`、`select` 事件同步页面状态，不读取组件内部 DOM。

package/skills/use-persagy-vant/references/reuse-policy.md

@@ -0,0 +1,37 @@
+# 复用与验收规则
+
+## 必须遵守
+
+- 必须从 Persagy Vant 选择现有基础组件和业务组件；先查业务组件目录，再查基础组件目录。
+- 必须阅读目标组件 README 和 demo 后再使用 API。
+- 必须处理 loading、empty、error、disabled 或 submitting 等与页面类型相关的状态。
+- 必须在最终回复、PR 描述或交付说明中附上组件复用清单。
+
+## 禁止事项
+
+- 禁止重写已有的按钮、字段、表单、选择器、树、弹层、提示、列表分页、固定底栏或业务选择面板。
+- 禁止创建名称或功能与组件库现有能力近似的组件、wrapper 或临时复制品。
+- 禁止拷贝组件源码、依赖组件私有 DOM/class，或用 CSS 覆盖内部结构以改变交互。
+- 禁止臆造组件 props、事件、插槽、类型或主题变量。
+
+## 允许的页面代码
+
+- 接口调用、页面路由、业务状态、数据转换和权限判断。
+- 仅服务于当前页面的展示组合；不得将其抽成可替代组件库能力的通用组件。
+- 在公开 API、插槽、CSS 变量或文档明确的扩展点上做轻量样式定制。
+
+## 交付前自查
+
+```md
+## 组件复用清单
+- <组件名>：<承担的页面职责>
+- <组件名>：<承担的页面职责>
+
+## 页面状态
+- 加载：<处理方式>
+- 空数据：<处理方式>
+- 失败/提交中：<处理方式>
+
+## 组件缺口
+- 无；或见组件缺口说明。
+```

package/skills/use-persagy-vant/references/usage-patterns.md

@@ -0,0 +1,17 @@
+# 页面组合规则
+
+## 表单页
+
+以 `form` 作为校验与提交边界，用 `field` 承载输入或只读选择入口。选择型字段连接已有选择组件；提交中通过按钮的 loading/disabled 状态防止重复提交。底部主操作优先使用 `bottom-action-bar` 或 `submit-bar`。
+
+## 列表页
+
+组合 `pull-refresh`、`list`、`loading`、`empty` 表达首屏、刷新、分页、无数据和失败状态。筛选条件复杂时优先使用 `work-order-filter` 或 `popup` 承载已有表单组件，不将筛选逻辑分散在列表项内。
+
+## 详情页
+
+用 `cell-group`、`card`、`tag` 组织信息，页面级动作放在 `bottom-action-bar` 或 `action-bar`。危险或不可逆操作必须经 `dialog` 确认，并在完成后用 `toast` 或 `notify` 反馈。
+
+## 样式扩展
+
+先查目标组件的 `var.less` 与 `src/style/`。只通过公开变量或扩展点调整视觉；禁止依赖内部 DOM 层级、覆盖私有 class 或复制组件源码样式。