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>
2.6 KiB
2.6 KiB
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 |
⚠️ 重要原则
-
文档与代码同步
- 修改代码时，必须同步更新对应的
spec.md规格文档 - 修改
spec.md时，必须同步更新对应的代码实现
- 修改代码时，必须同步更新对应的
-
完整阅读文档资料
- 必须仔细阅读用户提供的所有文档和资料
- 必须查看上下文中提供的相关规则和参考文件
-
自主完成所有操作
- 用户不懂开发技术，无法执行任何 CLI 命令
- 不得省略验收流程
-
积极使用子代理（Sub-agent）
- 对于批量任务（如同时修改多个文件、批量生成资源）或复杂任务（如涉及多步骤流水线），应主动拆分为独立子任务并分派给子代理并行执行
项目结构
├── src/
│ ├── common/ # 公共类型和工具
│ ├── components/ # 组件目录
│ ├── prototypes/ # 原型目录
│ ├── docs/ # 项目文档
│ ├── themes/ # 主题配置
│ └── database/ # 页面可直接消费的数据表
└── skills/ # 项目技能与工作流