SuperAPI AI 工具集

dotnet-webapi

编程与开发

查看项目

更新于 10-15 20:06

技能介绍

用途:在用户请求创建、调试、重构或审查 ASP.NET Core Web API 时触发;适用于项目含 Controllers 目录并继承 ControllerBase、目标框架为 .NET 6.0(LTS)及以上,或需要将中间件异常处理迁移到 .NET 8+ IExceptionHandler 等现代化改造的场景。

主要能力:按感知、规划、执行、验证流程工作。先检查 .csproj 确认 TargetFramework,分析项目是 N-Tier 还是 Vertical Slice 架构,识别现有横切关注点处理方式;再评估是否引入 Problem Details 标准、是否使用 .NET 8+ 全局异常处理、按项目规模选择版本控制策略;随后编写符合 [ApiController] 约定的控制器,实现强类型不可变 DTO(优先 record),集成依赖注入并优先使用 Primary Constructors(C# 12+);最后验证返回类型是否符合 ActionResult<T>、NRT 安全、异步操作是否正确传递 CancellationToken。

版本路线:.NET 6/7 涵盖控制器架构、属性路由、Problem Details、输出缓存、可空引用类型;.NET 8/9 涵盖 IExceptionHandler、Antiforgery、Keyed Services、HybridCache;.NET 10+ 涵盖控制器的 Extension Members、面向大负载的增强序列化。

编码规范:优先 ActionResult<T> 以改善 Swagger 支持,严格 NRT,异步始终接受并传递 CancellationToken,控制器名以 Controller 结尾、异步方法以 Async 结尾。

交付与验证:提供适配目标版本的控制器与配置、N-Tier 或 Clean Architecture 重构建议、Problem Details 与异常处理的安全建议;确保代码符合 C# 10+ 语法、错误格式符合 RFC 7807、无资源泄漏。

限制:资料未提供安装命令、收费方式、平台支持范围或具体效果数据,暂未提供。