senior-backend

高级后端工程师

搭建并审查后端服务：为 Express/Fastify/Koa 设计 API 并基于 OpenAPI 生成代码、分析 PostgreSQL 架构并生成迁移、进行 HTTP 负载测试，以及强化生产环境安全。输出可直接运行的路由处理程序、Zod 验证器、TypeScript 类型、带回滚脚本的迁移，以及负载测试报告。

核心能力

• API 脚手架 — 为 Express、Fastify 和 Koa 生成路由处理程序、验证中间件、TypeScript 类型和 OpenAPI 规范。
• 数据库优化 — 分析架构、检测缺失索引、检测 N+1 风险，并生成配套回滚脚本的迁移。
• 负载测试 — 可配置并发量，提供延迟百分位数（P50/P90/P95/P99）、吞吐量、错误率和端点对比。
• 安全强化 — 配置 JWT、速率限制、输入验证（Zod）和安全标头（helmet），满足生产环境要求。
• 标准化契约 — 统一使用 data/error/meta 响应封装和 HTTP 状态码约定。

适用场景

• 设计新 API 或重构现有端点。
• 慢速查询或需要提升数据库性能。
• 为 API 上线做准备，或在安全审查后进行加固。
• 为后端端点构建回归测试／负载测试基线。

先确认

开始搭建前，请确认以下输入。任何一项未知或含糊时，都要先询问，不要自行假设：

• 框架 — Express / Fastify / Koa（--framework；会影响生成的路由处理程序、验证器和类型）
• API 契约来源 — 要据此搭建的 OpenAPI 规范或端点列表（脚手架工具读取的输入）
• 数据库需求 — 架构文件，以及你需要的是分析还是生成迁移（决定 database_migration_tool.py 的用途）

停止规则：只询问最可能影响输出的 2-3 项。如果用户说“先起草就行”，则继续，并在产物顶部列出你的假设。

工具

工具	用途	命令
api_scaffolder.py	根据 OpenAPI 规范生成路由处理程序、Zod 验证器和 TS 类型	python scripts/api_scaffolder.py openapi.yaml --framework express --output src/routes/
database_migration_tool.py	分析架构、建议索引，并生成带回滚脚本的迁移	python scripts/database_migration_tool.py schema.sql --analyze
api_load_tester.py	进行 HTTP 负载测试，提供延迟百分位数、吞吐量和对比结果	python scripts/api_load_tester.py https://api.example.com/users --concurrency 50 --duration 30

参考资料

加载与任务匹配的参考资料 — 保持此文件精简，按需查阅详细内容：

• references/tools-reference.md — 脚手架工具、迁移工具和负载测试工具的完整用法示例、标志表和输出样例，以及快速入门和常用命令。运行任何工具时请阅读。
• references/workflows-and-patterns.md — API 设计、数据库优化和安全强化工作流，常见响应／索引模式、故障排查表和成功标准。设计或强化服务时请阅读。
• references/api_design_patterns.md — REST 与 GraphQL、版本管理、错误处理、分页。设计新 API 时请阅读。
• references/database_optimization_guide.md — 索引策略、查询优化、N+1 解决方案。修复慢速查询时请阅读。
• references/backend_security_practices.md — OWASP Top 10、身份验证模式、输入验证。强化安全时请阅读。

范围与限制

此技能涵盖：

• 为 Express、Fastify 和 Koa 设计 REST API、搭建脚手架，以及基于 OpenAPI 的代码生成
• PostgreSQL 架构分析、索引优化、支持回滚的迁移生成
• HTTP 负载测试，包括延迟百分位分析、吞吐量测量和端点比较
• 后端安全模式，包括 JWT 配置、速率限制、输入验证和安全标头

此技能不涵盖：

• 前端开发、UI 组件或客户端状态管理——请参阅 senior-frontend
• 基础设施预配、容器编排或 CI/CD 流水线搭建——请参阅 senior-devops
• GraphQL 架构设计、解析器或订阅——请参阅 senior-fullstack
• 应用性能监控（APM）、分布式追踪或日志聚合——请参阅 senior-secops

集成点

技能	集成方式	数据流
senior-fullstack	在此生成的 API 路由将用于全栈项目脚手架搭建	OpenAPI 规范 → 全栈脚手架工具将其作为 API 契约使用
senior-devops	在此生成的迁移脚本将由 CI/CD 部署流水线使用	migrations/ 目录 → 部署工作流执行并验证迁移
senior-security	负载测试结果和安全加固输出将用于安全审查	负载测试 JSON → 安全审计验证速率限制和错误处理
senior-qa	生成的路由处理器和验证器为 QA 自动化提供测试对象	路由文件 + Zod 架构 → QA 生成集成测试套件
senior-frontend	脚手架工具生成的 TypeScript 类型将与前端使用方共享	types.ts → 前端导入 API 类型，以编写类型安全的客户端代码
code-reviewer	架构分析问题和迁移差异将用于代码审查清单	分析报告 → 审查者验证索引覆盖情况和命名规范