persagy-vant 0.0.22 → 0.0.23
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +41 -7
- package/package.json +1 -1
- package/skills/use-persagy-vant/SKILL.md +2 -2
package/README.md
CHANGED
|
@@ -1,6 +1,46 @@
|
|
|
1
1
|
# Persagy Vant AI
|
|
2
2
|
|
|
3
|
-
Persagy 移动端 Vue 3
|
|
3
|
+
Persagy 移动端 Vue 3 组件库。产品经理可通过 AI 编程工具复用统一的基础组件和业务组件，提升产品的视觉、交互与体验一致性。
|
|
4
|
+
|
|
5
|
+
## 产品经理使用方式
|
|
6
|
+
|
|
7
|
+
只使用这一条流程：在**自己的产品项目**安装组件库，再让 AI 读取包内的 Skill。无需下载或复制本仓库。
|
|
8
|
+
|
|
9
|
+
### 1. 安装组件库
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
pnpm add persagy-vant
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
### 2. 每次新开 AI 会话先发送统一指令
|
|
16
|
+
|
|
17
|
+
```text
|
|
18
|
+
请先读取并严格执行 node_modules/persagy-vant/skills/use-persagy-vant/SKILL.md。
|
|
19
|
+
|
|
20
|
+
本项目所有移动端 UI 和业务选择能力必须优先复用 persagy-vant；
|
|
21
|
+
不要自行实现组件库已有的组件、交互或样式。
|
|
22
|
+
实现前先阅读所用组件在 node_modules/persagy-vant/es/<组件名>/README.zh-CN.md 中的 API 和示例。
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
这套方式兼容 Codex、Cursor、Claude Code、Windsurf、Copilot 等可读取项目文件的 AI 编程工具。
|
|
26
|
+
|
|
27
|
+
### 3. 描述本次任务
|
|
28
|
+
|
|
29
|
+
- **根据 PRD 开发**：提供 PRD、原型说明或页面清单，并要求 AI 先列出页面结构、交互流程和拟复用的组件。
|
|
30
|
+
- **优化已有页面**：提供页面路径或问题描述，并要求 AI 先列出问题、改造方案和拟替换的组件，再改代码。
|
|
31
|
+
- **明确指定组件**：直接说“请使用 persagy-vant 的 `<组件名>` 实现 `<业务场景>`”，并要求 AI 先读取该组件 README 后实现。
|
|
32
|
+
|
|
33
|
+
### 获取最新版
|
|
34
|
+
|
|
35
|
+
组件库发布新版本后，在产品项目根目录执行：
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
pnpm up persagy-vant
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
然后在下一次 AI 会话重新发送“统一指令”。组件、组件文档和 Skill 会随 npm 包一起更新。
|
|
42
|
+
|
|
43
|
+
完整的可转发说明见：[产品经理 AI 开发使用说明](./docs/markdown/product-manager-guide.zh-CN.md)。
|
|
4
44
|
|
|
5
45
|
## 仓库结构
|
|
6
46
|
|
|
@@ -22,12 +62,6 @@ pnpm build
|
|
|
22
62
|
|
|
23
63
|
常用命令与发布配置见 [package.json](./package.json)。
|
|
24
64
|
|
|
25
|
-
## 使用 Skill
|
|
26
|
-
|
|
27
|
-
仓库内的 [use-persagy-vant](./skills/use-persagy-vant/SKILL.md) 用于在 Vue 3 移动端页面中选择、组合和接入 Persagy Vant 组件。
|
|
28
|
-
|
|
29
|
-
Skill 与组件库版本应一同评审和发布：凡是组件导入方式、关键 API 或设计变量发生变更，都需要同步更新 Skill 的引用资料。
|
|
30
|
-
|
|
31
65
|
## 产物管理
|
|
32
66
|
|
|
33
67
|
`es/`、`lib/`、`site-dist/` 和 `test/coverage/` 都是构建或测试产物。新文件默认不提交，由 CI 构建并用于发布；已经被 Git 跟踪的历史产物请在一次独立的清理提交中处理，不要与组件功能改动混合。
|
package/package.json
CHANGED
|
@@ -11,7 +11,7 @@ description: 使用 Persagy Vant 为 Vue 3 移动端业务页面规划、实现
|
|
|
11
11
|
|
|
12
12
|
1. 阅读 `references/reuse-policy.md`，确认复用边界与禁止项。
|
|
13
13
|
2. 阅读 `references/business-component-catalog.md`，按用户任务先确定业务组件；再从 `references/component-catalog.md` 补齐基础组件。
|
|
14
|
-
3. 阅读每个被选中组件的 README 和 demo
|
|
14
|
+
3. 阅读每个被选中组件的 README 和 demo：使用 `node_modules/persagy-vant/es/<component>/README.zh-CN.md`。API、事件、插槽和导入方式均以这些资料为准。
|
|
15
15
|
4. 按 `references/page-recipes.md` 组合页面，补齐加载、空数据、错误、禁用和提交中状态。
|
|
16
16
|
5. 使用组件提供的 props、事件、插槽、Less 变量或公开 class 扩展点；不得复制组件内部 DOM、样式或私有逻辑。
|
|
17
17
|
6. 输出或提交前，按 `references/reuse-policy.md` 完成自查，并附上“组件复用清单”。
|
|
@@ -24,6 +24,6 @@ description: 使用 Persagy Vant 为 Vue 3 移动端业务页面规划、实现
|
|
|
24
24
|
|
|
25
25
|
## 资料边界
|
|
26
26
|
|
|
27
|
-
-
|
|
27
|
+
- 已安装包中的 `node_modules/persagy-vant/es/<component>/README.zh-CN.md`，连同类型定义和 demo，是组件 API 的唯一事实来源。
|
|
28
28
|
- `references/` 用于选型、复用规则与页面组合，不能据此编造不存在的 props 或事件。
|
|
29
29
|
- 当前目录是对外分发版本；随 `persagy-vant` 发布版本一起更新。组件库维护、扩展或新增组件不属于本 Skill 的授权范围。
|