SuperAPI AI 工具集

senior-backend

编程与开发

查看项目

更新于 11-15 08:28

技能介绍

Senior Backend 是一个面向后端工程师的技能包,用于设计和实现后端系统,涵盖 REST API、微服务、数据库架构、认证流程与安全加固。资料显示其主要由三部分组成:工具脚本、开发工作流与决策辅助机制。

一、主要工具

  1. API Scaffolder(api_scaffolder.py):从 OpenAPI 规范(YAML/JSON)或数据库 schema 生成路由处理器、校验中间件和 TypeScript 类型;也支持从现有路由反向生成 OpenAPI 规范。支持 Express.js、Fastify、Koa 三种框架。
  2. 数据库迁移工具(database_migration_tool.py):分析数据库 schema,检测变更,生成带回滚支持的迁移文件;可输出 schema 差异报告和优化建议(如缺失索引、N+1 查询风险),支持迁移 dry-run(试运行)。
  3. API 负载测试工具(api_load_tester.py):以可配置并发和时长执行 HTTP 负载测试,测量延迟百分位与吞吐量,输出性能报告(吞吐量、P50/P95/P99 延迟、错误计数与扩容建议);支持自定义请求方法、请求头、请求体和多端点对比测试。

二、内置工作流

  • API 设计流程:定义资源与操作、生成路由脚手架、实现业务逻辑、加入校验中间件、回生成 OpenAPI 规范。
  • 数据库优化流程:分析当前性能、识别慢查询(如通过 EXPLAIN ANALYZE 查看执行计划)、生成索引迁移、dry-run 测试、应用并验证。
  • 安全加固流程:检查认证配置(如 JWT 密钥来自环境变量、短有效期、非对称算法)、添加速率限制、使用 zod 等做输入校验、以攻击模式做负载测试、配置安全响应头(helmet)。 资料还提供 REST 响应格式、错误响应格式、HTTP 状态码与数据库索引策略等速查参考,以及 references 目录下的 API 设计模式、数据库优化指南、后端安全实践三份文档。

三、决策与约束机制 技能要求在生成脚手架、推荐模式或修改 schema 前,必须先明确四项前提:读写比与一年期 p99 QPS、租户模型(单租户/共享多租户/隔离多租户)、数据敏感级别(public/internal/PII/PHI/PCI)、SLO 与错误预算消费者;若信息缺失则停止并转入强制提问库。每条建议必须包含延迟目标(p50/p95/p99)、可用性/SLO 目标、RPO 与 RTO,否则视为不完整。backend_decision_engine.py 会校验这些输入,缺少读写比、QPS、租户、数据敏感度与模式偏好时拒绝推荐。

四、配置模板与组合 profiles/ 提供四套配置:node-express(TypeScript 团队、少于 15 人、面向客户的 SaaS,模块化单体 + Postgres,p99 600ms)、fastapi-python(Python 团队、少于 20 人、ML 相关,异步模块化单体,p99 500ms)、django-monolith(内容型 CRUD + 后台、少于 25 人,p99 800ms)、go-or-rust-microservice(拆分服务、至少 30 人、平台团队、QPS ≥ 1000,p99 200ms)。可通过命令行参数选择最佳匹配模板,工具不会自动批准。用户可复制模板文件添加自定义配置。

五、组合与调用 该技能不重复实现其他专家技能的职责,而是按关注点分派:API 契约与破坏性变更、schema 设计与 ERD、零停机迁移、SLO/SLI 与错误预算、可观测性、CI/CD、安全与威胁建模、合规证据、提交前审查、架构质询等,详见 composition_map.md。可通过斜杠命令 /cs:backend-review、子代理 cs-backend-engineer 或直接调用决策引擎脚本三种方式使用。强制提问库要求每轮只问一个问题、引用规范给出建议答案、记录回答,并在触发终止条件时停止。

限制方面:资料未说明该技能的收费、价格、支持平台范围或具体准确率;工具需本地 Python 环境运行,数据库分析面向 PostgreSQL 示例。