SuperAPI AI 工具集

axum-agents-scaffold

智能体与模型

查看项目

更新于 10-16 06:17

技能介绍

用途:这是一个编排型技能,用于从零构建完整的 Axum 服务,而非修复某个孤立部分(如单个提取器、单个错误或单条路由)。它不教授 Axum API,而是给出构建完整服务的决策顺序,并指明包内负责每一步的具体技能。

主要能力:提供有序的构建流程(步骤 0 到 14),包括分类服务类型、固定 Axum 版本、构建 Router、定义共享 State、编写 handler 与提取器、添加中间件与 tower 栈、定义 AppError、添加认证与授权、接入数据库与校验、实时功能、可观测性与 API 文档、测试、部署以及自审。还提供服务类型决策树(无状态 JSON CRUD、服务端渲染、实时双向、单向推送、文件媒体服务、公开 API)、WebSocket 与 SSE 的选择判断,以及最小到生产的分层(Minimal、Functional、Hardened、Operable)。

使用方式:先运行服务类型决策树进行分类,再固定 Axum 版本(0.7 或 0.8,新项目用 0.8),然后按顺序执行步骤 0 到 14,每一步打开对应技能并应用,最后运行 axum-agents-api-review 检查清单。若只是单个孤立问题,则跳过本技能,直接使用对应技能。

适用场景:需要构建或扩展整个 Axum 服务时使用。涉及数据库的服务需同时参考 axum-core-async-performance;非公开路由需引入认证与授权技能;实时分支需引入异步性能技能;公开 API 需引入 OpenAPI 与 tracing。

限制:资料未提供具体安装命令、价格或平台信息。部署前必须完成 Hardened 层,不可跳过;不得在未分类前编写代码,不得跳过版本固定,不得在路由之前分层。