ターゲットの実行前に、プロジェクトファイルの処理、インポートチェーン、およびglob展開のコストを分析することで、MSBuildの評価におけるボトルネックを診断します。
- GitHubスター
- 5,942
- ファイル
- 1
- 最終コミット
- 2026年11月11日
- ライセンス
- MIT
- 許可されたツール
- —
eval-performance skillは何をしますか
ターゲットの実行前に、プロジェクトファイルの処理、インポートチェーン、およびglob展開のコストを分析することで、MSBuildの評価におけるボトルネックを診断します。
skillのSKILL.mdから生成された要約。
eval-performance skill について
複雑なビルドシステムを管理する開発者にとって、このSKILLはターゲットが実行される前にMSBuildの評価ボトルネックを特定することを可能にします。このSKILLは、MSBuildがプロジェクトファイルを読み込み、インポートを処理し、globを展開するフェーズに焦点を当てています。このフェーズは、コンパイルが必要ない場合でもビルドの開始を遅らせる原因となります。このツールは、ターゲットの実行や増分ビルドの問題ではなく、評価フェーズ自体が遅延の具体的な原因であるという証拠が得られているユーザーを対象としています。
binlogやパフォーマンスサマリーから、初期のプロジェクト処理フェーズにおいて高いコストがかかっていることが示された場合、エージェントはこのSKILLをロードすべきです。このSKILLは、binlog MCP serverを利用して評価時間のリストアップ、グローバルプロパティの検査、およびインポートチェーンの深さの分析を行います。また、プリプロセス技術を用いて展開されたプロジェクトファイルを調査し、node_modulesや.gitディレクトリを走査するような高コストなglobパターンを特定します。これらの具体的なメトリクスを分析することで、深いインポートチェーン、異なるグローバルプロパティ下での冗長な評価、またはファイルI/Oを伴うプロパティ関数のどれが原因であるかを特定するのに役立ちます。
エージェントができること
- 1インポートチェーンの深さを分析プロジェクトのインポート階層が過度に深く、ビルドの開始を遅らせていないかを判断します。
- 2冗長なプロジェクト評価の検出グローバルプロパティの違いにより、プロジェクトが複数回評価されていないかを確認します。
- 3プロパティ関数のコストを検査評価フェーズ中に重いファイルI/Oを実行するプロパティ関数がないかを確認します。
skill の SKILL.md から作成されています。すべてのユースケースは、その引用と照合されています。
eval-performance skillのインストール方法
各コマンドはskillフォルダをクライアントのskillsディレクトリにコピーします。読み込むには、クライアントを再起動するか新しいセッションを開始してください。プラグインにeval-performance skillをインストールする
/plugin marketplace add dotnet/skills /plugin install dotnet-msbuild@dotnet-agent-skills
Claude Codeにeval-performance skillをインストールする
~/.claude/skills/eval-performance/SKILL.md
$ npx degit dotnet/skills/plugins/dotnet-msbuild/skills/eval-performance ~/.claude/skills/eval-performanceClaude Code (project)にeval-performance skillをインストールする
.claude/skills/eval-performance/SKILL.md
$ npx degit dotnet/skills/plugins/dotnet-msbuild/skills/eval-performance .claude/skills/eval-performanceCodexにeval-performance skillをインストールする
~/.agents/skills/eval-performance/SKILL.md
$ npx degit dotnet/skills/plugins/dotnet-msbuild/skills/eval-performance ~/.agents/skills/eval-performanceGemini CLIにeval-performance skillをインストールする
~/.gemini/skills/eval-performance/SKILL.md
$ npx degit dotnet/skills/plugins/dotnet-msbuild/skills/eval-performance ~/.gemini/skills/eval-performanceClaude.aiにeval-performance skillをインストールする
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
自動チェック
実行日 2026年11月15日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。エージェントに実行させる前にスクリプトを読んでください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能dotnet/skills/plugins/dotnet-msbuild/skills/eval-performance is public and reachablegithub.com/dotnet/skills/tree/HEAD/plugins/dotnet-msbuild/sk ↗合格
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit 2026-11-11github.com/dotnet/skills/commits ↗合格
- スクリプトにダウンロード実行や認証情報の窃取がないNo scripts in the skill folder合格
- SKILL.md に隠れた指示がないNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/dotnet/skills/blob/HEAD/plugins/dotnet-msbuild/sk ↗合格
- 事前許可ツールが限定されているNo pre-approved tools; the agent asks before using onegithub.com/dotnet/skills/blob/HEAD/plugins/dotnet-msbuild/sk ↗合格
- SKILL.md が Agent Skills の形式に従っているValid name and description; says when to use it; 130 linesgithub.com/dotnet/skills/blob/HEAD/plugins/dotnet-msbuild/sk ↗合格
SKILL.md
GitHubで表示Diagnosing 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
このスキルのファイル
1eval-performance skillに関する質問
Claude Codeにeval-performance skillをインストールするには
npx degit dotnet/skills/plugins/dotnet-msbuild/skills/eval-performance ~/.claude/skills/eval-performanceを実行してください。Claude Codeは~/.claude/skills(すべてのプロジェクト)または.claude/skills(単一プロジェクト)からskillsを読み込み、説明がタスクに一致する場合にskillを使用します。
eval-performance skillはどのクライアントで使用できますか
Agent Skills形式を読み込むすべてのクライアントで使用できます: Claude Code、Codex、Gemini CLI、claude.ai(ZIPとしてアップロード)。skill内のスクリプトは、クライアントがコード実行を許可した場合にのみ実行されます。
どのような時にこのSKILLを使用すべきですか?
グローバルプロパティのバリエーションによる評価の重複、高コストなglob(node_modulesや.gitなど)、深いインポートチェーン、または巨大なプリプロセス済みファイルなどの評価フェーズにおける問題を診断する場合に使用してください。ターゲットの実行時におけるボトルネックや、増分ビルドの問題の解決には使用しないでください。