MSBuild扩展点深度剖析dotnet/skills extension-points技能完整上手指南【免费下载链接】skillsRepository for skills to assist AI coding agents with .NET and C#项目地址: https://gitcode.com/GitHub_Trending/skills17/skills如果你在 .NET / C# 项目中被Directory.Build.targets、CustomBeforeMicrosoftCommonTargets这些词绕晕dotnet/skills仓库里的MSBuild 扩展点extension-points技能值得收藏。这是微软为 AI 编程代理维护的 .NET 技能库该技能专门教会 AI 助手诊断和修复 MSBuild 构建扩展问题——比如新克隆仓库时构建失败、NuGet 包的钩子被静默丢弃、团队无法给构建步骤插桩等真实痛点本文带你快速看懂它的核心概念与上手方法。一、什么是 MSBuild 扩展点 把 MSBuild 构建流程想象成一条流水线SDK、NuGet 包、仓库、用户都可以在指定插槽里插入自定义逻辑这些插槽就是扩展点。extension-points 技能完整覆盖了这个体系源码入口在技能正文plugins/dotnet-msbuild/skills/extension-points/SKILL.md插件清单plugins/dotnet-msbuild/plugin.json二、技能核心5个必须掌握的扩展点机制1. CustomBefore / CustomAfter 钩子每个核心.targets文件都预留了前后钩子例如CustomBeforeMicrosoftCommonTargets。技能强调两条黄金规则必须检查Exists()文件在每台机器上不一定存在不检查就会构建失败追加而不是覆盖用;分隔符把新钩子拼在旧值后面否则会静默丢掉 NuGet 包已注册的钩子2. 通配符导入目录WildcardsMSBuild 会按字母顺序导入扩展目录下所有文件用数字前缀控制顺序01-first.props先于02-second.props。三个关键路径属性指向位置作用范围$(MSBuildUserExtensionsPath)%APPDATA%\Microsoft\MSBuild当前用户$(MSBuildExtensionsPath)MSBuild 安装目录整台机器$(MSBuildProjectExtensionsPath)obj/目录单个项目NuGet3. 导入门控属性Import Gating⚠️每个通配符导入都由一个布尔属性开关控制设为false即可关闭ImportDirectoryBuildProps/ImportDirectoryBuildTargets关闭Directory.Build.*自动发现ImportProjectExtensionProps/Targets关闭obj/里 NuGet 生成的文件ImportByWildcardBefore/After*关闭机器级通配扩展4. NuGet 包的 build 扩展布局NuGet 包通过build/只影响直接引用者或buildTransitive/影响整条依赖链注入构建逻辑且文件名必须与包 ID 完全一致否则导入会被静默跳过——这是新手最常踩的坑之一。5. Directory.Build 发现规则MSBuild 向上查找目录树但只发现最近的一个Directory.Build.props。嵌套目录想让子层继承根层设置必须显式 Import 父级文件技能中给出了标准写法。三、常见陷阱清单对照排查构建问题 技能最后整理了一份避坑清单非常适合当作 Review 检查表可选导入缺少Exists()守卫 → 新克隆直接构建失败覆盖Custom*属性 → 先前注册的钩子全部丢失NuGet 包内文件名与包 ID 不匹配 → 导入被静默忽略嵌套Directory.Build.props未导入父级 → 仓库根配置失效四、如何上手让 AI 代理帮你诊断扩展点仓库为这个技能准备了真实可运行的评测场景包含基础版和高难度版两套故障现场正好覆盖上述所有陷阱评测定义tests/dotnet-msbuild/extension-points/eval.yaml基础故障现场tests/dotnet-msbuild/extension-points/Directory.Build.targets高难度故障现场钩子覆盖、守卫条件写反、目标名冲突tests/dotnet-msbuild/extension-points/hard/以基础现场为例ExtensionPoints.csproj 参考了一个提供构建扩展的第三方包而 Directory.Build.targets 里就埋了两个典型错误!-- ❌ 导入没有 Exists() 守卫新克隆仓库会直接失败 -- Import Project$(RepoRoot)eng\custom-analyzers.props / !-- ❌ 直接覆盖属性第三方包已注册的钩子会被静默丢弃 -- CustomBeforeMicrosoftCommonTargets$(MSBuildThisFileDirectory)MyHook.targets/CustomBeforeMicrosoftCommonTargets上手路径很简单把仓库配置给你的 AI 编程代理Copilot 等用类似我们的构建在新克隆时报导入错误NuGet 包的钩子失效了帮我排查 Directory.Build.targets这样的自然语言提问技能会引导代理逐一识别缺失守卫、钩子覆盖、不可扩展目标等问题并给出可运行的修复方案评测的评分细则写在 eval.yaml 的rubric里可以看到它要求代理精准识别覆盖 vs 追加缺失守卫目标不可扩展三类根因——这正是该技能的考察范围。五、延伸阅读同插件下的姊妹技能dotnet-msbuild 插件里还有几个互补技能解决不同层面的问题技能解决的问题target-authoringTarget 编写模式本技能明确不做的事msbuild-antipatterns通用反模式审查含 NuGet 转发器例外规则eval-performance构建性能评估相关路径plugins/dotnet-msbuild/skills/六、总结MSBuild 扩展点决定了构建流水线的可插拔性而 dotnet/skills 的extension-points 技能把这部分知识变成了 AI 代理可以直接调用的诊断手册钩子要追加、导入要守卫、NuGet 文件名要匹配、嵌套配置要显式继承。下次遇到构建在别人机器/新克隆上突然失败的玄学问题把这个问题丢给加载了该技能的 AI 助手往往比逐行翻 SDK 源码快得多。【免费下载链接】skillsRepository for skills to assist AI coding agents with .NET and C#项目地址: https://gitcode.com/GitHub_Trending/skills17/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
MSBuild扩展点深度剖析：dotnet/skills extension-points技能完整上手指南
MSBuild扩展点深度剖析dotnet/skills extension-points技能完整上手指南【免费下载链接】skillsRepository for skills to assist AI coding agents with .NET and C#项目地址: https://gitcode.com/GitHub_Trending/skills17/skills如果你在 .NET / C# 项目中被Directory.Build.targets、CustomBeforeMicrosoftCommonTargets这些词绕晕dotnet/skills仓库里的MSBuild 扩展点extension-points技能值得收藏。这是微软为 AI 编程代理维护的 .NET 技能库该技能专门教会 AI 助手诊断和修复 MSBuild 构建扩展问题——比如新克隆仓库时构建失败、NuGet 包的钩子被静默丢弃、团队无法给构建步骤插桩等真实痛点本文带你快速看懂它的核心概念与上手方法。一、什么是 MSBuild 扩展点 把 MSBuild 构建流程想象成一条流水线SDK、NuGet 包、仓库、用户都可以在指定插槽里插入自定义逻辑这些插槽就是扩展点。extension-points 技能完整覆盖了这个体系源码入口在技能正文plugins/dotnet-msbuild/skills/extension-points/SKILL.md插件清单plugins/dotnet-msbuild/plugin.json二、技能核心5个必须掌握的扩展点机制1. CustomBefore / CustomAfter 钩子每个核心.targets文件都预留了前后钩子例如CustomBeforeMicrosoftCommonTargets。技能强调两条黄金规则必须检查Exists()文件在每台机器上不一定存在不检查就会构建失败追加而不是覆盖用;分隔符把新钩子拼在旧值后面否则会静默丢掉 NuGet 包已注册的钩子2. 通配符导入目录WildcardsMSBuild 会按字母顺序导入扩展目录下所有文件用数字前缀控制顺序01-first.props先于02-second.props。三个关键路径属性指向位置作用范围$(MSBuildUserExtensionsPath)%APPDATA%\Microsoft\MSBuild当前用户$(MSBuildExtensionsPath)MSBuild 安装目录整台机器$(MSBuildProjectExtensionsPath)obj/目录单个项目NuGet3. 导入门控属性Import Gating⚠️每个通配符导入都由一个布尔属性开关控制设为false即可关闭ImportDirectoryBuildProps/ImportDirectoryBuildTargets关闭Directory.Build.*自动发现ImportProjectExtensionProps/Targets关闭obj/里 NuGet 生成的文件ImportByWildcardBefore/After*关闭机器级通配扩展4. NuGet 包的 build 扩展布局NuGet 包通过build/只影响直接引用者或buildTransitive/影响整条依赖链注入构建逻辑且文件名必须与包 ID 完全一致否则导入会被静默跳过——这是新手最常踩的坑之一。5. Directory.Build 发现规则MSBuild 向上查找目录树但只发现最近的一个Directory.Build.props。嵌套目录想让子层继承根层设置必须显式 Import 父级文件技能中给出了标准写法。三、常见陷阱清单对照排查构建问题 技能最后整理了一份避坑清单非常适合当作 Review 检查表可选导入缺少Exists()守卫 → 新克隆直接构建失败覆盖Custom*属性 → 先前注册的钩子全部丢失NuGet 包内文件名与包 ID 不匹配 → 导入被静默忽略嵌套Directory.Build.props未导入父级 → 仓库根配置失效四、如何上手让 AI 代理帮你诊断扩展点仓库为这个技能准备了真实可运行的评测场景包含基础版和高难度版两套故障现场正好覆盖上述所有陷阱评测定义tests/dotnet-msbuild/extension-points/eval.yaml基础故障现场tests/dotnet-msbuild/extension-points/Directory.Build.targets高难度故障现场钩子覆盖、守卫条件写反、目标名冲突tests/dotnet-msbuild/extension-points/hard/以基础现场为例ExtensionPoints.csproj 参考了一个提供构建扩展的第三方包而 Directory.Build.targets 里就埋了两个典型错误!-- ❌ 导入没有 Exists() 守卫新克隆仓库会直接失败 -- Import Project$(RepoRoot)eng\custom-analyzers.props / !-- ❌ 直接覆盖属性第三方包已注册的钩子会被静默丢弃 -- CustomBeforeMicrosoftCommonTargets$(MSBuildThisFileDirectory)MyHook.targets/CustomBeforeMicrosoftCommonTargets上手路径很简单把仓库配置给你的 AI 编程代理Copilot 等用类似我们的构建在新克隆时报导入错误NuGet 包的钩子失效了帮我排查 Directory.Build.targets这样的自然语言提问技能会引导代理逐一识别缺失守卫、钩子覆盖、不可扩展目标等问题并给出可运行的修复方案评测的评分细则写在 eval.yaml 的rubric里可以看到它要求代理精准识别覆盖 vs 追加缺失守卫目标不可扩展三类根因——这正是该技能的考察范围。五、延伸阅读同插件下的姊妹技能dotnet-msbuild 插件里还有几个互补技能解决不同层面的问题技能解决的问题target-authoringTarget 编写模式本技能明确不做的事msbuild-antipatterns通用反模式审查含 NuGet 转发器例外规则eval-performance构建性能评估相关路径plugins/dotnet-msbuild/skills/六、总结MSBuild 扩展点决定了构建流水线的可插拔性而 dotnet/skills 的extension-points 技能把这部分知识变成了 AI 代理可以直接调用的诊断手册钩子要追加、导入要守卫、NuGet 文件名要匹配、嵌套配置要显式继承。下次遇到构建在别人机器/新克隆上突然失败的玄学问题把这个问题丢给加载了该技能的 AI 助手往往比逐行翻 SDK 源码快得多。【免费下载链接】skillsRepository for skills to assist AI coding agents with .NET and C#项目地址: https://gitcode.com/GitHub_Trending/skills17/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
