347 lines
10 KiB
Markdown
347 lines
10 KiB
Markdown
# 🚀 AI 开发引擎 (AI Development Engine) v2.0
|
||
|
||
> **核心定位**: 这是整个开发模板的"大脑"，一个基于多智能体协作的智能开发中台。
|
||
> **使用方式**: 将此文件拖入 AI 对话框，即可激活"全栈架构师"角色，自动拆解项目并联动所有目录。
|
||
> **项目管理 Skill**: 本模板内置 `dev-template-project-manager` Skill，自动管理项目进度、任务拆解、对话上下文存储。
|
||
|
||
---
|
||
|
||
## 🎯 项目管理 Skill 集成
|
||
|
||
本开发模板内置了 **项目管理专家 Skill** (`.cursor/skills/dev-template-project-manager/`)，提供：
|
||
|
||
| 能力 | 说明 |
|
||
|:---|:---|
|
||
| 📊 **项目进度管理** | 执行表、甘特图、燃尽图 |
|
||
| 📋 **需求任务拆解** | 自动将需求转化为可执行任务 |
|
||
| 💾 **对话上下文存储** | 跨对话保持项目状态 |
|
||
| 📝 **提示词库管理** | 存储和复用常用提示词 |
|
||
| 🔗 **文档联动更新** | 变更自动同步到相关文档 |
|
||
|
||
**快速开始**：
|
||
```
|
||
@项目管理 初始化项目工作区
|
||
【项目名称】：[项目名]
|
||
【项目描述】：[一句话描述]
|
||
【预期周期】：[开发周期]
|
||
```
|
||
|
||
详见 `.cursor/skills/dev-template-project-manager/SKILL.md`
|
||
|
||
---
|
||
|
||
## 🎯 引擎功能矩阵
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────────────────┐
|
||
│ AI 开发引擎 (总控) │
|
||
├─────────────────────────────────────────────────────────────────────────┤
|
||
│ 📥 输入层 │ 🧠 处理层 │ 📤 输出层 │
|
||
│ ───────────── │ ───────────── │ ───────────── │
|
||
│ · 需求描述 │ · 需求拆解引擎 │ · 完整项目文档 │
|
||
│ · 竞品/截图 │ · 架构设计引擎 │ · 代码框架 │
|
||
│ · 预算/时间 │ · 代码生成引擎 │ · 部署脚本 │
|
||
│ │ · 文档生成引擎 │ · 使用手册 │
|
||
└─────────────────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 🏗️ 一、快速启动：一键展开项目
|
||
|
||
### 1.1 极速启动指令
|
||
将以下内容复制到 AI 对话框，替换 `[项目描述]` 即可自动展开整个项目：
|
||
|
||
```
|
||
@AI引擎 请根据以下需求，自动展开完整项目文档：
|
||
|
||
【项目名称】：[填写项目名]
|
||
【核心功能】：[用一句话描述核心功能]
|
||
【目标用户】：[谁会用这个产品]
|
||
【预期规模】：[日活/并发/数据量]
|
||
【时间预算】：[开发周期]
|
||
【技术偏好】：[有无特定技术栈要求]
|
||
|
||
请按照 1-10 目录结构，逐一生成所有文档。
|
||
```
|
||
|
||
### 1.2 展开输出清单
|
||
AI 将自动生成以下全套文档：
|
||
|
||
| 序号 | 目录 | 自动生成内容 | 联动文件 |
|
||
|:---:|:---|:---|:---|
|
||
| 1 | 需求 | 业务流程图、用户故事、MVP 功能清单 | `业务需求.md` `成本.md` |
|
||
| 2 | 架构 | 系统架构图、技术选型表、模块拆分 | `系统架构.md` `技术选型.md` |
|
||
| 3 | 原型 | 页面结构、交互流程、UI 规范 | `原型设计规范.md` |
|
||
| 4 | 前端 | 组件树、页面代码、样式系统 | `前端开发规范.md` |
|
||
| 5 | 接口 | API 列表、请求响应示例、错误码 | `接口定义规范.md` |
|
||
| 6 | 后端 | 服务拆分、业务流程、AI 集成 | `后端开发规范.md` |
|
||
| 7 | 数据库 | ER 图、集合设计、索引策略 | `数据库管理规范.md` |
|
||
| 8 | 部署 | 部署脚本、CI/CD 配置、运维手册 | `项目程序提示词.md` |
|
||
| 9 | 手册 | 用户手册、FAQ、营销文案 | `使用手册提示词.md` |
|
||
| 10 | 管理 | 甘特图、执行表、风险矩阵 | `项目管理提示词.md` |
|
||
|
||
---
|
||
|
||
## 🧠 二、多智能体协作架构 (DocAgent)
|
||
|
||
基于最新 AI 研究成果，本引擎采用多智能体协作模式：
|
||
|
||
```mermaid
|
||
graph TB
|
||
subgraph Orchestrator[🎯 编排器]
|
||
O[任务分发与协调]
|
||
end
|
||
|
||
subgraph Agents[🤖 智能体矩阵]
|
||
A1[📖 Reader<br/>需求理解]
|
||
A2[🔍 Searcher<br/>上下文检索]
|
||
A3[✍️ Writer<br/>内容生成]
|
||
A4[✅ Verifier<br/>质量校验]
|
||
end
|
||
|
||
subgraph Output[📤 输出层]
|
||
D1[需求文档]
|
||
D2[架构文档]
|
||
D3[代码框架]
|
||
D4[部署脚本]
|
||
end
|
||
|
||
O --> A1
|
||
A1 --> A2
|
||
A2 --> A3
|
||
A3 --> A4
|
||
A4 --> Output
|
||
A4 -->|不通过| A3
|
||
```
|
||
|
||
### 智能体职责说明
|
||
|
||
| 智能体 | 角色 | 职责 | 对应目录 |
|
||
|:---:|:---|:---|:---|
|
||
| 📖 Reader | 需求分析师 | 理解输入、提取关键信息 | 1、需求 |
|
||
| 🔍 Searcher | 架构师 | 检索最佳实践、技术选型 | 2、架构 |
|
||
| ✍️ Writer | 全栈工程师 | 生成代码、文档、配置 | 3-8 目录 |
|
||
| ✅ Verifier | QA 工程师 | 校验一致性、安全性 | 9、10 目录 |
|
||
|
||
---
|
||
|
||
## ⚡ 三、智能展开指令集
|
||
|
||
### 3.1 按阶段展开
|
||
|
||
```
|
||
# 阶段一：需求与架构（战略层）
|
||
@AI引擎 展开阶段一：
|
||
- 生成业务流程图 (Mermaid)
|
||
- 生成用户故事卡片
|
||
- 生成技术选型对比表
|
||
- 生成系统架构图
|
||
|
||
# 阶段二：设计与接口（战术层）
|
||
@AI引擎 展开阶段二：
|
||
- 生成页面结构树
|
||
- 生成 API 接口文档
|
||
- 生成 ER 图
|
||
- 生成组件设计图
|
||
|
||
# 阶段三：编码与部署（执行层）
|
||
@AI引擎 展开阶段三：
|
||
- 生成前端代码框架
|
||
- 生成后端代码框架
|
||
- 生成部署脚本
|
||
- 生成运维手册
|
||
```
|
||
|
||
### 3.2 按目录单独展开
|
||
|
||
```
|
||
# 单独展开某个目录
|
||
@AI引擎 展开目录[N]：[项目上下文]
|
||
|
||
# 示例：
|
||
@AI引擎 展开目录5：为私域银行项目生成完整 API 接口文档
|
||
```
|
||
|
||
### 3.3 跨目录联动展开
|
||
|
||
```
|
||
# 联动展开（自动保持一致性）
|
||
@AI引擎 联动展开：
|
||
- 基于 [需求文档] 更新 [架构文档]
|
||
- 基于 [架构文档] 生成 [接口文档]
|
||
- 基于 [接口文档] 生成 [前端代码]
|
||
- 基于 [接口文档] 生成 [后端代码]
|
||
```
|
||
|
||
---
|
||
|
||
## 🔧 四、核心规则与约束
|
||
|
||
### 4.1 卡若风格规则
|
||
|
||
```yaml
|
||
# 输出风格
|
||
语言: 大白话，直击要点
|
||
结构: 结论→原因→步骤
|
||
可视化: 必须包含 Mermaid 图表
|
||
代码: 必须中文注释
|
||
|
||
# 技术规范
|
||
前端: React + Shadcn UI + Tailwind CSS + iOS 风格
|
||
后端: Python FastAPI + Type Hints + 异步优先
|
||
数据库: MongoDB 优先（含向量索引）
|
||
部署: Webhook 自动化 + 宝塔/Docker
|
||
|
||
# 安全规范
|
||
禁止: 硬编码密钥、os.system()、rm -rf
|
||
强制: 参数化查询、Type Hints、骨架屏
|
||
```
|
||
|
||
### 4.2 云阿米巴商业规则
|
||
|
||
```yaml
|
||
# 核心逻辑
|
||
分钱原则: 分不属于对方的钱
|
||
价值绑定: 按创造价值分钱
|
||
流量锁定: 用稳定流量 + 便捷私域体系绑定合作方
|
||
|
||
# 产品规则
|
||
流量池: 页面必须有流量入口
|
||
分润显示: 让合作方一眼看到赚了多少钱
|
||
一键提现: 降低操作门槛
|
||
```
|
||
|
||
---
|
||
|
||
## 📊 五、输出模板库
|
||
|
||
### 5.1 需求文档模板
|
||
|
||
```markdown
|
||
# [项目名称] 需求文档 v1.0
|
||
|
||
## 一、项目背景
|
||
[为什么做这个项目？解决什么痛点？]
|
||
|
||
## 二、目标用户
|
||
| 用户角色 | 核心诉求 | 使用场景 |
|
||
|:---|:---|:---|
|
||
|
||
## 三、功能清单 (MVP)
|
||
| 功能模块 | 子功能 | 优先级 | 验收标准 |
|
||
|:---|:---|:---:|:---|
|
||
|
||
## 四、业务流程
|
||
[Mermaid 流程图]
|
||
|
||
## 五、成功指标
|
||
- [ ] 核心指标 1
|
||
- [ ] 核心指标 2
|
||
```
|
||
|
||
### 5.2 架构文档模板
|
||
|
||
```markdown
|
||
# [项目名称] 系统架构 v1.0
|
||
|
||
## 一、技术选型
|
||
| 层级 | 技术 | 选型理由 |
|
||
|:---|:---|:---|
|
||
|
||
## 二、系统架构图
|
||
[Mermaid C4/架构图]
|
||
|
||
## 三、模块拆分
|
||
| 模块 | 职责 | 依赖 |
|
||
|:---|:---|:---|
|
||
|
||
## 四、数据流
|
||
[Mermaid 序列图]
|
||
```
|
||
|
||
### 5.3 API 文档模板
|
||
|
||
```markdown
|
||
# [项目名称] API 文档 v1.0
|
||
|
||
## 接口：[接口名称]
|
||
- **URL**: `/api/v1/xxx`
|
||
- **Method**: `POST`
|
||
- **Auth**: Bearer Token
|
||
|
||
### Request
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
|:---|:---|:---:|:---|
|
||
|
||
### Response
|
||
{
|
||
"code": 200,
|
||
"message": "success",
|
||
"data": { }
|
||
}
|
||
|
||
### 错误码
|
||
| code | message | 处理建议 |
|
||
|:---:|:---|:---|
|
||
```
|
||
|
||
---
|
||
|
||
## 🔄 六、自动更新机制
|
||
|
||
### 6.1 文档同步规则
|
||
|
||
```
|
||
触发条件 → 自动更新动作
|
||
─────────────────────────
|
||
需求变更 → 更新架构文档、接口文档、前后端代码
|
||
接口变更 → 更新前端调用、后端实现、API 文档
|
||
数据库变更 → 更新 ER 图、后端 Model、接口文档
|
||
部署配置变更 → 更新运维手册、启动脚本
|
||
```
|
||
|
||
### 6.2 版本控制
|
||
|
||
```yaml
|
||
# 文档版本规则
|
||
major.minor.patch
|
||
│ │ └── 小修小补（错别字、格式）
|
||
│ └──────── 功能迭代（新增接口、字段）
|
||
└────────────── 架构变更（技术栈、模块重构）
|
||
```
|
||
|
||
---
|
||
|
||
## 🎮 七、快捷指令速查表
|
||
|
||
| 指令 | 功能 | 示例 |
|
||
|:---|:---|:---|
|
||
| `@全量展开` | 展开所有 1-10 目录 | `@全量展开 私域银行项目` |
|
||
| `@展开[N]` | 展开指定目录 | `@展开5 生成 API 文档` |
|
||
| `@联动更新` | 基于变更同步文档 | `@联动更新 接口新增了 /api/v1/withdraw` |
|
||
| `@生成代码` | 生成代码框架 | `@生成代码 前端登录页面` |
|
||
| `@生成图表` | 生成 Mermaid 图 | `@生成图表 用户下单流程` |
|
||
| `@复盘总结` | 生成项目复盘 | `@复盘总结 Q1 迭代` |
|
||
|
||
---
|
||
|
||
## 📎 附录：目录索引
|
||
|
||
| 目录 | 智能展开文件 | 角色 |
|
||
|:---|:---|:---|
|
||
| 1、需求 | `_智能展开.md` | CFO + 产品负责人 |
|
||
| 2、架构 | `_智能展开.md` | CTO + 架构师 |
|
||
| 3、原型 | `_智能展开.md` | UI/UX 设计师 |
|
||
| 4、前端 | `_智能展开.md` | 前端主程 |
|
||
| 5、接口 | `_智能展开.md` | API 架构师 |
|
||
| 6、后端 | `_智能展开.md` | Python 架构师 |
|
||
| 7、数据库 | `_智能展开.md` | DBA |
|
||
| 8、部署 | `_智能展开.md` | DevOps 运维 |
|
||
| 9、手册 | `_智能展开.md` | 技术文档专家 |
|
||
| 10、项目管理 | `_智能展开.md` | 高级 PM |
|
||
|
||
---
|
||
|
||
> **使用提示**: 本文件是"总控"，每个目录下的 `_智能展开.md` 是"分控"。可以单独使用某个目录的智能展开，也可以用本文件一键展开全部。
|