Przejdź do treści
Biblioteka skilli
Programowanie · Przegląd i audyt

binlog-failure-analysis

/binlog-failure-analysis

Analizuje binarne logi MSBuild (.binlog), by zdiagnozować błędy buildu niejasne z konsoli: kaskadowe awarie w wieloprojektowych buildach, kolejność wykonania targetów i inne problemy MSBuild.

Repozytorium
skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
26.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Analizuje binarne logi MSBuild (.binlog), by zdiagnozować błędy buildu niejasne z konsoli: kaskadowe awarie w wieloprojektowych buildach, kolejność wykonania targetów i inne problemy MSBuild.

Oryginalny opis (EN)

Analyze MSBuild binary logs to diagnose build failures. 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), binlog MCP startup or connection failures (use troubleshoot-binlog-mcp), non-MSBuild build systems.

Jak działa

  1. Primary workflow — binlog MCP
  2. Fallback workflow — text-log replay (when MCP is unavailable)
  3. Generating a binlog (only if none exists)
Sekcje z nagłówków SKILL.md, w oryginale · 61 linii, 375 słów
Podgląd SKILL.md
---
name: binlog-failure-analysis
description: "Analyze MSBuild binary logs to diagnose build failures. 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), binlog MCP startup or connection failures (use troubleshoot-binlog-mcp), non-MSBuild build systems."
license: MIT
---

# Analyzing MSBuild Failures with Binary Logs

This skill diagnoses MSBuild build failures from a `.binlog` file. The preferred
path uses the **binlog MCP server** (`Microsoft.AITools.BinlogMcp`, exposed under the
`binlog` MCP namespace) which is bundled with this plugin. If the MCP server is
not available, use `troubleshoot-binlog-mcp` to diagnose startup when repair is wanted.
If repair is blocked, declined, or unnecessary for this task, continue with the
**binlog replay** workflow at the bottom.

## Primary workflow — binlog MCP

The MCP server exposes structured tools for inspecting a `.binlog` without
parsing text logs. Call them directly instead of replaying the binlog to a text
file. Call `tools/list` for the MCP first if you are unsure which tools are available.

**Important constraints:**
- The `.binlog` file is a **binary format** — do NOT try to `cat`, `head`, `strings`, or read it directly. Use only the MCP tools to query it.
- The **original source/project files might or might NOT be available on disk**. Project files (.csproj, .props, .targets, App.config, etc.) - if you cannot locate them on disk, they can only be read from within the binlog via MCP tools (e.g., embedded/source file retrieval).
- **Synthesize findings as you go.** Do not spend all available time investigating — once you have enough evidence, present your conclusions. A partial answer with clear reasoning is better than timing out mid-investigation.

Use the available MCP server tools to query the binary log for:
- Build errors and warnings
- MSBuild properties and their values
- MSBuild items (PackageReference, ProjectReference, etc.)
- Project evaluation data
- Target execution details
- File contents embedded in the binlog

## Fallback workflow — text-log replay (when MCP is unavailable)

Use this only when the MCP server cannot be started (for example, on an older
SDK or in an offline environment).

### Replay the binlog to text logs

```bash
dotnet msbuild build.binlog -noconlog \
  -fl  "-flp:v=diag;logfile=full.log;performancesummary" \
  -fl1 "-flp1:errorsonly;logfile=errors.log" \
  -fl2 "-flp2:warningsonly;logfile=warnings.log"
```

> **PowerShell note:** Use `-flp:"v=diag;logfile=full.log;performancesummary"`
> (quoted semicolons).

### Search the text logs

```bash
cat errors.log
grep -n -B2 -A2 "CS0246" full.log
grep -i "CoreCompile.*FAILED\|Build FAILED\|error MSB" full.log
grep 'Target "CoreCompile"' full.log | grep -oP 'project "[^"]*"'
```

## Generating a binlog (only if none exists)

```bash
dotnet build /bl:build.binlog
```

Wersje

RepozytoriumWynikLicencja
Ta strona · dotnet/skills100MIT
arklab/ark.tools100MIT
ANcpLua/ancplua-claude-plugins100MIT
dotnet/arcade-skills100MIT

Identyczna treść występuje jeszcze w 4 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.

Migawka bazy z 13.11.2026 · wersja paczki 402f8f5a601e (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100binlog-generation
    Generuje binarne logi MSBuild (binlogi) do diagnostyki buildów przez dodanie /bl:{} do poleceń dotnet build, test, pack, publish i restore, jako podstawę analizy błędów i wydajności.
  • 100troubleshoot-binlog-mcp
    Diagnozuje błędy uruchamiania serwera binlog MCP w dotnet-msbuild, sprawdzając SDK, feedy i mapowanie źródeł.
  • 98deploy-msbuild-to-vs
    Wdraża lokalnie zbudowane pliki MSBuild do Visual Studio, by IDE używało zmian przy testach i debugowaniu.
  • 100dotnet-engineering
    Ustala standardy pracy w .NET i C#: dotnet test, jakość testów, BenchmarkDotNet, diagnoza MSBuild z binlog, ostrzeżenia trimmingu i AOT oraz publikacja pakietu NuGet z GitHub Actions.
  • 100use-bootstrap-msbuild
    Prowadzi testowanie reprodukcji błędów na lokalnie zbudowanym MSBuild, aby sprawdzić poprawkę przed zgłoszeniem PR.
  • 100visual-studio
    Pomaga w pracy z Visual Studio: C++, .NET i C#, konfiguracja MSBuild, narzędzia diagnostyczne, profilowanie CPU i pamięci oraz debugowanie aplikacji wielowątkowych.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.