SuperAPI AI 工具集

sop-api-development

编程与开发

查看项目

更新于 10-15 21:11

技能介绍

用途:该技能提供一套完整的 REST API 开发标准作业流程(SOP),以测试驱动开发(TDD)和多智能体协作为核心,覆盖从规划到上线的全过程,总周期约两周(14 天)。

主要能力:流程分为四个阶段。规划与设计(第 1-2 天)产出需求文档、OpenAPI 3.0 规范、数据库 schema、测试计划与 DevOps 计划;开发(第 3-8 天)完成项目初始化、数据库与 CI/CD 搭建,并按 TDD 循环逐端点编写测试、实现与代码评审,随后并行开发认证中间件、CRUD、搜索与 Webhook;测试与文档(第 9-11 天)执行 E2E、性能与安全测试,并编写 API 文档、开发者指南与运维手册;部署(第 12-14 天)进行预生产验证、蓝绿部署、上线后监控与知识转移。

使用方式:通过 Skill("sop-api-development") 调用,或以 Task("API Development Orchestrator", ...) 传入具体需求与时间线执行。流程使用 planner、system-architect、code-analyzer、tester、cicd-engineer、backend-dev、reviewer、perf-analyzer、security-manager、production-validator、performance-monitor、api-docs 等智能体,并采用顺序与并行混合的执行模式,记忆命名空间为 api-dev/rest-api-v2/*。

适用场景:需要按标准化流程从零构建或重构 REST API 的团队,尤其适合希望引入 TDD、多智能体分工与完整文档、部署规范的场景。

限制:资料未提供该技能的具体安装命令、依赖环境、支持的模型或平台、收费方式与实际效果验证;文中给出的时间线、指标(如覆盖率 >90%、响应时间 <200ms、吞吐 >1000 req/sec)为流程设定的目标值,并非实测结果。实际执行需结合具体项目调整。