Files

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

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

10 KiB

Raw Blame History

🎯 全能开发模板 - 智能开发中台 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秒上手)

方式一：一键全量展开

打开 AI开发引擎.md
拖入 AI 对话框
输入你的项目需求
AI 自动生成 1-10 全套文档

@AI引擎 请展开项目：
【项目名称】：私域银行 v2.0
【核心功能】：流量池管理、分润计算、一键提现
【预期规模】：日活 1 万

方式二：单目录精准展开

进入对应目录（如 4、前端）
打开 _智能展开.md
拖入 AI 对话框
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 卡若风格规则

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

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

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

5.2 云阿米巴商业规则

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

产品规则:
  - 页面必须有流量入口
  - 分润数据必须醒目显示
  - 提现操作必须简单一键

🔄 六、文档自生长机制

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 高效使用建议

先读后写: 开始新模块前，先读相关目录的现有文档
指令明确: 使用 @指令 格式，AI 响应更精准
上下文传递: 在复杂任务中，把前一步的输出作为下一步的输入
及时更新: 每次变更后要求 AI 同步更新相关文档

9.2 常见问题

问题	解决方案
AI 输出不符合规范	明确提醒"请按照卡若风格"
文档不同步	使用 `@联动更新` 指令
代码风格不统一	检查是否使用了 `_智能展开.md`
缺少图表	明确要求"请用 Mermaid 画图"

📞 十、联系与支持

问题反馈: 微信 28533368
模板更新: 关注 GitHub 仓库
使用交流: 扫码加入用户群

总结: 这套模板是你的 "数字化外脑"，把卡若的经验固化成 Prompt，让 AI 能随时按你的标准干活。用好它，你就是一支队伍。🚀

10 KiB Raw Blame History Unescape Escape