关于 backend-developer
为服务端应用开发提供多框架指导,适合构建 API、数据库模型、认证系统及后端基础设施的开发者。内容涵盖多种语言与框架,并提供架构选择建议、实现模式和质量检查清单。
主要功能
- 01REST 与 GraphQL API 开发指导
- 02数据库模式与 ORM 设计
- 03认证与授权实现建议
- 04多语言及框架选择参考
- 05测试、部署与性能优化建议
- 06安全与质量检查清单
适用场景
- 01选择后端语言与框架
- 02设计数据库模式和 ORM 集成
- 03实现 API 认证与授权
- 04检查后端服务的测试与部署
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ 404kidwiz/ claude-supercode-skills --skill backend-developer安装后在 Claude Code 中输入/backend-developer确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
EXAMPLES.mdREFERENCE.mdreferences/api_patterns.mdbackend_frameworks.mdbest_practices.mddeployment_guide.mdtesting_strategies.mdtroubleshooting.mdscripts/create_middleware.pycreate_tests.pydeploy.sherror_handler.pygenerate_docs.pygenerate_model.pyscaffold_api.pysetup_auth.pysetup_logging.py详细介绍
后端开发技能
用途
全面掌握多种框架、语言和部署策略下的服务器端应用开发。专长于构建可扩展的 API、设计数据库、实现身份验证系统,以及搭建可用于生产环境的后端基础设施。
适用场景
- 构建 REST 或 GraphQL API
- 设计数据库架构和模型
- 实现身份验证和授权
- 搭建服务器基础设施
- 创建微服务或单体后端
- 优化后端性能
- 将服务器应用部署到生产环境
- 需要多框架后端指导(Express、FastAPI、Django、Spring)
快速入门
在以下情况下调用此技能:
- 使用 Node.js、Python、Java 或 Go 构建服务器端 API(REST、GraphQL)
- 实现身份验证/授权(JWT、OAuth2、基于会话的身份验证)
- 设计数据库架构并集成 ORM
- 设置后端测试(单元、集成、端到端)
- 实现中间件(日志记录、验证、错误处理)
- 将后端服务部署到 Kubernetes、AWS、GCP 或 Azure
- 优化后端性能(缓存、查询优化、速率限制)
请勿在以下情况下调用:
- 只需要前端开发 → 使用 frontend-developer 或 nextjs-developer
- 需要针对数据库进行优化 → 使用 database-optimizer 或 postgres-pro
- 只设计 API,不进行实现 → 使用 api-designer
- 需要专门设计 GraphQL 架构 → 使用 graphql-architect
- 只涉及 DevOps/基础设施 → 使用 devops-engineer 或 cloud-architect
框架支持
Node.js/TypeScript
- Express.js、NestJS、Koa.js、Fastify
Python
- FastAPI、Django、Flask、Tornado
Java
- Spring Boot、Quarkus、Micronaut
Go
- Gin、Echo、Fiber
决策框架
后端框架选择
Backend Framework Selection
├─ JavaScript/TypeScript
│ ├─ Need rapid development + type safety → NestJS
│ ├─ Need lightweight/fast performance → Fastify
│ └─ Need simplicity + ecosystem → Express.js
│
├─ Python
│ ├─ Need async + high performance → FastAPI
│ └─ Need batteries-included → Django (+ DRF)
│
├─ Java
│ └─ Enterprise-ready → Spring Boot
│
└─ Go
└─ High-performance services → Gin or Fiber
身份验证策略矩阵
| 场景 | 策略 | 复杂度 | 安全性 |
|---|---|---|---|
| 无状态 API(移动应用、SPA) | JWT | 低 | 中 |
| 第三方登录 | OAuth 2.0 | 中 | 高 |
| 传统 Web 应用 | 基于会话 | 低 | 高 |
| 微服务 | JWT + API Gateway | 高 | 高 |
| 企业 SSO | SAML 2.0 | 高 | 非常高 |
数据库和 ORM 选择
Database & ORM Decision
├─ Relational (SQL)
│ ├─ Node.js/TypeScript
│ │ ├─ Need type safety + migrations → Prisma
│ │ └─ Need flexibility → TypeORM or Sequelize
│ ├─ Python
│ │ ├─ Async required → Tortoise ORM or SQLModel
│ │ └─ Sync / Django → Django ORM or SQLAlchemy
│ └─ Java
│ └─ JPA (Hibernate) or jOOQ
│
└─ NoSQL
├─ Document store → MongoDB (Mongoose for Node.js)
└─ Key-value → Redis (caching, sessions)
最佳实践
- 始终验证输入 - 使用提供的验证中间件
- 妥善处理错误 - 使用生成的错误处理程序
- 编写测试 - 使用测试模板保持一致
- 使用环境变量 - 绝不将密钥硬编码
- 实现日志记录 - 使用提供的日志配置
- 监控性能 - 设置指标和告警
- 安全至上 - 使用提供的身份验证配置
- 为 API 设定版本 - 遵循版本控制模式
- 编写代码文档 - 自动生成 API 文档
- 安全部署 - 使用提供的部署脚本
常见模式
仓储模式
- 分离关注点
- 便于测试
- 可替换实现
服务层
- 集中管理业务规则
- 事务管理
- 错误处理
中间件栈
- 身份验证
- 授权
- 验证
- 日志记录
- 错误处理
故障排除
常见问题
数据库连接错误
- 检查连接字符串
- 确认数据库正在运行
- 检查网络连接
- 检查连接池设置
身份验证失败
- 确认 JWT 密钥
- 检查令牌是否过期
- 验证令牌格式
- 检查中间件顺序
构建失败
- 检查 TypeScript 配置
- 确认依赖项已安装
- 查看错误消息
- 检查语法错误
部署问题
- 确认 Docker 镜像构建成功
- 检查 Kubernetes Pod
- 查看日志
- 确认环境变量
质量检查清单
安全
- 所有端点的输入验证(Zod/Joi)
- 密码哈希(bcrypt 成本 10+ 或 Argon2)
- 防止 SQL 注入(参数化查询)
- 对身份验证端点进行速率限制
- 安全标头(Helmet.js)
- 使用环境变量存储机密
身份验证与授权
- 强 JWT 密钥(256 位)
- 短期访问令牌(15 分钟)
- 刷新令牌轮换
- 对受保护路由进行授权检查
错误处理
- 全局错误处理程序
- 异步错误处理(express-async-errors)
- 清晰的验证错误消息
- 处理未知端点的 404 错误
性能
- 数据库连接池
- 查询优化(避免 N+1)
- 缓存(使用 Redis 管理会话和速率限制)
- 响应压缩(gzip/brotli)
测试
- 为服务/存储库编写单元测试
- 为 API 端点编写集成测试
- 关键路径覆盖率达到 80% 以上
- 使用独立的测试数据库
其他资源
- 详细技术参考:参见 REFERENCE.md
- 代码示例与模式:参见 EXAMPLES.md
评论
支持 Markdown