a27e3b8e43
Optimized the root .gitignore to exclude virtual environments, node modules, and temp folders to ensure clean and lightweight version tracking. Co-authored-by: Cursor <cursoragent@cursor.com>
65 lines
2.6 KiB
Markdown
65 lines
2.6 KiB
Markdown
{{PROJECT_INFO_SECTION}}
|
||
|
||
# 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/ # 项目技能与工作流
|
||
```
|