SuperAPI AI 工具集

dotnet-build-analysis

通用与其它

查看项目

更新于 10-16 01:13

技能介绍

用途:帮助智能体解读并处理 MSBuild 构建输出,覆盖错误码前缀、NuGet 还原失败、分析器警告解读、多目标框架构建差异,以及“本地通过、CI 失败”的诊断模式。每个子节包含示例输出、诊断步骤和修复模式。不涉及 .csproj 编写或修改、项目结构决策、常见智能体代码错误。

主要能力:按前缀识别错误来源。CS 为 Roslyn C# 编译器错误与警告,如 CS0246 类型缺失、CS8618 可空引用警告;MSB 为 MSBuild 引擎错误,如 MSB4019 导入目标缺失、MSB3644 目标包未安装;NU 为 NuGet 还原或打包错误,如 NU1101 包不存在、NU1603 传递依赖版本冲突、NU1605 显式降级;IDE 为 Roslyn 代码风格诊断,如 IDE0005 无用 using、IDE0044 字段可只读;CA 为 .NET 代码分析规则,如 CA1848 日志性能、CA2007 ConfigureAwait、CA5351 使用已破坏的加密算法。

使用方式:先解析文件路径与行号定位问题,再按前缀判断来源。NuGet 还原失败时可用 dotnet nuget list source 检查源,检查 nuget.config 中的 packageSources 与 packageSourceMapping;私有源认证失败可安装 Azure Artifacts Credential Provider 或运行 dotnet nuget update source MyCompany --username az --password $PAT --store-password-in-clear-text。分析器警告可在 .editorconfig 中配置严重级别,如 dotnet_diagnostic.CA2007.severity = none,或提升安全规则为 error。多目标框架构建时,诊断行带 [项目 -> TFM] 后缀,可用 #if NET9_0_OR_GREATER 条件编译或按 TFM 条件引用包。

适用场景:排查构建错误、NuGet 还原失败、分析器警告取舍、多目标框架差异,以及本地与 CI 环境不一致导致的构建漂移。

限制:需要 .NET 8.0+ SDK 与 SDK 风格项目格式;不负责项目文件编写、项目结构决策或智能体代码错误;抑制警告仅在分析器无法理解安全保证、规则不适用或提供书面理由时可接受。