Files
karuo-ai/03_卡木(木)/木果_项目模板/开发模板/SKILL.md

14 KiB
Raw Blame History

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

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 云阿米巴商业检查

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

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

四、标准技术栈

卡若标准配置

前端:
  框架: 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、管理 @拆解任务 @更新进度 @甘特图 @生成复盘

六、使用流程

标准开发流程

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. 部署上线:一键生成部署脚本

七、输出质量标准

必须包含的元素

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

文档:
  - [ ] 必须有 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理解需求

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

步骤2读取模板

根据用户需求,读取对应的模板文件:

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

步骤3激活专家角色

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

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

步骤4生成内容

按照以下规范输出:

输出风格:
  语言: 大白话,直击要点
  结构: 结论→原因→步骤
  可视化: 必须包含 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 随时按标准输出完整项目。用好它,你就是一支队伍!🚀