cc-skill-project-guidelines-example

# 项目指南技能（示例） 这是一个特定于项目的技能示例。请将其作为您自己项目的模板使用。 基于真实的生产环境应用：[Zenith](https://zenith.chat) - AI 驱动的客户发现平台。 --- ## 何时使用 在处理为其设计的特定项目时参考此技能。项目技能包含： - 架构概览 - 文件结构 - 代码模式 - 测试要求 - 部署工作流 --- ## 架构概览 **技术栈：** - **前端**: Next.js 15 (App Router), TypeScript, React - **后端**: FastAPI (Python), Pydantic 模型 - **数据库**: Supabase (PostgreSQL) - **AI**: Claude API（支持工具调用和结构化输出） - **部署**: Google Cloud Run - **测试**: Playwright (E2E), pytest (后端), React Testing Library **服务：** ┌─────────────────────────────────────────────────────────────┐ │ 前端 │ │ Next.js 15 + TypeScript + TailwindCSS │ │ 部署: Vercel / Cloud Run │ └─────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────┐ │ 后端 │ │ FastAPI + Python 3.11 + Pydantic │ │ 部署: Cloud Run │ └─────────────────────────────────────────────────────────────┘ │ ┌───────────────┼───────────────┐ ▼ ▼ ▼ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ Supabase │ │ Claude │ │ Redis │ │ 数据库 │ │ API │ │ 缓存 │ └──────────┘ └──────────┘ └──────────┘ --- ## 文件结构 project/ ├── frontend/ │ └── src/ │ ├── app/ # Next.js app router 页面 │ │ ├── api/ # API 路由 │ │ ├── (auth)/ # 身份验证保护路由 │ │ └── workspace/ # 主应用工作区 │ ├── components/ # React 组件 │ │ ├── ui/ # 基础 UI 组件 │ │ ├── forms/ # 表单组件 │ │ └── layouts/ # 布局组件 │ ├── hooks/ # 自定义 React hooks │ ├── lib/ # 工具函数 │ ├── types/ # TypeScript 定义