Files

卡若 b404bf546e chore: 以本地为准，上传全部并替换 GitHub

2026-02-03 11:36:53 +08:00

10 KiB

Raw Blame History

🚀 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 研究成果，本引擎采用多智能体协作模式：

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 卡若风格规则

# 输出风格
语言: 大白话，直击要点
结构: 结论→原因→步骤
可视化: 必须包含 Mermaid 图表
代码: 必须中文注释

# 技术规范
前端: React + Shadcn UI + Tailwind CSS + iOS 风格
后端: Python FastAPI + Type Hints + 异步优先
数据库: MongoDB 优先（含向量索引）
部署: Webhook 自动化 + 宝塔/Docker

# 安全规范
禁止: 硬编码密钥、os.system()、rm -rf
强制: 参数化查询、Type Hints、骨架屏

4.2 云阿米巴商业规则

# 核心逻辑
分钱原则: 分不属于对方的钱
价值绑定: 按创造价值分钱
流量锁定: 用稳定流量 + 便捷私域体系绑定合作方

# 产品规则
流量池: 页面必须有流量入口
分润显示: 让合作方一眼看到赚了多少钱
一键提现: 降低操作门槛

📊 五、输出模板库

5.1 需求文档模板

# [项目名称] 需求文档 v1.0

## 一、项目背景
[为什么做这个项目？解决什么痛点？]

## 二、目标用户
| 用户角色 | 核心诉求 | 使用场景 |
|:---|:---|:---|

## 三、功能清单 (MVP)
| 功能模块 | 子功能 | 优先级 | 验收标准 |
|:---|:---|:---:|:---|

## 四、业务流程
[Mermaid 流程图]

## 五、成功指标
- [ ] 核心指标 1
- [ ] 核心指标 2

5.2 架构文档模板

# [项目名称] 系统架构 v1.0

## 一、技术选型
| 层级 | 技术 | 选型理由 |
|:---|:---|:---|

## 二、系统架构图
[Mermaid C4/架构图]

## 三、模块拆分
| 模块 | 职责 | 依赖 |
|:---|:---|:---|

## 四、数据流
[Mermaid 序列图]

5.3 API 文档模板

# [项目名称] 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 版本控制

# 文档版本规则
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 是"分控"。可以单独使用某个目录的智能展开，也可以用本文件一键展开全部。

10 KiB Raw Blame History Unescape Escape