SuperAPI AI 工具集

msbuild

编程与开发

查看项目

更新于 10-20 03:14

技能介绍

MSBuild 排障技能(来源 microsoft/testfx)是入口型技能,用于 MSBuild 相关的三类工作:构建失败调查、构建性能分析,以及现有构建 XML 与扩展契约的审查。使用时先根据任务选择路线,再只阅读相关的本地参考资料;这些参考资料保留原 MSBuild 技能的内容与身份并做了正确性修正,不是需要单独激活的技能。

使用方式与证据要求:需要代码检出时,在当前工作区中发现相关项目/解决方案、共享构建文件、SDK 选择与仓库构建说明,并保留原始命令、工作目录、配置、目标框架、运行时标识符、全局属性与目标。仅索取无法自行发现且影响结论的信息。已有 .binlog 可能是唯一可用产物,应先分析再请求新构建;日志中的路径不能证明本地存在检出。对于自包含的静态审查或咨询问题,使用提供的 XML 与相关参考,不要求检出、还原、构建或 binlog。混合请求应先修正正确性问题再测量成功构建,且编写审查与性能实验应分开。

一、排障。目标是找出独立根因并做最小修复,而非大范围清理。构建失败且存在二进制日志时,用 MSBuild 重放日志,把错误关联到具体项目实例、目标与任务,区分根因与级联失败;缺少匹配日志时先按 binlog-generation 捕获一次原始调用并校验产物;条件、项、属性或输出路径有误时,查阅 msbuild-antipatterns 并核对例外后再改;导入或构建钩子缺失、被覆盖或顺序错误时,检查导入契约、发现顺序与 NuGet 打包布局;输出过期或必要工作被跳过时,用 incremental-build 证明是哪个输入、输出、时间戳、项或条件导致判断错误,正确性优先于速度。修复后重跑原始失败场景并检查受影响依赖;若只有日志,应给出有证据支撑的建议修复并说明未应用或未重建。

二、性能。目标是测量所报告的场景、找出瓶颈、只改一个原因,并在不丢失必要行为的前提下对比等效构建。复用匹配的测量;缺失时先建立基线,不把失败构建当作成功基线。区分求值与目标/任务执行;目标总耗时与依赖等待不能简单相加为实际耗时,也不证明 CPU 利用率。按测量结果选择分支:无可靠前后测量时参考 build-perf-baseline,区分冷输出、热输入变化与无变化构建、还原/缓存状态以及普通 Build 与强制 Rebuild;未定位昂贵工作时参考 build-perf-diagnostics,区分实际任务成本与编排等待、重叠时长与缺失的插桩;时间花在目标执行前、glob、导入或属性求值时参考 eval-performance;内容复制或输出 I/O 为主时参考 copy-to-output-directory;第二次未变化构建仍重编译时参考 incremental-build。重复相同场景、命令、输入变化与插桩,报告波动与正确性检查。当证据不支持瓶颈、结果落在噪声内或正确性回退时应停止,并如实报告缺失测量。

三、编写审查。目标是改进项目/构建文件结构与扩展契约并保持行为,属于 MSBuild 编写清理,不隐含框架、包、语言或旧项目系统迁移。审查项目文件、共享属性、项声明或自定义目标时参考 msbuild-antipatterns,保留有意的覆盖、F# 源顺序、必需导入、包资产与实际输入输出契约;审查钩子、导入、共享文件发现或 NuGet 构建扩展时参考 extension-points,保留此前钩子、求值顺序、直接/传递使用者行为与打包布局;重构生成或复制时按情况参考 incremental-build 与 copy-to-output-directory,保留首次构建与无变化行为、失效机制、生成项注册与输出完整性。编辑前记录现有契约,只审查相关条目,匹配文本模式不等于缺陷,已正确的模式保持不动,并验证原有配置、相关使用者及受影响的增量/打包/发布行为。

共享证据与安全:仅捕获时使用 binlog-generation,报告新产物与原始退出码后停止;分析时使用 MSBuild 重放,不解析二进制文件文本;重放成功与重放时长不代表被记录构建的结果或时长。参考资料相对本技能解析,不加载原插件技能、不搜索其他安装或检出;捆绑参考缺失时允许列一次 references、报告缺口,不得假装已遵循其指导。不要以清理输出/缓存、停止共享构建服务器、关闭诊断、更改 SDK 或串行化构建作为通用修复;必要的破坏性实验应限定在经批准且自有输出范围内;二进制与重放日志除非获授权,否则保持本地。区分记录事实与假设,缺失源码、日志细节、工具或平台支持须明确报告,不得用假定值或编造验证替代。完成时返回所选任务、原因/瓶颈或编写决策、支撑证据以及所做或建议的最小改动,说明无需改动的情况,给出确切验证与结果并区分成功、失败与未运行检查,性能工作还需可比测量与不确定性,回答篇幅与任务相当。