dotnet-msbuild

مجموعه ابزارهای هوشمند برای عیب‌یابی و بهینه‌سازی buildهای MSBuild و .NET

این skill bundle شامل ۱۸ مهارت تخصصی برای کار با MSBuild و فرایندهای build در .NET است؛ از تولید و تحلیل binlog تا بررسی خطاهای چندپروژه‌ای، ترتیب اجرای targetها و تنظیم parallelism.

با کمک آن می‌توانید علت خطاهای مبهم، کندی build و استفاده‌نشدن از هسته‌های CPU را سریع‌تر پیدا کنید و با دستورها و تحلیل‌های دقیق‌تر، فرایند build، test، pack، publish و restore را بهبود دهید.

چه چیزی می‌گیرید

  • تولید binlog برای ثبت کامل اجرای MSBuild و بررسی‌های بعدی
  • تحلیل خطاهای پیچیده با binlog و ردیابی زنجیره خطاها در پروژه‌های متعدد
  • راهنمای تنظیم /maxcpucount، graph build و BuildInParallel برای build سریع‌تر
  • بررسی ترتیب اجرای targetها، dependencyها، properties و items در MSBuild
  • پیشنهادهای عملی برای عیب‌یابی و بهینه‌سازی buildهای .NET

برای چه کاری خوب است

  • تیم‌هایی که با solutionهای بزرگ چندپروژه‌ای در .NET کار می‌کنند
  • توسعه‌دهندگانی که خطاهای MSBuild از روی خروجی معمول console قابل تشخیص نیست
  • پروژه‌هایی که build آن‌ها کند است یا از ظرفیت CPU به‌خوبی استفاده نمی‌کند
  • افرادی که به تحلیل دقیق build با binlog و ابزارهای خط فرمان نیاز دارند

برای چه کاری نیست

  • پروژه‌هایی که از MSBuild یا اکوسیستم .NET استفاده نمی‌کنند
  • تحلیل خطاهای npm، Maven، CMake یا دیگر build systemهای غیر-MSBuild
  • زمانی که فقط به اجرای ساده build بدون عیب‌یابی یا بهینه‌سازی نیاز دارید

دربارهٔ این اسکیل

Install This Skill

CLI Manual

/plugin marketplace add dotnet/skills
/plugin install dotnet-msbuild@dotnet-agent-skills
# This entry installs as a plugin, so there is no single SKILL.md to download.
open https://github.com/dotnet/skills/tree/main/plugins/dotnet-msbuild

Get new skills in your inbox. What we added, what we rejected, and why. See a past issue.

Skill bundle — 18 sub-skills

upstream is a skill bundle

This catalog entry is a skill bundle that ships 18 individual SKILL.md files. Each one is listed below — click through to read the full markdown on GitHub.

binlog-failure-analysis

Analyze MSBuild binary logs to diagnose build failures. Only activate in MSBuild/.NET build context. USE FOR: build errors that are unclear from console output, diagnosing cascading failures across multi-project builds, tracing MSBuild target execution order, and generally any MSBuild build issues. Requires an existing .binlog file. DO NOT USE FOR: generating binlogs (use binlog-generation), non-MSBuild build systems. INVOKES: binlog MCP server tools (overview, errors, search, items, properties); falls back to dotnet msbuild binlog replay + grep/cat when the MCP is unavailable.

plugins/dotnet-msbuild/skills/binlog-failure-analysis

binlog-generation

Generate MSBuild binary logs (binlogs) for build diagnostics and analysis. Only activate in MSBuild/.NET build context. USE FOR: adding /bl:{} to any dotnet build, test, pack, publish, or restore command to capture a full build execution trace, prerequisite for binlog-failure-analysis and build-perf-diagnostics skills, enabling post-build investigation of errors or performance. Requires MSBuild 17.8+ / .NET 8 SDK+ for {} placeholder; PowerShell needs -bl:{{}}. DO NOT USE FOR: non-MSBuild build systems (npm, Maven, CMake), analyzing an existing binlog (use binlog-failure-analysis instead). INVOKES: shell commands (dotnet build /bl:{}).

plugins/dotnet-msbuild/skills/binlog-generation

build-parallelism

Guide for optimizing MSBuild build parallelism and multi-project scheduling. Only activate in MSBuild/.NET build context. USE FOR: builds not utilizing all CPU cores, speeding up multi-project solutions, evaluating graph build mode (/graph), build time not improving with -m flag, understanding project dependency topology. Note: /maxcpucount default is 1 (sequential) — always use -m for parallel builds. Covers /maxcpucount, graph build for better scheduling and isolation, BuildInParallel on MSBuild task, reducing unnecessary ProjectReferences, solution filters (.slnf) for building subsets. DO NOT USE FOR: single-p

دانلود ZIP