Diagnostica cuellos de botella en la evaluación de MSBuild analizando el procesamiento de archivos de proyecto, las cadenas de importación y los costos de expansión de globs antes de la ejecución de los targets.
- Estrellas en GitHub
- 5942
- Archivos
- 1
- Último commit
- 11 nov 2026
- Licencia
- MIT
- Herramientas permitidas
- —
¿Qué hace la skill eval-performance?
Diagnostica cuellos de botella en la evaluación de MSBuild analizando el procesamiento de archivos de proyecto, las cadenas de importación y los costos de expansión de globs antes de la ejecución de los targets.
Resumen generado a partir del SKILL.md de la skill.
Sobre la skill eval-performance
Identificar cuellos de botella en la evaluación de MSBuild antes de que se ejecute cualquier target es lo que este SKILL permite a los desarrolladores que gestionan sistemas de construcción complejos. Se centra en la fase en la que MSBuild lee los archivos de proyecto, procesa las importaciones y expande los globs, lo que puede causar inicios de compilación lentos incluso cuando no se requiere compilación. Esta herramienta está destinada a usuarios que tienen evidencia medida de que la evaluación es la fuente específica de la lentitud, en lugar de problemas de ejecución de targets o de reconstrucción incremental.
Un agente debe cargar este SKILL cuando un binlog o un resumen de rendimiento indica costos altos durante las fases iniciales de procesamiento del proyecto. Se apoya en el MCP server de binlog para listar las duraciones de evaluación, inspeccionar propiedades globales y analizar la profundidad de las cadenas de importación. También utiliza técnicas de preprocesamiento para examinar los archivos de proyecto expandidos e identificar patrones de glob costosos, como aquellos que recorren directorios node_modules o .git. Al analizar estas métricas específicas, el SKILL ayuda a determinar si los culpables son las cadenas de importación profundas, las evaluaciones redundantes bajo diferentes propiedades globales o las funciones de propiedades con un uso intensivo de file-I/O.
Lo que un agente puede hacer con ella
- 1Analizar la profundidad de la cadena de importaciónDetermina si un proyecto tiene una jerarquía de importaciones excesivamente profunda que ralentiza el inicio de la construcción.
- 2Detectar evaluaciones de proyecto redundantesComprueba si un proyecto se está evaluando varias veces debido a diferentes propiedades globales.
- 3Inspeccionar los costos de las funciones de propiedadesBusca funciones de propiedades que realicen un file-I/O intensivo durante la fase de evaluación.
Escrito a partir del SKILL.md de la skill. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar la skill eval-performance
Cada comando copia la carpeta de la skill al directorio de skills del cliente. Reinicia el cliente o inicia una nueva sesión para cargarla.Instalar la skill eval-performance en Plugin
/plugin marketplace add dotnet/skills /plugin install dotnet-msbuild@dotnet-agent-skills
Instalar la skill eval-performance en Claude Code
~/.claude/skills/eval-performance/SKILL.md
$ npx degit dotnet/skills/plugins/dotnet-msbuild/skills/eval-performance ~/.claude/skills/eval-performanceInstalar la skill eval-performance en Claude Code (project)
.claude/skills/eval-performance/SKILL.md
$ npx degit dotnet/skills/plugins/dotnet-msbuild/skills/eval-performance .claude/skills/eval-performanceInstalar la skill eval-performance en Codex
~/.agents/skills/eval-performance/SKILL.md
$ npx degit dotnet/skills/plugins/dotnet-msbuild/skills/eval-performance ~/.agents/skills/eval-performanceInstalar la skill eval-performance en Gemini CLI
~/.gemini/skills/eval-performance/SKILL.md
$ npx degit dotnet/skills/plugins/dotnet-msbuild/skills/eval-performance ~/.gemini/skills/eval-performanceInstalar la skill eval-performance en Claude.ai
npx degit dotnet/skills/plugins/dotnet-msbuild/skills/eval-performance eval-performance && zip -r eval-performance.zip eval-performance # claude.ai → Customize → Skills → + → Create skill → Upload a skill → eval-performance.zip
Verificaciones automáticas
Ejecutado 15 nov 2026Informe completo →Superó nuestras comprobaciones automáticas. No es una auditoría de seguridad: lee los scripts antes de dejar que un agente los ejecute. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibledotnet/skills/plugins/dotnet-msbuild/skills/eval-performance is public and reachablegithub.com/dotnet/skills/tree/HEAD/plugins/dotnet-msbuild/sk ↗Aprobado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit 2026-11-11github.com/dotnet/skills/commits ↗Aprobado
- Sin descargar y ejecutar ni robo de credenciales en los scriptsNo scripts in the skill folderAprobado
- Sin instrucciones ocultas en SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/dotnet/skills/blob/HEAD/plugins/dotnet-msbuild/sk ↗Aprobado
- Las herramientas preaprobadas están acotadasNo pre-approved tools; the agent asks before using onegithub.com/dotnet/skills/blob/HEAD/plugins/dotnet-msbuild/sk ↗Aprobado
- SKILL.md sigue el formato de Agent SkillsValid name and description; says when to use it; 130 linesgithub.com/dotnet/skills/blob/HEAD/plugins/dotnet-msbuild/sk ↗Aprobado
SKILL.md
Ver en GitHubDiagnosing MSBuild Evaluation Performance
Evaluation is the work MSBuild does before any target runs — reading project files, processing imports, expanding globs. This skill helps you find and confirm evaluation bottlenecks. Measure first; recommend a change only when a measurement proves it is warranted.
Confirm the problem before changing anything
Engage only when evaluation is measurably the bottleneck. Do NOT act when:
- The slowness is during compilation or target execution, not evaluation.
That is not an evaluation problem — use
build-perf-diagnosticsinstead. - The complaint is "rebuilds too much" / incremental build. Use
incremental-buildinstead. - You have no measurement. If no binlog or timing summary shows evaluation is slow, gather one first (see below). Do not guess from reading project files.
- A pattern below appears but evaluation is already fast. Broad globs, deep
imports, or
EnableDefaultItemsare only worth flagging when the numbers show they cost real time. A project that evaluates quickly needs no change.
When a pattern is present but unmeasured, report it as an observation and let the user decide — do not rewrite working configuration to match a "best practice" without evidence it costs measurable evaluation time. Prefer the smallest, most targeted change; never disable SDK defaults as a first move.
MSBuild Evaluation Phases
For a comprehensive overview of MSBuild's evaluation and execution model, see Build process overview.
- Initial properties: environment variables, global properties, reserved properties
- Imports and property evaluation: process
<Import>, evaluate<PropertyGroup>top-to-bottom - Item definition evaluation:
<ItemDefinitionGroup>metadata defaults - Item evaluation:
<ItemGroup>withInclude,Remove,Update, glob expansion - UsingTask evaluation: register custom tasks
Key insight: evaluation happens BEFORE any targets run. Slow evaluation = slow build start even when nothing needs compiling.
Diagnosing Evaluation Performance
Primary: binlog MCP (preferred)
Use the binlog MCP server (Microsoft.AITools.BinlogMcp, exposed under the binlog MCP namespace) to analyze evaluation performance:
- Use the evaluations tool to list all evaluations and their durations
- Use evaluation_global_properties to check for multiple evaluations with differing global properties
- Use evaluation_properties to inspect evaluated properties for a specific project+TFM
- Use imports tool to analyze the import chain depth and structure
- Use properties tool to check for expensive property function evaluations
Fallback: text-log replay and preprocessing (when MCP is unavailable)
Using binlog
- Replay the binlog:
dotnet msbuild build.binlog -noconlog -fl "-flp:v=diag;logfile=full.log" - Search for evaluation events:
grep -i 'Evaluation started\|Evaluation finished' full.log - Multiple evaluations for the same project = overbuilding
- Look for "Project evaluation started/finished" messages and their timestamps
Using /pp (preprocess)
dotnet msbuild -pp:full.xml MyProject.csproj- Shows the fully expanded project with ALL imports inlined
- Use to understand: what's imported, import depth, total content volume
- Large preprocessed output (>10K lines) = heavy evaluation
Using /clp:PerformanceSummary
- Add to build command for timing breakdown
- Shows evaluation time separately from target/task execution
Expensive Glob Patterns
Only pursue these remedies once a measurement shows item evaluation is slow and the globs are the cause; a custom glob that isn't walking large trees is fine.
- Globs like
**/*.cswalk the entire directory tree - Default SDK globs are optimized, but custom globs may not be
- Problem: globbing over
node_modules/,.git/,bin/,obj/— millions of files - Remedy: use
<DefaultItemExcludes>to exclude large directories - Remedy: be specific with glob paths:
src/**/*.csinstead of**/*.cs - Remedy: use
<EnableDefaultItems>false</EnableDefaultItems>only as a last resort (loses SDK defaults) — prefer the two options above first - Check: grep for Compile items in the diagnostic log → if Compile items include unexpected files, globs are too broad
Import Chain Analysis
- Deep import chains (>20 levels) slow evaluation
- Each import: file I/O + parse + evaluate
- Common causes: NuGet packages adding .props/.targets, framework SDK imports, Directory.Build chains
- Diagnosis:
/ppoutput → search for<!-- Importingcomments to see import tree - Remedy (only if the chain is measurably costly): reduce transitive package imports where possible, consolidate imports
Multiple Evaluations
- A project evaluated multiple times = wasted work
- Common causes: referenced from multiple other projects with different global properties
- Each unique set of global properties = separate evaluation
- Diagnosis:
grep 'Evaluation started.*ProjectName' full.log→ if count > 1, check for differing global properties - Fix: normalize global properties, use graph build (
/graph)
TreatAsLocalProperty
- Prevents property values from flowing to child projects via MSBuild task
- Overuse: declaring many TreatAsLocalProperty entries adds evaluation overhead
- Correct use: only when you genuinely need to override an inherited property
Property Function Cost
- Property functions execute during evaluation
- Most are cheap (string operations)
- Expensive:
$([System.IO.File]::ReadAllText(...))during evaluation — reads file on every evaluation - Expensive: network calls, heavy computation
- Rule: property functions should be fast and side-effect-free
Optimization Checklist
- Check preprocessed output size:
dotnet msbuild -pp:full.xml - Verify evaluation count: should be 1 per project per TFM
- Exclude large directories from globs
- Avoid file I/O in property functions during evaluation
- Minimize import depth
- Use graph build to reduce redundant evaluations
- Check for unnecessary UsingTask declarations
Archivos de esta skill
1Preguntas sobre la skill eval-performance
¿Cómo instalo la skill eval-performance en Claude Code?
Ejecuta npx degit dotnet/skills/plugins/dotnet-msbuild/skills/eval-performance ~/.claude/skills/eval-performance. Claude Code carga las skills desde ~/.claude/skills (todos los proyectos) o .claude/skills (un proyecto) y usa una skill cuando su descripción coincide con la tarea.
¿Qué clientes pueden usar la skill eval-performance?
Cualquier cliente que lea el formato Agent Skills: Claude Code, Codex, Gemini CLI y claude.ai (subir como ZIP). Los scripts de la skill se ejecutan solo donde el cliente permite la ejecución de código.
¿Cuándo debería usar este SKILL?
Usa este SKILL para diagnosticar repeticiones de solo evaluación bajo variantes de propiedades globales, globs costosos (como node_modules o .git), cadenas de importación profundas o archivos preprocesados de gran tamaño. No lo uses para cuellos de botella en la ejecución o problemas de reconstrucción incremental.