# Persagy Vant AI

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

## 产品经理使用方式

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

### 1. 安装组件库

```bash
pnpm add persagy-vant
pnpm exec persagy-vant init
```

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

### 2. 直接在 Codex 中调用

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

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

### 3. 描述本次任务

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

### 获取最新版

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

```bash
pnpm up persagy-vant@latest
```

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

完整的可转发说明见：[Persagy Vant 组件库与 Skill 使用说明](./docs/markdown/product-manager-guide.zh-CN.md)。

## 包结构

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

## 开发

从仓库根目录执行：

```bash
pnpm install
pnpm dev:mobile
pnpm test:mobile
pnpm build:mobile
```

本包的构建和发布配置见 [package.json](./package.json)。

## 产物管理

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