# Agents 工作流程说明

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

## 🧭 工作流程

### 场景 1：新建或更新原型（主场景）

| 步骤 | 说明 | 参考文档 |
|------|------|----------|
| ① 阅读规范与资料 | 系统规则 + 用户提供的资料与参考 | — |
| ② 需求对齐（可选） | 用户要求时启动，澄清需求，确认后才继续 | — |
| ③ 原型/组件设计 | 确定布局与视觉方向，产出 `spec.md` | `rules/design-guide.md` |
| ④ 开发与验收 | 根据 spec 实现原型/组件并完成验收 | `rules/development-guide.md` |

> **复杂原型管理**：优先通过普通原型目录或原型内部模块组织复杂页面，避免依赖特殊命名约定。

### 场景 2：资源管理

| 步骤 | 说明 | 参考文档 |
|------|------|----------|
| ① 阅读资源规则 | 查看资产目录与已有资源 | `rules/resource-management-guide.md` |
| ② 需求对齐（可选） | 澄清输出目标、范围与位置 | — |
| ③ 新增/更新资源 | 按规范放置、命名与维护 | 按类型分别参考下表 |

**资源类型与对应文档：**

| 资源类型 | 目录 | 参考文档 |
|----------|------|----------|
| 项目文档 | `src/docs/` | `rules/documentation-guide.md` |
| 主题 | `src/themes/` | `rules/theme-guide.md` |
| 数据表 | `src/database/` | `src/database/README.md` |
| 文档配图等附属资源 | `src/docs/assets/` | `rules/resource-management-guide.md` |

## ⚠️ 重要原则

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

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

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

4. **积极使用子代理（Sub-agent）**
   - 对于批量任务（如同时修改多个文件、批量生成资源）或复杂任务（如涉及多步骤流水线），应主动拆分为独立子任务并分派给子代理并行执行

## 项目结构
```
├── src/
│   ├── common/        # 公共类型和工具
│   ├── components/    # 组件目录
│   ├── prototypes/    # 原型目录
│   ├── docs/          # 项目文档
│   ├── themes/        # 主题配置
│   └── database/      # 页面可直接消费的数据表
└── skills/            # 项目技能与工作流
```