# VIB AI 产品方案展示库

这个项目用于维护 VIB AI 的产品方案、页面交互稿和业务功能流程。它不是重型 PRD 系统，而是一个轻量、实时更新、可交互的内部方案库。

## 项目用途

- 产品：查看完整功能方案、核心流程和产品体验。
- 设计：查看页面交互、状态页面和多平台差异。
- 研发：理解页面关系、业务流程和关键规则。
- Codex：长期协助维护目录、页面、功能流程和说明文档。

## 目录职责

```text
/
├── web/       # 页面级交互稿
├── feature/   # 业务功能级方案
└── README.md  # 当前项目说明
```

`web` 只负责页面原型。页面如果有不同状态，可以创建独立页面展示。

`feature` 负责业务功能。一个功能可以通过 iframe 串联多个 `web` 页面和状态页面。

## 维护原则

1. 页面始终维护最新版本，不额外增加状态标签。
2. 文档保持轻量，只写有助于理解方案和落地的信息。
3. 多状态页面在 `web` 下独立创建，方便被功能流程引用。
4. 业务功能目录只保留 `index.html` 和 `description.md`。
5. 不增加决策记录、复杂 manifest、拆散的 API/文案/状态文档。
6. 目录入口和 README 只做导航与维护说明，不承载完整 PRD。

## 推荐工作流

新增页面时：

1. 放到对应平台目录，例如 `web/app/`、`web/agent_web/`、`web/task_web/`。
2. 如果页面较多，按模块创建子目录，例如 `web/app/chat/`。
3. 如果页面有关键状态，创建独立状态页面，例如 `chat-empty.html`。
4. 更新对应平台 README 或目录页。

新增业务功能时：

1. 在 `feature/` 下创建业务功能目录，例如 `feature/credits/`。
2. 创建 `index.html`，用图文说明和 iframe 串联流程。
3. 创建 `description.md`，集中写详细产品描述和关键规则。
4. 在 `feature/README.md` 或 `feature/index.html` 中补充入口。

## Codex Skill

项目内维护规范 skill 位于：

```text
.codex/skills/vib-prd-maintainer/SKILL.md
```

后续使用 Codex 维护本项目时，应遵循该 skill 的规则：轻量维护、页面归 `web`、业务归 `feature`、多状态页面独立展示、功能说明集中在 `description.md`。