persagy-vant

Persagy Vant AI

Persagy 移动端 Vue 3 组件库。产品经理可通过 AI 编程工具复用统一的基础组件和业务组件，提升产品的视觉、交互与体验一致性。

产品经理使用方式

只使用这一条流程：在自己的产品项目安装组件库、初始化一次 Codex Skill，然后直接调用 $use-persagy-vant。无需下载或复制本仓库。

1. 安装组件库

pnpm add persagy-vant
pnpm exec persagy-vant init

初始化会在项目中创建 .agents/skills/use-persagy-vant/SKILL.md。它只引用 npm 包内的 Skill 内容，因此不会复制规范或造成版本分叉。

2. 直接在 Codex 中调用

$use-persagy-vant 根据当前 PRD 实现移动端页面

Skill 会自动读取 npm 包内的复用规则、组件目录、设计交互规范与组件 API 文档。

3. 描述本次任务

• 根据 PRD 开发：提供 PRD、原型说明或页面清单，并要求 AI 先列出页面结构、交互流程和拟复用的组件。
• 优化已有页面：提供页面路径或问题描述，并要求 AI 先列出问题、改造方案和拟替换的组件，再改代码。
• 明确指定组件：直接说“请使用 persagy-vant 的 <组件名> 实现 <业务场景>”，并要求 AI 先读取该组件 README 后实现。

获取最新版

组件库发布新版本后，在产品项目根目录执行：

pnpm up persagy-vant@latest

组件、组件文档和 Skill 会随 npm 包一起更新；已有的 .agents 入口会自动读取新版内容，无需再次初始化。仅当维护者通知入口机制有变时，才执行 pnpm exec persagy-vant init --force。

完整的可转发说明见：Persagy Vant 组件库与 Skill 使用说明。

包结构

src/       组件源码、单组件示例、测试与中英文 API 文档
docs/      组件站点与设计文档
skills/    随 npm 包分发的 AI Skill 正文与参考资料
bin/       初始化项目级 Codex Skill 的命令

开发

从仓库根目录执行：

pnpm install
pnpm dev:mobile
pnpm test:mobile
pnpm build:mobile

本包的构建和发布配置见 package.json。

产物管理

es/、lib/、site-dist/ 和 test/coverage/ 都是构建或测试产物。新文件默认不提交，由 CI 构建并用于发布；已经被 Git 跟踪的历史产物请在一次独立的清理提交中处理，不要与组件功能改动混合。