---
name: 项目开发引擎
description: AI驱动的全栈项目开发中台。触发词：项目开发、快速开发、开发模板、生成项目、全栈开发、AI开发、展开项目、新建项目、项目生成。基于五行营销框架和多智能体协作，一键生成从需求到部署的完整项目文档和代码。
group: 木
triggers: 创建项目、初始化模板、脚手架
owner: 木果
version: "1.0"
updated: "2026-02-16"
---

# 🚀 项目开发引擎

AI驱动的全栈项目开发中台，30秒从想法到可执行的完整项目。

## 核心理念

这不是一堆文档，而是一套 **"AI 驱动的虚拟团队"**：

```
一个想法 → 拖入引擎 → 10个专家同时开工 → 完整项目输出
```

## 一、极速启动（3种方式）

### 方式1️⃣：一键全量展开（推荐）

```
@项目引擎 一键展开：

【项目名称】：私域银行 v2.0
【核心功能】：流量池管理、分润计算、一键提现
【目标用户】：厦门本地创业者
【预期规模】：日活 1 万
【开发周期】：30天
【技术偏好】：MongoDB + FastAPI + React
```

**自动输出**：
- ✅ 1-10 全套目录文档
- ✅ 完整技术选型方案
- ✅ 前后端代码框架
- ✅ 部署脚本
- ✅ 用户手册

### 方式2️⃣：单目录精准展开

```
@项目引擎 展开[N]目录：

展开目录4：为私域银行生成前端代码
展开目录5：生成完整API接口文档
展开目录7：设计MongoDB数据库
```

### 方式3️⃣：跨目录联动展开

```
@项目引擎 联动展开：

基于 [需求文档] 更新 [架构文档]
基于 [接口文档] 生成 [前端代码]
基于 [接口文档] 生成 [后端代码]
```

---

## 二、10个专家角色矩阵

```
┌─────────────────────────────────────────────────────────────┐
│                    AI 虚拟团队配置                           │
├─────────────────────────────────────────────────────────────┤
│ 1、需求 → CFO + 产品负责人                                   │
│    输出：业务流程图、用户故事、MVP清单、成本估算             │
│                                                             │
│ 2、架构 → CTO + 架构师                                       │
│    输出：系统架构图、技术选型表、模块拆分                     │
│                                                             │
│ 3、原型 → UI/UX 设计师                                       │
│    输出：页面结构、交互流程、iOS规范                         │
│                                                             │
│ 4、前端 → 前端技术专家                                       │
│    输出：React组件、Tailwind样式、TypeScript                 │
│                                                             │
│ 5、接口 → API 架构师                                         │
│    输出：RESTful API、请求响应、错误码                       │
│                                                             │
│ 6、后端 → Python 架构师                                      │
│    输出：FastAPI路由、业务逻辑、AI集成                       │
│                                                             │
│ 7、数据库 → DBA                                              │
│    输出：MongoDB集合、ER图、索引策略                         │
│                                                             │
│ 8、部署 → DevOps 运维                                        │
│    输出：Webhook脚本、Docker配置、运维手册                   │
│                                                             │
│ 9、手册 → 技术文档专家                                       │
│    输出：用户手册、FAQ、营销文案                             │
│                                                             │
│ 10、管理 → 高级 PM                                           │
│    输出：甘特图、执行表、风险矩阵                            │
└─────────────────────────────────────────────────────────────┘
```

---

## 三、核心能力

### 3.1 多智能体协作

基于最新 AI 研究成果的智能体协作架构：

```mermaid
graph TB
    subgraph 编排器
        O[任务分发与协调]
    end
    
    subgraph 智能体矩阵
        A1[📖 Reader<br/>需求理解]
        A2[🔍 Searcher<br/>技术选型]
        A3[✍️ Writer<br/>代码生成]
        A4[✅ Verifier<br/>质量校验]
    end
    
    O --> A1
    A1 --> A2
    A2 --> A3
    A3 --> A4
    A4 -->|通过| OUT[输出交付]
    A4 -->|不通过| A3
```

### 3.2 五行营销框架

卡若核心方法论，确保项目商业成功：

```
🥇 金（目标）: 目标人群 / 流量来源 / 品牌定位 / 核心指标
    ↓
💧 水（流程）: 用户路径 / 转化漏斗 / 关键节点 / 触发条件
    ↓
🌳 木（落地）: 产品形态 / 功能清单 / MVP边界 / 交付物
    ↓
🔥 火（分析）: 数据埋点 / 复盘指标 / 迭代方向 / 学习成长
    ↓
🌍 土（资源）: 技术资源 / 人力投入 / 预算分配 / 合作伙伴
```

### 3.3 云阿米巴商业检查

每个需求自动通过商业模式检查：

- [ ] **流量入口检查**：是否有明确的流量获取方式？
- [ ] **分润显性化检查**：合作方能否一眼看到赚了多少钱？
- [ ] **利益绑定检查**：是否分的是"不属于对方的钱"？

---

## 四、标准技术栈

### 卡若标准配置

```yaml
前端:
  框架: React 18+ / Next.js 14+ (App Router)
  UI: Shadcn UI + Vant UI + Tailwind CSS
  状态: React Query + Zustand
  语言: TypeScript (强制)

后端:
  框架: Python FastAPI
  数据库: MongoDB (含向量索引)
  AI: OpenAI / Gemini
  部署: Webhook + 宝塔 / Docker

规范:
  代码: 必须中文注释 + Type Hints
  交互: 必须骨架屏 + 转场动画
  安全: 禁止硬编码密钥、os.system()、rm -rf
```

---

## 五、快捷指令速查表

### 5.1 全局指令

| 指令 | 功能 | 示例 |
|:---|:---|:---|
| `@全量展开` | 一键生成1-10全套文档 | `@全量展开 私域银行项目` |
| `@展开[N]` | 展开指定目录 | `@展开5 生成API文档` |
| `@联动更新` | 基于变更同步所有文档 | `@联动更新 接口新增提现功能` |
| `@生成代码` | 生成代码框架 | `@生成代码 前端登录页面` |
| `@生成图表` | 生成Mermaid图 | `@生成图表 用户下单流程` |

### 5.2 各目录专属指令

| 目录 | 常用指令 |
|:---|:---|
| 1、需求 | `@拆解需求` `@用户故事` `@成本估算` `@MVP边界` |
| 2、架构 | `@技术选型` `@架构图` `@模块拆分` `@安全检查` |
| 3、原型 | `@页面结构` `@页面流程` `@iOS样式` `@骨架屏` |
| 4、前端 | `@生成页面` `@生成组件` `@生成Hook` `@样式优化` |
| 5、接口 | `@生成接口` `@接口详情` `@时序图` `@Mock数据` |
| 6、后端 | `@生成路由` `@生成服务` `@生成AI服务` `@安全检查` |
| 7、数据库 | `@生成集合` `@生成ER图` `@生成索引` `@向量配置` |
| 8、部署 | `@生成部署脚本` `@生成Nginx` `@生成Docker` |
| 9、手册 | `@生成手册` `@生成FAQ` `@生成文案` `@话术优化` |
| 10、管理 | `@拆解任务` `@更新进度` `@甘特图` `@生成复盘` |

---

## 六、使用流程

### 标准开发流程

```mermaid
graph LR
    A[需求输入] --> B[1需求分析]
    B --> C[2架构设计]
    C --> D[3原型设计]
    D --> E1[4前端开发]
    D --> E2[5接口定义]
    D --> E3[6后端开发]
    E2 --> F[7数据库设计]
    E1 --> G[8部署上线]
    E3 --> G
    F --> G
    G --> H[9用户手册]
    B --> I[10项目管理]
    I --> J[全程跟踪]
```

### 操作步骤

1. **启动引擎**：说出触发词 + 项目需求
2. **自动展开**：引擎读取模板，激活专家团队
3. **逐一生成**：按1-10顺序生成完整文档
4. **联动更新**：需求变更时自动同步相关文档
5. **代码生成**：基于文档生成可执行代码
6. **部署上线**：一键生成部署脚本

---

## 七、输出质量标准

### 必须包含的元素

每个输出必须符合以下标准：

```yaml
文档:
  - [ ] 必须有 Mermaid 图表
  - [ ] 必须有表格数据
  - [ ] 必须有版本号和日期
  - [ ] 必须有变更历史

代码:
  - [ ] 必须有中文注释
  - [ ] 必须有 TypeScript 类型
  - [ ] 必须有错误处理
  - [ ] 必须有骨架屏组件

商业:
  - [ ] 必须通过云阿米巴检查
  - [ ] 必须有成本估算
  - [ ] 必须有收益测算
  - [ ] 必须有流量入口
```

---

## 八、模板文件位置

引擎读取以下模板文件：

```
/Users/karuo/Documents/开发/1、开发模板/
├── AI开发引擎.md          ← 总控文件
├── 代码核心提取器.md       ← 项目分析工具
├── 模板使用说明书.md       ← 使用指南
│
├── 1、需求/_智能展开.md
├── 2、架构/_智能展开.md
├── 3、原型/_智能展开.md
├── 4、前端/_智能展开.md
├── 5、接口/_智能展开.md
├── 6、后端/_智能展开.md
├── 7、数据库/_智能展开.md
├── 8、部署/_智能展开.md
├── 9、手册/_智能展开.md
└── 10、项目管理/_智能展开.md
```

---

## 九、AI 执行规范

当用户触发此 Skill 时，你需要：

### 步骤1：理解需求

```yaml
角色: 全栈架构师 + 产品经理
行为:
  1. 询问或提取项目关键信息：
     - 项目名称
     - 核心功能（一句话）
     - 目标用户
     - 预期规模
     - 开发周期
     - 技术偏好
  2. 如果信息不全，主动追问
```

### 步骤2：读取模板

根据用户需求，读取对应的模板文件：

- **全量展开**：读取 `/Users/karuo/Documents/开发/1、开发模板/AI开发引擎.md`
- **单目录展开**：读取对应目录的 `_智能展开.md`
- **联动更新**：读取变更涉及的所有目录

### 步骤3：激活专家角色

根据目录激活对应专家角色：

```python
目录映射 = {
    1: "CFO + 产品负责人",
    2: "CTO + 架构师",
    3: "UI/UX 设计师",
    4: "前端技术专家",
    5: "API 架构师",
    6: "Python 架构师",
    7: "DBA",
    8: "DevOps 运维",
    9: "技术文档专家",
    10: "高级 PM"
}
```

### 步骤4：生成内容

按照以下规范输出：

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

输出格式:
  - 使用 Markdown
  - 代码块必须注明语言
  - 图表使用 Mermaid
  - 表格数据对齐

质量检查:
  - 必须通过云阿米巴商业检查
  - 必须符合卡若技术规范
  - 必须包含完整可执行代码
```

### 步骤5：联动更新

生成内容后，提示用户可以进行的下一步操作：

```
✅ 已生成 [目录X] 的完整文档

📍 建议下一步：
- 展开目录[X+1]：继续下一阶段
- 联动更新：基于本次变更更新相关文档
- 生成代码：基于文档生成可执行代码
```

---

## 十、示例对话

### 示例1：全量展开

**用户**：
```
@项目引擎 帮我快速生成一个私域分销系统
```

**AI**：
```
收到！让我先了解下项目的关键信息：

【项目名称】：私域分销系统
【核心功能】：？（请用一句话描述，例如：合作方管理、分润计算、一键提现）
【目标用户】：？（例如：本地创业者、实体店主）
【预期规模】：？（例如：日活500、月GMV10万）
【开发周期】：？（例如：30天MVP）

请补充这些信息，我将为你一键生成1-10全套开发文档 🚀
```

**用户**：
```
核心功能是合作方可以领取流量，客资自动分发，按单分润
目标用户是厦门本地创业者
预期日活1000，月GMV50万
30天完成MVP
```

**AI**：
```
完美！开始展开项目 🚀

[读取 AI开发引擎.md]
[激活全部10个专家角色]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📋 私域分销系统 v1.0 - 完整项目文档
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

## 一、需求文档（金）

### 1.1 项目背景
厦门本地创业者面临流量获取难、客资分发乱、分润不透明三大痛点...

[生成完整的1-10全套文档]
...
```

### 示例2：单目录展开

**用户**：
```
@项目引擎 展开4 生成私域银行的前端代码
```

**AI**：
```
收到！激活前端技术专家角色 ⚛️

[读取 4、前端/_智能展开.md]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚛️ 私域银行前端代码生成
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

### 技术栈
- React 18 + Next.js 14 (App Router)
- Shadcn UI + Tailwind CSS
- TypeScript
- React Query

### 目录结构
[生成完整的前端目录结构]

### 核心页面代码
[生成可执行的前端代码]
...
```

---

## 十一、注意事项

### ⚠️ 常见陷阱

- ❌ 需求不明确就开始生成代码
- ❌ 跳过成本估算环节
- ❌ 忽略云阿米巴商业检查
- ❌ 生成的代码缺少中文注释

### ✅ 最佳实践

- ✅ 先算账再动手（成本优先）
- ✅ 功能做减法（MVP 原则）
- ✅ 按1-10顺序逐步展开
- ✅ 变更后立即联动更新

---

## 十二、扩展能力

### 可选模块

用户可以根据需要加载额外的模块：

| 模块 | 功能 | 文件位置 |
|:---|:---|:---|
| 代码分析 | 分析现有项目、提取核心 | `代码核心提取器.md` |
| 部署自动化 | GitHub Webhook部署 | `8、部署/WEBHOOK部署的提示词.md` |
| 存客宝对接 | 私域系统集成 | `5、接口/存客宝对接规范.md` |

---

## 十三、版本历史

| 版本 | 日期 | 更新内容 |
|:---:|:---:|:---|
| v2.0 | 2026-01 | 融合多智能体协作 + RAG文档检索 |
| v1.0 | 2025-12 | 初始版本，基于五行营销框架 |

---

> **总结**: 这是卡若的 **"数字化外脑"**，把开发经验固化成 Prompt，让 AI 随时按标准输出完整项目。用好它，你就是一支队伍！🚀