# Agents 工作流程说明

本项目为目标用户开发原型，需要 Agents 扮演产品经理、 UI/UX设计师和前端开发的复合角色。

## 🧭 工作流程

### 场景 1：新建或更新原型（核心流程）

1. **阅读规范与资料** → 系统规则 + 用户提供的资料与参考
2. **需求对齐（可选）** → 用户要求时启动，澄清需求，确认后才继续
3. **原型/组件设计** → 进入设计流程，确定布局与视觉方向并产出 `spec.md`
4. **开发与验收** → 根据 spec 实现原型/组件并完成验收
   - 原型可包含多个页面，也可采用单页结构

### 场景 2：原型资产管理

1. **阅读资产规则** → 查看资产目录与已有资源
2. **新增/更新资产** → 按规范放置、命名与维护

{{PROJECT_INFO_SECTION}}

## ⚠️ 重要原则

1. **文档与代码同步**
   - 修改代码时，必须同步更新对应的 `spec.md` 规格文档
   - 修改 `spec.md` 时，必须同步更新对应的代码实现

2. **完整阅读文档资料**
   - 必须仔细阅读用户提供的所有文档和资料
   - 必须查看上下文中提供的相关规则和参考文件

3. **自主完成所有操作**
   - 用户不懂开发技术，无法执行任何 CLI 命令
   - 不得省略验收流程

## 📄 详细文档

| 阶段 | 文档 | 用途 |
|------|------|------|
| 原型/组件设计 | `rules/design-guide.md` | 设计流程与规格文档产出 |
| 代码开发 | `rules/development-standards.md` | 代码规范和验收流程 |
| 资产管理 | `rules/asset-management.md` | 资产新增、引用与维护 |

## 项目结构
```
├── src/
│   ├── common/      # 公共类型和工具
│   ├── components/    # 组件目录
│   ├── prototypes/    # 原型目录
│   ├── docs/          # 项目文档
│   └── themes/        # 主题配置
└── assets/          # 原型资产
    ├── files/       # 文件资产
    └── database/    # 数据库
```