SuperAPI AI 工具集

dotnet-agent-gotchas

智能体与模型

查看项目

更新于 10-16 02:32

技能介绍

用途:该技能汇总 AI 智能体在生成或修改 .NET 代码时常见的错误,按类别组织。每类包含简短警告、反模式代码、修正代码,以及指向负责深入指导的规范技能的交叉引用。它不提供完整实现教程,只暴露错误并指向正确技能。

主要能力:覆盖 async/await 误用(如用 .Result/.Wait() 阻塞导致死锁、fire-and-forget 吞异常)、NuGet 包错误(包名错误、预发布版本、共享框架包版本与 TFM 不匹配)、过时 API(BinaryFormatter、WebClient、旧加密 API)、项目结构错误(SDK 类型、重复 PackageReference、ProjectReference 路径)、可空引用类型注解错误、源生成器配置错误、裁剪/AOT 警告抑制、测试组织反模式、DI 注册错误(生命周期捕获、缺少注册)。另含 Slopwatch 反模式:禁用/跳过测试、警告抑制、空 catch 块、无理由静默分析器。

使用方式:作为技能被引用,用于代码审查或生成后检查;每类给出反模式与修正对照,并交叉引用如 dotnet-csharp-async-patterns、dotnet-csharp-dependency-injection、dotnet-csharp-nullable-reference-types、dotnet-csharp-source-generators、dotnet-testing-strategy、dotnet-security-owasp 等技能。

适用场景:.NET 8.0+ SDK 项目,熟悉 SDK 风格项目与 C# 语言特性。

限制:不提供完整实现走查;深入 async、DI、NRT、源生成器、测试框架、安全缓解等内容需查阅对应规范技能。具体安装命令、收费与平台信息暂未提供。