菜单
项目架构与选型技能。当用户开始新项目、需要技术选型、系统设计、或遇到架构问题时自动激活。 触发词：新项目、技术选型、架构设计、系统设计、高并发、高可用、 微服务、数据库设计、项目结构、技术方案、重构、性能瓶颈、 架构评审、系统重构、高可用设计、容量规划、系统架构、架构咨询、性能瓶颈分析。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
前端开发全栈技能。当用户开发网页、小程序、H5、APP界面时自动激活。 触发词：前端、页面、组件、Vue、React、小程序、uni-app、CSS、Tailwind、TypeScript、 H5、微信小程序、响应式、动画、表单、列表、登录页、首页、详情页、Dashboard。
215个AI智能体角色库，覆盖17个部门。当用户开发项目需要特定角色能力时自动激活， 推荐最匹配的智能体角色来辅助开发。 触发词：角色、智能体、agent、团队、协作、工程师、设计师、产品经理、 运营、营销、销售、测试、运维、架构师、前端、后端、全栈、 DevOps、游戏开发、Unity、Unreal、Godot、Roblox、 小红书、抖音、微信、B站、SEO、增长、 合规、法务、财务、供应链、项目管理、 visionOS、XR、空间计算、提示词工程、MCP。
后端开发技能。当用户开发服务器、接口、数据库、业务逻辑时自动激活。 触发词：后端、接口、API、数据库、服务器、登录、认证、权限、CRUD、 Node.js、Python、Java、Go、RESTful、GraphQL、Redis、消息队列、微服务。
免费API+免费数据库+免费存储资源速查。当用户需要接入第三方服务、 查找API、Mock数据、AI能力、选择数据库、存储方案时自动激活。 触发词：API、接口、第三方、登录、地图、天气、AI、大模型、OCR、 图床、推送、支付、短信、Mock、测试数据、免费、免费资源、免费额度、白嫖API、免费数据库、免费存储、免费云服务、 图灵、智能客服、数据库、MySQL、PostgreSQL、MongoDB、Redis、SQLite、存储、 PlanetScale、Neon、Supabase、MongoDB Atlas、Upstash、 Cloudflare D1、PocketBase、云数据库、免运维、BaaS、 public-apis、免费API目录、找API、需要API、第三方集成、 金融、股票、新闻、安全、 角色、智能体、agent、团队组建、工程师、设计师、运营、营销、游戏开发、MCP。
全栈开发技能。当用户需要从零搭建完整项目、快速MVP验证、或同时涉及前后端时自动激活。 触发词：全栈、从零开始、MVP、快速原型、完整项目、Supabase、 Serverless、BaaS、部署、上线、Vercel、Cloudflare。
移动端开发技能。当用户开发APP、移动应用、鸿蒙应用时自动激活。 触发词：APP、移动端、iOS、Android、鸿蒙、React Native、Flutter、 uni-app App端、推送、离线、应用商店、上架。
| name | project-architect |
| description | 项目架构与选型技能。当用户开始新项目、需要技术选型、系统设计、或遇到架构问题时自动激活。 触发词：新项目、技术选型、架构设计、系统设计、高并发、高可用、 微服务、数据库设计、项目结构、技术方案、重构、性能瓶颈、 架构评审、系统重构、高可用设计、容量规划、系统架构、架构咨询、性能瓶颈分析。 |
新项目
├── 纯前端展示？
│ ├── 需要SEO？ → Next.js(SSR) / Nuxt.js(SSR)
│ ├── 管理后台？ → React+Ant Design / Vue+Element Plus
│ └── 营销H5？ → Vue3+Vant+GSAP
│
├── 需要后端？
│ ├── 快速MVP？ → Supabase + Vercel (零后端代码)
│ ├── 中等复杂度？ → NestJS + Prisma + PostgreSQL
│ ├── 企业级？ → Spring Boot + MyBatis-Plus + MySQL
│ └── 高性能？ → Go + Gin + PostgreSQL
│
├── 需要移动端？
│ ├── 小程序为主？ → uni-app (一套代码多端)
│ ├── APP为主？ → React Native / Flutter
│ └── 鸿蒙原生？ → ArkTS + ArkUI
│
└── 需要AI能力？
├── 国内直连？ → DeepSeek / 通义千问 / 火山方舟
├── 海外？ → Gemini / Mistral / OpenAI
└── 开源模型？ → HuggingFace Inference API
| 场景 | 推荐数据库 | 理由 |
|---|---|---|
| 通用业务 | PostgreSQL | 功能最强，JSONB/全文搜索/扩展 |
| 国内传统项目 | MySQL 8.0 | 生态成熟，运维资源多 |
| 缓存/会话/队列 | Redis 7 | 内存KV，性能极高 |
| 文档/日志 | MongoDB | 灵活Schema，聚合管道 |
| 搜索引擎 | Elasticsearch | 全文检索/日志分析 |
| 时序数据 | ClickHouse | OLAP分析，列式存储 |
适用：用户<10万，团队<5人，快速验证
优点：开发快、部署简单、调试方便
缺点：后期扩展受限
技术：Next.js全栈 / NestJS单体
适用：用户>50万，团队>10人，业务复杂
优点：独立部署、技术异构、故障隔离
缺点：运维复杂、分布式事务
技术：Spring Cloud / NestJS Microservices + gRPC
适用：流量波动大、事件驱动、成本敏感
优点：按量付费、零运维、自动扩缩
缺点：冷启动、调试困难、供应商锁定
技术：Vercel Edge / Cloudflare Workers / AWS Lambda
用户请求 → CDN(静态资源)
→ 负载均衡(Nginx/SLB)
→ API网关(限流/鉴权/路由)
→ 服务集群(水平扩展)
→ Redis缓存(热点数据)
→ 消息队列(削峰填谷)
→ 数据库(读写分离+分库分表)
# ADR-001: 选择 NestJS 作为后端框架
## 状态：已采纳
## 背景
项目需要同时支持Web端和小程序端，团队熟悉TypeScript
## 决策
采用 NestJS + Prisma + PostgreSQL
## 理由
1. 前后端统一TypeScript，降低沟通成本
2. NestJS模块化架构，适合中大型项目
3. Prisma类型安全ORM，开发效率高
4. PostgreSQL功能全面，JSONB支持灵活数据
## 后果
- 优点：开发效率高，类型安全，生态好
- 缺点：NestJS学习曲线较陡，运行时性能不如Go