SuperAPI AI 工具集

cc-skill-project-guidelines-example

通用与其它

查看项目

更新于 10-15 20:05

技能介绍

用途:这是一个项目专属技能(project-specific skill)的示例模板,供用户为自己的项目编写类似技能时参考。它基于真实生产应用 Zenith(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。

代码模式:后端统一 API 响应格式(ApiResponse,含 ok/fail 类方法);前端 fetchApi 封装;Claude 结构化输出通过工具调用与 Pydantic 模型 schema 实现;React 自定义 useApi Hook。

测试与部署:后端用 poetry run pytest tests/ 运行,前端用 npm run test、npm run test:e2e;部署前需本地测试通过、构建成功、无硬编码密钥、环境变量已记录、数据库迁移就绪;部署命令为 gcloud run deploy frontend --source . 与 gcloud run deploy backend --source .。

关键规则:代码与文档中不使用 emoji;保持不可变性;TDD 先写测试;最低 80% 覆盖率;文件小而多(典型 200-400 行,最多 800 行);生产代码不用 console.log;使用 try/catch 处理错误;用 Pydantic/Zod 做输入校验。

限制:仅在任务明确匹配上述范围时使用;输出不能替代针对具体环境的验证、测试或专家评审;若缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。具体收费、价格与平台支持情况暂未提供。