313 lines
10 KiB
Markdown
313 lines
10 KiB
Markdown
# 🎯 全能开发模板 - 智能开发中台 v2.0
|
||
|
||
> **核心理念**: 这不是一堆文档，而是一套 **"AI 驱动的虚拟团队"**
|
||
> **使用心法**: **"拖入即激活"** - 把文件拖入 AI 对话框，AI 瞬间变身该领域专家
|
||
> **最新技术**: 融合 DocAgent 多智能体协作 + RAG 文档检索 + 自动化工作流
|
||
> **内置 Skill**: 项目管理专家 Skill，自动管理进度、任务、对话上下文
|
||
|
||
---
|
||
|
||
## 🆕 内置项目管理 Skill
|
||
|
||
本模板内置了 **项目管理专家 Skill** (`.cursor/skills/dev-template-project-manager/`)：
|
||
|
||
```
|
||
📁 .cursor/skills/dev-template-project-manager/
|
||
├── 📄 SKILL.md ← 主技能文件（AI 自动读取）
|
||
├── 📄 workflow.md ← 工作流详解
|
||
├── 📄 templates.md ← 文档模板库
|
||
├── 📄 commands.md ← 完整指令参考
|
||
└── 📄 integration.md ← 与开发模板集成指南
|
||
```
|
||
|
||
**核心功能**：
|
||
- 📊 项目进度管理（执行表、甘特图）
|
||
- 📋 需求自动拆解为任务
|
||
- 💾 对话上下文跨会话存储
|
||
- 📝 提示词库管理
|
||
- 🔗 文档联动自动更新
|
||
|
||
**快速激活**：每次使用开发模板时，AI 会自动读取此 Skill 并激活项目管理能力。
|
||
|
||
---
|
||
|
||
## 🚀 一、极速启动 (30秒上手)
|
||
|
||
### 方式一：一键全量展开
|
||
1. 打开 `AI开发引擎.md`
|
||
2. 拖入 AI 对话框
|
||
3. 输入你的项目需求
|
||
4. AI 自动生成 1-10 全套文档
|
||
|
||
```
|
||
@AI引擎 请展开项目：
|
||
【项目名称】：私域银行 v2.0
|
||
【核心功能】：流量池管理、分润计算、一键提现
|
||
【预期规模】：日活 1 万
|
||
```
|
||
|
||
### 方式二：单目录精准展开
|
||
1. 进入对应目录（如 `4、前端`）
|
||
2. 打开 `_智能展开.md`
|
||
3. 拖入 AI 对话框
|
||
4. AI 变身该领域专家
|
||
|
||
---
|
||
|
||
## 🗂️ 二、目录全景图
|
||
|
||
```
|
||
📁 开发模板/
|
||
│
|
||
├── 📄 AI开发引擎.md ← 🧠 总控：一键展开全部
|
||
├── 📄 代码核心提取器.md ← 🔬 分析项目、提取核心、清理文件
|
||
├── 📄 模板使用说明书.md ← 📖 你正在看的这个
|
||
│
|
||
├── 📁 1、需求/ ← 💰 CFO + 产品负责人
|
||
│ ├── _智能展开.md ← 🔮 智能展开提示词
|
||
│ ├── 业务需求.md
|
||
│ ├── 技术需求.md
|
||
│ └── 成本.md
|
||
│
|
||
├── 📁 2、架构/ ← 🏗️ CTO + 架构师
|
||
│ ├── _智能展开.md
|
||
│ ├── 系统架构.md
|
||
│ └── 技术选型.md
|
||
│
|
||
├── 📁 3、原型/ ← 🎨 UI/UX 设计师
|
||
│ ├── _智能展开.md
|
||
│ └── 原型设计规范.md
|
||
│
|
||
├── 📁 4、前端/ ← ⚛️ 前端技术专家
|
||
│ ├── _智能展开.md
|
||
│ └── 前端开发规范.md
|
||
│
|
||
├── 📁 5、接口/ ← 🔌 API 架构师
|
||
│ ├── _智能展开.md
|
||
│ └── 接口定义规范.md
|
||
│
|
||
├── 📁 6、后端/ ← 🐍 Python 架构师
|
||
│ ├── _智能展开.md
|
||
│ └── 后端开发规范.md
|
||
│
|
||
├── 📁 7、数据库/ ← 💾 DBA
|
||
│ ├── _智能展开.md
|
||
│ └── 数据库管理规范.md
|
||
│
|
||
├── 📁 8、部署/ ← 🚀 DevOps 运维
|
||
│ ├── _智能展开.md
|
||
│ └── 项目程序提示词.md
|
||
│
|
||
├── 📁 9、手册/ ← 📚 技术文档专家
|
||
│ ├── _智能展开.md
|
||
│ └── 使用手册提示词.md
|
||
│
|
||
└── 📁 10、项目管理/ ← 📊 高级 PM
|
||
├── _智能展开.md
|
||
└── 项目管理提示词.md
|
||
```
|
||
|
||
---
|
||
|
||
## 🎮 三、核心操作指南
|
||
|
||
### 3.1 按场景选择入口
|
||
|
||
| 我要做什么 | 使用哪个文件 | AI 会帮我 |
|
||
|:---|:---|:---|
|
||
| **新项目启动** | `AI开发引擎.md` | 一键生成全套文档 |
|
||
| **分析现有项目** | `代码核心提取器.md` | 提取核心代码、清理无关文件 |
|
||
| **算账/定功能** | `1、需求/_智能展开.md` | 成本估算、MVP 边界 |
|
||
| **技术选型** | `2、架构/_智能展开.md` | 架构图、技术栈对比 |
|
||
| **画页面** | `3、原型/_智能展开.md` | 页面结构、iOS 规范 |
|
||
| **写前端代码** | `4、前端/_智能展开.md` | React 组件、Tailwind |
|
||
| **定义接口** | `5、接口/_智能展开.md` | API 文档、错误码 |
|
||
| **写后端代码** | `6、后端/_智能展开.md` | FastAPI、AI 集成 |
|
||
| **设计数据库** | `7、数据库/_智能展开.md` | ER 图、向量索引 |
|
||
| **部署上线** | `8、部署/_智能展开.md` | 脚本、CI/CD |
|
||
| **写用户手册** | `9、手册/_智能展开.md` | 傻瓜式文档、营销文案 |
|
||
| **管理项目** | `10、项目管理/_智能展开.md` | 甘特图、执行表 |
|
||
|
||
### 3.2 联动组合拳
|
||
|
||
不要只用一个文件，学会**组合**使用：
|
||
|
||
**场景：我要做一个 AI 客服功能**
|
||
|
||
```
|
||
第一步（定钱）: 拖入 1、需求/_智能展开.md
|
||
→ 问："加这个功能要多少 API 成本？"
|
||
|
||
第二步（定架构）: 拖入 2、架构/_智能展开.md
|
||
→ 问："用 LangChain 还是原生 API？"
|
||
|
||
第三步（定接口）: 拖入 5、接口/_智能展开.md
|
||
→ 指令："@生成接口 AI 对话模块"
|
||
|
||
第四步（落地）: 拖入 10、项目管理/_智能展开.md
|
||
→ 指令："把这个功能拆解成任务"
|
||
```
|
||
|
||
---
|
||
|
||
## 🔮 四、智能展开指令速查表
|
||
|
||
### 4.1 全局指令
|
||
|
||
| 指令 | 功能 | 在哪用 |
|
||
|:---|:---|:---|
|
||
| `@全量展开 [项目]` | 一键生成 1-10 全套文档 | AI开发引擎 |
|
||
| `@展开[N] [内容]` | 展开指定目录 | AI开发引擎 |
|
||
| `@联动更新` | 基于变更同步所有文档 | AI开发引擎 |
|
||
| `@全量分析 [路径]` | 分析项目、提取核心代码 | 代码核心提取器 |
|
||
| `@清理建议` | 生成可删除文件列表 | 代码核心提取器 |
|
||
| `@快速理解 [路径]` | 快速理解项目架构 | 代码核心提取器 |
|
||
|
||
### 4.2 各目录专属指令
|
||
|
||
| 目录 | 常用指令 |
|
||
|:---|:---|
|
||
| 1、需求 | `@拆解需求` `@用户故事` `@成本估算` `@MVP边界` |
|
||
| 2、架构 | `@技术选型` `@架构图` `@模块拆分` `@安全检查` |
|
||
| 3、原型 | `@页面结构` `@页面流程` `@iOS样式` `@骨架屏` |
|
||
| 4、前端 | `@生成页面` `@生成组件` `@生成Hook` `@样式优化` |
|
||
| 5、接口 | `@生成接口` `@接口详情` `@时序图` `@Mock数据` |
|
||
| 6、后端 | `@生成路由` `@生成服务` `@生成AI服务` `@安全检查` |
|
||
| 7、数据库 | `@生成集合` `@生成ER图` `@生成索引` `@向量配置` |
|
||
| 8、部署 | `@生成部署脚本` `@生成Nginx` `@生成Docker` |
|
||
| 9、手册 | `@生成手册` `@生成FAQ` `@生成文案` `@话术优化` |
|
||
| 10、管理 | `@拆解任务` `@更新进度` `@甘特图` `@生成复盘` |
|
||
|
||
---
|
||
|
||
## 🏛️ 五、核心规则（必读）
|
||
|
||
### 5.1 卡若风格规则
|
||
|
||
```yaml
|
||
输出风格:
|
||
语言: 大白话，直击要点
|
||
结构: 结论→原因→步骤
|
||
可视化: 必须包含 Mermaid 图表
|
||
代码: 必须中文注释
|
||
|
||
技术规范:
|
||
前端: React + Shadcn UI + Tailwind CSS + iOS 风格
|
||
后端: Python FastAPI + Type Hints + 异步优先
|
||
数据库: MongoDB 优先（含向量索引）
|
||
部署: Webhook 自动化 + 宝塔/Docker
|
||
|
||
安全红线:
|
||
禁止: 硬编码密钥、os.system()、rm -rf
|
||
强制: 参数化查询、Type Hints、骨架屏
|
||
```
|
||
|
||
### 5.2 云阿米巴商业规则
|
||
|
||
```yaml
|
||
分钱原则: 分不属于对方的钱
|
||
价值绑定: 按创造价值分钱
|
||
流量锁定: 用稳定流量 + 便捷私域体系绑定合作方
|
||
|
||
产品规则:
|
||
- 页面必须有流量入口
|
||
- 分润数据必须醒目显示
|
||
- 提现操作必须简单一键
|
||
```
|
||
|
||
---
|
||
|
||
## 🔄 六、文档自生长机制
|
||
|
||
### 6.1 更新规则
|
||
|
||
```
|
||
触发条件 → 自动更新动作
|
||
─────────────────────────
|
||
需求变更 → 更新架构、接口、前后端、执行表
|
||
接口变更 → 更新前端调用、后端实现、API 文档
|
||
数据库变更 → 更新 ER 图、后端 Model
|
||
代码完成 → 更新执行表状态为 ✅
|
||
```
|
||
|
||
### 6.2 同步指令
|
||
|
||
```
|
||
# 确定了数据库结构后
|
||
@联动 数据库→后端：基于 ER 图生成 Pydantic 模型
|
||
|
||
# 完成了后端开发后
|
||
@联动 后端→执行表：更新后端任务状态为完成
|
||
|
||
# 需求变更后
|
||
@联动 需求→全量：基于新需求更新所有相关文档
|
||
```
|
||
|
||
---
|
||
|
||
## 📊 七、权限与责任
|
||
|
||
| 目录 | 维护责任人 | 谁不能乱动 |
|
||
|:---|:---|:---|
|
||
| 1、需求 / 10、管理 | **卡若 (老板/PM)** | 开发人员（只读） |
|
||
| 2、架构 / 5、接口 | **架构师** | 非技术人员 |
|
||
| 4、前端 / 6、后端 | **对应开发** | 非本岗位人员 |
|
||
| 8、部署 | **运维/核心开发** | **所有人**（涉及密钥） |
|
||
|
||
---
|
||
|
||
## 🧠 八、最新 AI 技术融合
|
||
|
||
### 8.1 多智能体协作 (DocAgent)
|
||
|
||
本模板采用多智能体协作架构：
|
||
|
||
```
|
||
📖 Reader (需求理解) → 🔍 Searcher (上下文检索)
|
||
→ ✍️ Writer (内容生成) → ✅ Verifier (质量校验)
|
||
```
|
||
|
||
### 8.2 RAG 文档增强
|
||
|
||
- 支持 Gemini File Search 全托管 RAG
|
||
- MongoDB Atlas Vector Search 向量检索
|
||
- 自动从代码/文档/历史中提取上下文
|
||
|
||
### 8.3 自动化工作流
|
||
|
||
- GitHub Webhook 自动触发部署
|
||
- 文档变更自动同步
|
||
- 代码生成自动包含测试
|
||
|
||
---
|
||
|
||
## 💡 九、使用技巧
|
||
|
||
### 9.1 高效使用建议
|
||
|
||
1. **先读后写**: 开始新模块前，先读相关目录的现有文档
|
||
2. **指令明确**: 使用 `@指令` 格式，AI 响应更精准
|
||
3. **上下文传递**: 在复杂任务中，把前一步的输出作为下一步的输入
|
||
4. **及时更新**: 每次变更后要求 AI 同步更新相关文档
|
||
|
||
### 9.2 常见问题
|
||
|
||
| 问题 | 解决方案 |
|
||
|:---|:---|
|
||
| AI 输出不符合规范 | 明确提醒"请按照卡若风格" |
|
||
| 文档不同步 | 使用 `@联动更新` 指令 |
|
||
| 代码风格不统一 | 检查是否使用了 `_智能展开.md` |
|
||
| 缺少图表 | 明确要求"请用 Mermaid 画图" |
|
||
|
||
---
|
||
|
||
## 📞 十、联系与支持
|
||
|
||
- **问题反馈**: 微信 28533368
|
||
- **模板更新**: 关注 GitHub 仓库
|
||
- **使用交流**: 扫码加入用户群
|
||
|
||
---
|
||
|
||
> **总结**: 这套模板是你的 **"数字化外脑"**，把卡若的经验固化成 Prompt，让 AI 能随时按你的标准干活。用好它，你就是一支队伍。🚀
|