dotnet-testing-advanced-xunit-upgrade-guide — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited dotnet-testing-advanced-xunit-upgrade-guide (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
xUnit v3 採用全新的套件命名策略：
| v1~v2 套件名稱 | v3 套件名稱 | 說明 |
|---|---|---|
xunit | xunit.v3 | 主要測試框架 |
xunit.assert | xunit.v3.assert | 斷言函式庫 |
xunit.core | xunit.v3.core | 核心元件 |
xunit.abstractions | (移除) | 不再需要 |
xunit.runner.visualstudio | xunit.runner.visualstudio (3.x.y) | 測試執行器 |
重要：使用 xunit.v3 套件名稱，不是 xunit。
涵蓋 OutputType 改為 Exe、async void 不再支援、IAsyncLifetime 繼承 IAsyncDisposable、SkippableFact 移除、僅支援 SDK-style 專案、自訂 DataAttribute 簽名變更等六項破壞性變更，每項皆附修正前後的程式碼對照。
完整破壞性變更清單與程式碼範例請參考 references/breaking-changes.md
五步驟 SOP：建立升級分支 → 更新專案檔案（套件、OutputType）→ 修正 async void → 更新 using → 編譯與測試。另含 .NET 10 SDK MTP 模式遷移指南（global.json 設定、CLI 用法變更、VSTest 遷移步驟）。
完整升級步驟與 .NET 10 MTP 模式指南請參考 references/upgrade-steps.md
涵蓋 Assert.Skip / SkipUnless / SkipWhen 動態跳過、Explicit Tests、[Test] 屬性、MatrixTheoryData 矩陣測試、Assembly Fixtures、Test Pipeline Startup、多格式測試報告等新功能，每項皆附完整程式碼範例。
完整新功能範例請參考 references/new-features.md
Testcontainers 官方推出 Testcontainers.XunitV3（4.9.0），專為 xUnit v3 設計的整合套件，自動管理容器的建立與銷毀，取代手動實作 IAsyncLifetime 的方式。
<PackageReference Include="Testcontainers.XunitV3" Version="4.9.0" />若專案同時使用 Testcontainers 與 xUnit v3，建議採用此套件簡化容器生命週期管理。
{
"$schema": "https://xunit.net/schema/v3/xunit.runner.schema.json",
"parallelAlgorithm": "conservative",
"maxParallelThreads": 4,
"diagnosticMessages": true,
"internalDiagnosticMessages": false,
"methodDisplay": "classAndMethod",
"preEnumerateTheories": true,
"stopOnFail": false
}移除 using Xunit.Abstractions;，相關類型已移到 Xunit 命名空間。
確認 IDE 版本：Visual Studio 2022 17.8+、Rider 2023.3+、VS Code 最新版。如仍有問題，可暫時停用 MTP：
<PropertyGroup>
<EnableMicrosoftTestingPlatform>false</EnableMicrosoftTestingPlatform>
</PropertyGroup>.NET 10 SDK 注意：若使用 MTP 模式，停用 MTP 會導致dotnet test錯誤。應改為移除global.json中的test區段。
xunit.v3)xunit.abstractions 參考global.json 啟用 MTP 模式並驗證 dotnet test 正常運作| IDE | 最低版本 |
|---|---|
| Visual Studio | 2022 17.8+ |
| VS Code | 最新版 |
| Rider | 2023.3+ |
xUnit 3.x 預設啟用 Microsoft Testing Platform（MTP），搭配 .NET 10 SDK 可使用原生 MTP 模式。
.NET 10 MTP 模式詳細設定請參考 references/upgrade-steps.md
本技能內容提煉自「老派軟體工程師的測試修練 - 30 天挑戰」系列文章：
dotnet-testing-xunit-project-setup - xUnit 專案設定基礎dotnet-testing-advanced-tunit-fundamentals - TUnit 替代框架dotnet-testing-advanced-testcontainers-database - Testcontainers 資料庫整合測試（搭配 XunitV3 套件）~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.