用途：在创建、调试、重构或审查基于 ControllerBase 的 ASP.NET Core Web API 时使用。触发条件包括项目含 Controllers 目录、目标框架为 .NET 6.0（LTS）及以上，或需要将中间件异常处理迁移到 .NET 8+ 的 IExceptionHandler 等现代化改造。
主要能力：按“感知—规划—执行—验证”流程工作。感知阶段检查 .csproj 的 TargetFramework、判断 N-Tier 或 Vertical Slice 架构、识别现有横切关注点处理方式；规划阶段评估是否引入 Problem Details 标准、是否使用 .NET 8+ 全局异常处理、按项目规模选择版本策略；执行阶段编写符合 [ApiController] 约定的控制器、使用强类型不可变 DTO（优先 record）、集成依赖注入并优先使用 C# 12+ 主构造函数；验证阶段检查 ActionResult<T> 返回类型、NRT 空安全、异步操作是否正确传递 CancellationToken。
版本路线：.NET 6/7 覆盖控制器架构、属性路由、Problem Details、输出缓存、可空引用类型；.NET 8/9 覆盖 IExceptionHandler、Antiforgery、Keyed Services、HybridCache；.NET 10+ 涉及控制器的扩展成员、大负载 JSON 序列化优化。
编码规范：优先 ActionResult<T> 以改善 Swagger 支持；严格 NRT；异步方法始终接收并传递 CancellationToken；控制器名以 Controller 结尾，异步方法以 Async 结尾。
交付与验证：提供适配目标版本的控制器与配置、N-Tier 或 Clean Architecture 重构建议、Problem Details 与异常处理的安全建议；验证代码符合 C# 10+ 语法、错误格式符合 RFC 7807、无资源泄漏。
限制：资料未提供安装命令、收费方式、具体平台支持范围或实测效果数据。