SuperAPI AI 工具集

cc-skill-project-guidelines-example

通用与其它

查看项目

更新于 10-16 05:51

技能介绍

用途:该资源是项目级 Skill 的示例模板,供在特定项目中工作时参考,覆盖架构概览、文件结构、代码模式、测试要求与部署流程。

架构与堆栈:前端使用 Next.js 15(App Router)、TypeScript、React、TailwindCSS;后端使用 FastAPI(Python 3.11)、Pydantic;数据库为 Supabase(PostgreSQL);AI 使用 Claude API(工具调用与结构化输出);缓存为 Redis;部署到 Google Cloud Run;测试使用 Playwright(E2E)、pytest(后端)、React Testing Library。

代码模式:后端定义泛型 ApiResponse 模型,提供 ok/fail 类方法;前端 fetchApi 封装请求并返回统一响应;Claude 集成通过工具调用返回结构化 AnalysisResult;React 自定义 hooks 如 useApi 管理数据、加载与错误状态。

测试要求:后端用 poetry run pytest tests/,覆盖率命令 poestry run pytest tests/ --cov=. --cov-report=html;前端用 npm run test、npm run test -- --coverage、npm run test:e2e。

部署流程:部署前确保测试通过、构建成功、无硬编码密钥、环境变量已记录、数据库迁移就绪;前端 cd frontend && npm run build 后 gcloud run deploy frontend --source .,后端 cd backend 后 gcloud run deploy backend --source .。环境变量分前端 .env.local 与后端 .env。

关键规则包括:代码与文档中不使用 emoji;保持不可变性;TDD 先写测试;最低 80% 覆盖率;文件 200-400 行典型、最大 800 行;生产代码无 console.log;用 try/catch 处理错误;用 Pydantic/Zod 校验输入。相关技能涉及编码标准、后端模式、前端模式与 TDD 工作流。

限制:该资源为示例模板,未提供具体收费、安装命令或独立使用方式;实际应用需结合具体项目调整。