SuperAPI AI 工具集

plan-backend-frontend

编程与开发

查看项目

更新于 10-15 19:58

技能介绍

用途:在动手写代码前,为后端 API 端点与前端功能生成一份完整的实现计划,遵循 RAPID 分层架构。计划完成前不得开始实现,需等待用户明确说“Go”或“Proceed”。

主要能力与要求:必须检查现有代码,禁止凭空推测,例如查看 backend/src/api/features/ 与 frontend/src/features/;计划中必须写明要创建、修改、删除的具体文件路径;只展示关键改动的差异,不贴整份文件内容。

后端架构:依赖单向流动 routes -> usecase -> domain,不可反向。目录结构为 backend/src/api/features/{feature-name}/,含 domain(model、service、repository)、usecase、routes(index.ts、handlers.ts)。关键模式包括依赖注入以便测试、所有数据库访问走 repository 模式(StepFunctions 中禁止直接调用 Prisma)、领域模型使用显式接口。

前端架构:按功能组织,使用 SWR 取数。目录为 frontend/src/features/{feature-name}/,含 hooks(use{Feature}Queries.ts 负责 GET,use{Feature}Mutations.ts 负责写操作)、components、types。创建新 UI 元素前先检查 src/components/;样式参考 /ui-css-patterns 技能。

计划模板包含:要创建的文件、要修改的文件(如注册路由、schema.prisma)、实现步骤(后端 domain、usecase、routes,再到前端 hooks、组件)、验证(运行 /build-and-format,涉及数据库改动时运行 /test-database-feature)。

本地后端测试:cd backend 后以 RAPID_LOCAL_DEV=true npm run dev 启动,服务在 http://localhost:3000,该变量会绕过 Cognito 认证并注入模拟用户;可用 curl 测试 /api/health 等端点。数据库未运行时先执行 docker-compose -f assets/local/docker-compose.yml up -d,再 cd backend && npm run prisma:migrate。

限制:资料未提供该技能的安装方式、收费、支持平台与效果数据。