.NET 進階測試技能總覽

.NET 進階測試技能總覽

---

🤖 AI Agent 重要提示

當您（AI Agent）被載入此進階入口 skill 時，請先閱讀以下指引：

📋 本技能的定位

本檔案是「進階測試導航中心」，用於幫助找到正確的進階子技能。

您的任務是

1. ✅ 根據使用者需求匹配對應的進階子技能
2. ✅ 使用 Skill tool 載入具體的子技能
3. ✅ 讓子技能提供專業的整合測試指引

禁止行為

• ❌ 不要在本入口 skill 中直接提供整合測試程式碼
• ❌ 不要在沒有載入子技能的情況下開始實作測試
• ❌ 不要跳過子技能直接提供「一般性」整合測試建議

---

🎯 快速技能對照表（AI Agent 必讀）

使用者提到的關鍵字 → 應載入的進階子技能

整合測試技能

容器化測試技能

微服務測試技能

框架升級技能

---

⚠️ 使用流程範例

✅ 正確流程

使用者：請幫我建立 ProductsController 的 API 整合測試

AI：我注意到您需要進行 API 整合測試。根據快速對照表，
    我應該載入 dotnet-testing-advanced-aspnet-integration-testing skill。

    [使用 Skill tool 載入子技能]

AI：現在按照 ASP.NET Core Integration Testing skill 的指引為您建立測試...

❌ 錯誤流程

使用者：請幫我建立 ProductsController 的 API 整合測試

AI：好的，我來寫整合測試...（直接開始寫程式碼，沒有載入子技能）

---

📚 完整技能清單

如需查看完整的 8 個進階技能清單、詳細決策樹、學習路徑建議，請繼續閱讀本檔案後續內容。

人類開發者參考：如需快速查找，請查看 SKILLS_QUICK_INDEX.md

---

適用情境

當您需要以下進階測試能力時，我會協助您找到正確的技能：

• 測試完整的 Web API 端點與 HTTP 流程
• 在測試中使用真實的資料庫（容器化）
• 測試 NoSQL 資料庫（MongoDB、Redis 等）
• 測試微服務架構與分散式系統
• 升級測試框架版本（xUnit 2.x → 3.x）
• 遷移到新測試框架（TUnit）
• 建立端到端的整合測試

快速決策樹

我需要哪種進階測試？

情境 1：測試 ASP.NET Core Web API

選項 A - 基礎 API 測試 → dotnet-testing-advanced-aspnet-integration-testing

適合：

• 簡單的 API 端點測試
• 不需要真實資料庫（使用記憶體資料庫）
• 測試路由、模型綁定、HTTP 回應

涵蓋內容：

• WebApplicationFactory 使用
• TestServer 設定
• HTTP 回應驗證
• 記憶體資料庫配置

---

選項 B - 完整的 WebAPI 流程測試 → dotnet-testing-advanced-webapi-integration-testing

適合：

• 完整的 CRUD API 測試
• 需要測試完整的業務流程
• 需要測試資料準備與清理

涵蓋內容：

• 完整的 GET、POST、PUT、DELETE 測試
• 錯誤處理驗證
• 測試基底類別模式
• 資料準備策略

---

情境 2：測試需要真實資料庫

選項 A - 關聯式資料庫（SQL Server、PostgreSQL、MySQL） → dotnet-testing-advanced-testcontainers-database

適合：

• Entity Framework Core 測試
• Dapper 測試
• 真實資料庫行為驗證
• 需要測試資料庫特定功能（stored procedures、triggers 等）

支援資料庫：

• SQL Server
• PostgreSQL
• MySQL
• MariaDB

---

選項 B - NoSQL 資料庫（MongoDB、Redis、Elasticsearch） → dotnet-testing-advanced-testcontainers-nosql

適合：

• MongoDB 文件操作測試
• Redis 快取測試
• Elasticsearch 搜尋測試
• NoSQL 特有功能測試

支援資料庫：

• MongoDB
• Redis
• Elasticsearch

---

情境 3：測試微服務架構

→ dotnet-testing-advanced-aspire-testing

適合：

• .NET Aspire 專案
• 分散式應用測試
• 服務間通訊測試
• 微服務整合測試

涵蓋內容：

• DistributedApplication 測試
• 服務依賴管理
• 跨服務測試
• 測試容器編排

---

情境 4：升級或遷移測試框架

選項 A - xUnit 升級（2.x → 3.x） → dotnet-testing-advanced-xunit-upgrade-guide

適合：

• 現有專案使用 xUnit 2.x
• 想升級到 xUnit 3.x
• 了解版本差異

涵蓋內容：

• 重大變更說明
• 升級步驟指引
• 相容性問題處理
• 最佳實踐

---

選項 B - 遷移到 TUnit（基礎） → dotnet-testing-advanced-tunit-fundamentals

適合：

• 評估是否遷移到 TUnit
• 了解 TUnit 基礎
• 學習 TUnit 與 xUnit 的差異

涵蓋內容：

• TUnit 核心概念
• 與 xUnit 對比
• 遷移步驟
• 基本使用方式

---

選項 C - TUnit 進階功能 → dotnet-testing-advanced-tunit-advanced

適合：

• 已使用 TUnit 基礎
• 想深入使用 TUnit 功能
• 需要平行執行、依賴注入等進階特性

涵蓋內容：

• 資料驅動測試
• 依賴注入
• 平行執行控制
• 進階特性

---

技能分類地圖

1. 整合測試（4 個技能）- Web API 測試

技能詳細說明

aspnet-integration-testing

核心價值：

• 學習 WebApplicationFactory 基礎
• 理解整合測試概念
• 測試 HTTP 端點而不啟動真實伺服器

適合情境：

• API 端點基礎測試
• 路由驗證
• 中介軟體測試
• 不需要真實資料庫

學習難度：⭐⭐ 中等

前置技能：

• dotnet-testing-unit-test-fundamentals（必須）
• dotnet-testing-awesome-assertions-guide（建議）

---

webapi-integration-testing

核心價值：

• 完整的 API 測試流程
• 測試資料管理策略
• 錯誤處理驗證
• 真實業務場景測試

適合情境：

• 正式專案的 API 測試
• 完整的 CRUD 流程
• 複雜的業務邏輯驗證
• 需要測試資料準備與清理

學習難度：⭐⭐⭐ 中高

前置技能：

• dotnet-testing-advanced-aspnet-integration-testing（必須）
• dotnet-testing-nsubstitute-mocking（建議）

---

testcontainers-database

核心價值：

• 使用真實資料庫測試
• 自動化容器管理
• 測試資料庫特定功能
• 隔離的測試環境

適合情境：

• EF Core 測試
• Dapper 測試
• Stored Procedures 測試
• 資料庫遷移測試

學習難度：⭐⭐⭐ 中高

前置技能：

• dotnet-testing-unit-test-fundamentals（必須）
• Docker 基礎知識（必須）

技術需求：

• Docker Desktop 已安裝
• WSL2（Windows 環境）

---

testcontainers-nosql

核心價值：

• 測試 NoSQL 資料庫操作
• 容器化 NoSQL 環境
• 真實資料庫行為驗證

適合情境：

• MongoDB 文件操作
• Redis 快取邏輯
• Elasticsearch 搜尋功能

學習難度：⭐⭐⭐ 中高

前置技能：

• dotnet-testing-advanced-testcontainers-database（建議）
• NoSQL 資料庫基礎知識

---

2. 微服務測試（1 個技能）- 分散式系統

技能詳細說明

aspire-testing

核心價值：

• 測試 .NET Aspire 專案
• 分散式應用整合測試
• 服務依賴管理
• 端到端流程驗證

適合情境：

• .NET Aspire 微服務專案
• 多服務協作測試
• 服務發現測試
• 分散式追蹤驗證

學習難度：⭐⭐⭐⭐ 高

前置技能：

• dotnet-testing-advanced-aspnet-integration-testing（必須）
• dotnet-testing-advanced-testcontainers-database（建議）
• .NET Aspire 基礎知識（必須）

技術需求：

• .NET 8+
• .NET Aspire Workload
• Docker Desktop

涵蓋內容：

• DistributedApplication 測試
• 服務間通訊測試
• 依賴服務管理
• 測試容器編排

---

3. 框架遷移（3 個技能）- 測試框架升級

技能詳細說明

xunit-upgrade-guide

核心價值：

• 了解 xUnit 3.x 新特性
• 處理升級問題
• 遷移步驟指引

適合情境：

• 專案使用 xUnit 2.x
• 想升級到最新版本
• 了解版本差異

學習難度：⭐⭐ 中等

涵蓋內容：

• 重大變更清單
• 套件升級步驟
• 相容性問題處理
• 升級檢查清單

何時升級：

• 需要 xUnit 3.x 新功能
• .NET 9+ 專案
• 解決已知問題

---

tunit-fundamentals

核心價值：

• 了解 TUnit 新世代測試框架
• 學習 TUnit 核心概念
• 評估遷移可行性

適合情境：

• 考慮從 xUnit 遷移
• 新專案選擇測試框架
• 了解現代測試框架

學習難度：⭐⭐ 中等

涵蓋內容：

• TUnit vs xUnit 對比
• 基本測試撰寫
• 屬性與斷言
• 遷移建議

TUnit 優勢：

• 更好的效能
• 原生支援依賴注入
• 更靈活的測試組織
• 現代化的 API 設計

---

tunit-advanced

核心價值：

• 深入使用 TUnit 進階功能
• 平行執行控制
• 依賴注入整合
• 資料驅動測試

適合情境：

• 已使用 TUnit 基礎
• 需要進階功能
• 大型測試專案

學習難度：⭐⭐⭐ 中高

前置技能：

• dotnet-testing-advanced-tunit-fundamentals（必須）

涵蓋內容：

• 進階資料驅動測試
• 依賴注入容器
• 測試執行控制
• 自訂測試框架行為

---

常見任務映射表

任務 1：測試 ASP.NET Core Web API（基礎）

情境：為簡單的 ProductsController 建立整合測試

推薦技能：

• dotnet-testing-advanced-aspnet-integration-testing

適用條件：

• 簡單的 CRUD API
• 不需要真實資料庫
• 測試基本的 HTTP 端點

實施步驟：

1. 建立 CustomWebApplicationFactory
2. 設定記憶體資料庫
3. 撰寫 GET、POST 測試
4. 使用 FluentAssertions.Web 驗證回應

提示詞範例：

請使用 dotnet-testing-advanced-aspnet-integration-testing skill
為我的 ProductsController 建立整合測試。Controller 有 GetAll 和 GetById 兩個端點。

預期程式碼結構：

public class ProductsControllerTests : IClassFixture<CustomWebApplicationFactory>
{
    private readonly HttpClient _client;

    public ProductsControllerTests(CustomWebApplicationFactory factory)
    {
        _client = factory.CreateClient();
    }

    [Fact]
    public async Task GetAll_ShouldReturnProducts()
    {
        // Act
        var response = await _client.GetAsync("/​api/​products");

        // Assert
        response.Should().Be200Ok();
        var products = await response.Content.ReadFromJsonAsync<List<Product>>();
        products.Should().NotBeEmpty();
    }
}

---

任務 2：測試 ASP.NET Core Web API（完整流程）

情境：為 ShippersController 建立完整的 CRUD 測試

推薦技能：

• dotnet-testing-advanced-webapi-integration-testing

適用條件：

• 完整的 CRUD API
• 需要測試錯誤處理
• 需要測試資料準備與清理

實施步驟：

1. 建立測試基底類別（BaseIntegrationTest）
2. 實作 IAsyncLifetime 進行資料準備/清理
3. 測試所有 CRUD 端點
4. 驗證錯誤處理（404、400、409 等）

提示詞範例：

請使用 dotnet-testing-advanced-webapi-integration-testing skill
為我的 ShippersController 建立完整的 CRUD 測試。需要測試：
- GET /​api/​shippers（取得所有）
- GET /​api/​shippers/​{id}（取得單一）
- POST /​api/​shippers（新增）
- PUT /​api/​shippers/​{id}（更新）
- DELETE /​api/​shippers/​{id}（刪除）
並且驗證錯誤情境（如找不到資源）。

預期測試涵蓋：

• ✅ GET 成功回傳資料
• ✅ GET 不存在的 ID 回傳 404
• ✅ POST 新增成功
• ✅ POST 無效資料回傳 400
• ✅ PUT 更新成功
• ✅ PUT 不存在的 ID 回傳 404
• ✅ DELETE 刪除成功
• ✅ DELETE 不存在的 ID 回傳 404

---

任務 3：測試需要真實資料庫的程式碼（SQL）

情境：測試 OrderRepository（使用 SQL Server）

推薦技能：

• dotnet-testing-advanced-testcontainers-database

適用條件：

• 使用 EF Core 或 Dapper
• 需要測試真實資料庫行為
• 需要測試資料庫特定功能

實施步驟：

1. 設定 Testcontainers.MsSql
2. 執行資料庫遷移
3. 測試 Repository 方法
4. 每個測試後清理資料

提示詞範例：

請使用 dotnet-testing-advanced-testcontainers-database skill
為我的 OrderRepository 建立測試。Repository 使用 EF Core 連接 SQL Server。
需要測試 GetById、Create、Update、Delete 方法。

預期程式碼結構：

public class OrderRepositoryTests : IAsyncLifetime
{
    private MsSqlContainer _container;
    private OrderDbContext _context;
    private OrderRepository _sut;

    public async Task InitializeAsync()
    {
        // 啟動 SQL Server 容器
        _container = new MsSqlBuilder().Build();
        await _container.StartAsync();

        // 建立 DbContext
        var options = new DbContextOptionsBuilder<OrderDbContext>()
            .UseSqlServer(_container.GetConnectionString())
            .Options;

        _context = new OrderDbContext(options);
        await _context.Database.MigrateAsync();

        _sut = new OrderRepository(_context);
    }

    [Fact]
    public async Task GetById_ExistingOrder_ShouldReturnOrder()
    {
        // Arrange
        var order = new Order { /​* ... */ };
        await _context.Orders.AddAsync(order);
        await _context.SaveChangesAsync();

        // Act
        var result = await _sut.GetById(order.Id);

        // Assert
        result.Should().NotBeNull();
        result.Id.Should().Be(order.Id);
    }

    public async Task DisposeAsync()
    {
        await _container.DisposeAsync();
    }
}

---

任務 4：測試 NoSQL 資料庫（MongoDB、Redis）

情境：測試 CacheService（使用 Redis）

推薦技能：

• dotnet-testing-advanced-testcontainers-nosql

適用條件：

• 使用 MongoDB、Redis、Elasticsearch
• 需要測試 NoSQL 特定功能

實施步驟：

1. 設定 Testcontainers.Redis
2. 測試快取邏輯
3. 驗證過期時間
4. 測試快取失效

提示詞範例：

請使用 dotnet-testing-advanced-testcontainers-nosql skill
為我的 CacheService 建立測試。Service 使用 Redis 做快取。
需要測試 Set、Get、Remove 以及過期時間。

預期測試涵蓋：

• ✅ Set 成功儲存資料
• ✅ Get 成功取得資料
• ✅ Get 不存在的鍵回傳 null
• ✅ 過期時間正確運作
• ✅ Remove 成功移除資料

---

任務 5：測試微服務架構（.NET Aspire）

情境：測試 .NET Aspire 微服務專案

推薦技能：

• dotnet-testing-advanced-aspire-testing

適用條件：

• 使用 .NET Aspire
• 多服務協作
• 分散式應用

實施步驟：

1. 建立 DistributedApplication 測試
2. 設定服務依賴
3. 測試服務間通訊
4. 驗證完整流程

提示詞範例：

請使用 dotnet-testing-advanced-aspire-testing skill
為我的 .NET Aspire 專案建立測試。專案包含 API Service 和 Worker Service。
需要測試兩個服務的協作。

---

任務 6：升級 xUnit 到 3.x

情境：現有專案使用 xUnit 2.9.x，想升級到 3.x

推薦技能：

• dotnet-testing-advanced-xunit-upgrade-guide

實施步驟：

1. 了解重大變更
2. 更新套件版本
3. 處理相容性問題
4. 驗證測試執行

提示詞範例：

請使用 dotnet-testing-advanced-xunit-upgrade-guide skill
協助我升級專案中的 xUnit 到 3.x 版本。目前使用 2.9.2。

---

任務 7：評估是否遷移到 TUnit

情境：考慮從 xUnit 遷移到 TUnit

推薦技能：

1. dotnet-testing-advanced-tunit-fundamentals（了解基礎）
2. dotnet-testing-advanced-tunit-advanced（評估進階功能）

實施步驟：

1. 了解 TUnit 與 xUnit 差異
2. 評估遷移成本
3. 試驗性遷移一個測試檔案
4. 決定是否全面遷移

提示詞範例：

請使用 dotnet-testing-advanced-tunit-fundamentals skill
評估是否應將專案從 xUnit 遷移到 TUnit。專案目前有 500+ 測試。

---

整合測試層級對應

根據專案複雜度，選擇適合的測試策略：

Level 1：簡單的 WebApi 專案

專案特徵：

• 簡單的 CRUD API
• 無外部依賴或使用記憶體實作
• 業務邏輯簡單

推薦技能：

• dotnet-testing-advanced-aspnet-integration-testing

測試重點：

• 路由驗證
• 模型綁定
• HTTP 回應
• 基本業務邏輯

範例專案：

• TodoList API
• 簡單的產品目錄

---

Level 2：相依 Service 的 WebApi 專案

專案特徵：

• 有業務邏輯層（Services）
• 依賴外部服務（可以 Mock）
• 中等複雜度

推薦技能組合：

1. dotnet-testing-advanced-aspnet-integration-testing（基礎）
2. dotnet-testing-nsubstitute-mocking（模擬依賴）

測試策略：

• 使用 NSubstitute 建立 Service stub
• 測試 Controller 與 Service 的互動
• 驗證錯誤處理

範例專案：

• 電商 API（有庫存、訂單服務）
• CMS 系統

---

Level 3：完整的 WebApi 專案

專案特徵：

• 複雜的業務邏輯
• 需要真實資料庫
• 可能有外部 API 整合
• 完整的錯誤處理

推薦技能組合：

1. dotnet-testing-advanced-webapi-integration-testing（完整流程）
2. dotnet-testing-advanced-testcontainers-database（真實資料庫）
3. dotnet-testing-advanced-testcontainers-nosql（如有使用 NoSQL）

測試策略：

• 使用 Testcontainers 建立真實資料庫
• 完整的端到端測試
• 測試資料準備與清理
• 驗證所有錯誤情境

範例專案：

• 大型電商平台
• 企業級管理系統
• SaaS 應用

---

學習路徑建議

整合測試入門（1 週）

目標：掌握整合測試基礎，能為 Web API 建立測試

Day 1-2：基礎整合測試

技能：dotnet-testing-advanced-aspnet-integration-testing

學習重點：

• WebApplicationFactory 概念
• TestServer 使用
• HTTP 回應驗證
• 記憶體資料庫配置

實作練習：

• 為簡單的 API 建立整合測試
• 測試 GET、POST 端點

---

Day 3-4：完整 WebAPI 測試

技能：dotnet-testing-advanced-webapi-integration-testing

學習重點：

• 完整 CRUD 測試
• 測試基底類別設計
• 資料準備與清理
• 錯誤處理驗證

實作練習：

• 為完整的 Controller 建立測試
• 實作測試資料管理

---

Day 5-6：容器化資料庫測試

技能：dotnet-testing-advanced-testcontainers-database

學習重點：

• Testcontainers 概念
• SQL Server 容器設定
• 資料庫遷移執行
• 測試隔離

實作練習：

• 為 Repository 建立測試
• 使用真實資料庫

---

Day 7：NoSQL 資料庫測試

技能：dotnet-testing-advanced-testcontainers-nosql

學習重點：

• MongoDB 容器設定
• Redis 容器設定
• NoSQL 特定測試模式

實作練習：

• 測試 MongoDB Repository
• 測試 Redis Cache Service

---

微服務測試專精（3-5 天）

前置條件：完成整合測試入門

技能：dotnet-testing-advanced-aspire-testing

學習重點：

• .NET Aspire 架構理解
• DistributedApplication 測試
• 服務依賴管理
• 分散式測試策略

實作練習：

• 測試 Aspire 微服務專案
• 驗證服務間通訊

---

框架遷移路徑（依需求）

xUnit 升級（1-2 天）

技能：dotnet-testing-advanced-xunit-upgrade-guide

學習重點：

• xUnit 3.x 新特性
• 重大變更處理
• 升級步驟
• 相容性測試

實施步驟：

1. 了解版本差異
2. 更新套件
3. 處理編譯錯誤
4. 驗證測試執行

---

TUnit 遷移（2-5 天）

基礎（2-3 天） 技能：dotnet-testing-advanced-tunit-fundamentals

學習重點：

• TUnit 核心概念
• 與 xUnit 對比
• 基本測試撰寫
• 遷移建議

---

進階（2-3 天） 技能：dotnet-testing-advanced-tunit-advanced

學習重點：

• 資料驅動測試
• 依賴注入
• 平行執行控制
• 進階特性

---

技能組合建議

根據不同的專案需求，推薦以下技能組合：

組合 1：完整 API 測試專案

適合：建立正式專案的完整測試套件

技能組合：

1. dotnet-testing-advanced-aspnet-integration-testing（基礎）
2. dotnet-testing-advanced-testcontainers-database（真實資料庫）
3. dotnet-testing-advanced-webapi-integration-testing（完整流程）

學習順序：

1. 先學 aspnet-integration-testing 理解基礎
2. 再學 testcontainers-database 掌握資料庫測試
3. 最後學 webapi-integration-testing 整合應用

預期成果：

• 能為 Web API 專案建立完整測試
• 使用真實資料庫驗證行為
• 測試所有 CRUD 端點與錯誤處理

---

組合 2：微服務測試方案

適合：微服務架構、分散式系統

技能組合：

1. dotnet-testing-advanced-aspire-testing（核心）
2. dotnet-testing-advanced-testcontainers-database（資料庫）
3. dotnet-testing-advanced-testcontainers-nosql（NoSQL）

學習順序：

1. 先學 testcontainers（資料庫測試基礎）
2. 再學 aspire-testing（微服務測試）

預期成果：

• 測試 .NET Aspire 專案
• 驗證服務間通訊
• 使用容器化環境測試

---

組合 3：框架現代化

適合：測試框架升級或遷移

選項 A：xUnit 升級

技能：

• dotnet-testing-advanced-xunit-upgrade-guide

適合：

• 現有專案使用 xUnit 2.x
• 想升級到最新版本

---

選項 B：TUnit 遷移

技能組合：

1. dotnet-testing-advanced-tunit-fundamentals（基礎）
2. dotnet-testing-advanced-tunit-advanced（進階）

適合：

• 新專案選擇測試框架
• 考慮從 xUnit 遷移

學習順序：

1. 先學 fundamentals 了解基礎
2. 再學 advanced 掌握進階功能

---

前置技能要求

學習進階技能前，建議先掌握以下基礎技能（來自 dotnet-testing 基礎技能集）：

必備技能

1. dotnet-testing-unit-test-fundamentals

為什麼必須：

• 整合測試也遵循 3A Pattern
• FIRST 原則同樣適用
• 需要理解測試基礎概念

---

2. dotnet-testing-xunit-project-setup

為什麼必須：

• 需要建立測試專案
• 理解專案結構
• 了解套件管理

---

3. dotnet-testing-awesome-assertions-guide

為什麼必須：

• 整合測試需要驗證 HTTP 回應
• FluentAssertions.Web 提供強大的 API 斷言
• 提升測試可讀性

---

推薦技能

1. dotnet-testing-nsubstitute-mocking

為什麼推薦：

• 整合測試中可能需要 Mock 外部服務
• WebApplicationFactory 需要替換服務

---

2. dotnet-testing-autofixture-basics

為什麼推薦：

• 快速產生測試資料
• 減少整合測試的樣板程式碼

---

引導對話範例

以下範例展示 AI 如何與您互動，幫助您選擇正確的進階技能。

範例 1：API 測試需求

您：我想測試 Web API

AI：我會協助您建立 Web API 測試！請先確認您的測試需求：

1. API 複雜度：

• 簡單的 API（幾個端點）
• 中型 API（完整的 CRUD）
• 複雜 API（多層架構、複雜業務邏輯）

2. 資料庫需求：

• 不需要資料庫
• 記憶體資料庫即可
• 需要真實資料庫

3. 資料庫類型（如需要真實資料庫）：

• SQL Server / PostgreSQL / MySQL
• MongoDB / Redis / Elasticsearch
• 兩者都有

請告訴我您的選擇，我會推薦適合的技能組合。

---

您：中型 API，需要真實的 SQL Server 資料庫

AI：完美！根據您的需求，我推薦以下技能組合：

第一步：學習基礎整合測試（1-2 天） dotnet-testing-advanced-aspnet-integration-testing

• 理解 WebApplicationFactory
• 學習 HTTP 測試基礎

第二步：加入真實資料庫（2 天） dotnet-testing-advanced-testcontainers-database

• 使用 Testcontainers 設定 SQL Server
• 學習資料庫測試隔離

第三步：完整流程測試（2-3 天） dotnet-testing-advanced-webapi-integration-testing

• 實作完整的 CRUD 測試
• 測試資料管理策略
• 錯誤處理驗證

預期成果： 完成後您將能夠為 API 專案建立完整的整合測試套件，使用真實的 SQL Server 資料庫驗證行為。

需要我使用這些 skills 協助您開始嗎？

---

範例 2：微服務測試

您：我的專案是 .NET Aspire 微服務架構，要怎麼測試？

AI：.NET Aspire 微服務測試需要特殊的方法！我推薦使用 dotnet-testing-advanced-aspire-testing skill。

前置確認：

1. 您已安裝 .NET Aspire Workload？

   • 如果沒有：dotnet workload install aspire

2. 您的專案有哪些服務？

   • API Service
   • Worker Service
   • 其他服務

3. 是否使用資料庫？

   • 如果有，我們會搭配 dotnet-testing-advanced-testcontainers-database

測試重點：

• DistributedApplication 測試
• 服務間通訊驗證
• 依賴服務管理
• 端到端流程測試

需要我使用 dotnet-testing-advanced-aspire-testing skill 協助您建立測試嗎？

---

範例 3：框架升級

您：我的專案使用 xUnit 2.9，應該升級到 3.x 嗎？

AI：這是個好問題！我會協助您評估。讓我先了解您的情況：

1. 升級動機：

• 需要 xUnit 3.x 的新功能
• 解決已知問題
• 只是想跟上最新版本
• 其他原因

2. 專案規模：

• 小型（< 100 個測試）
• 中型（100-500 個測試）
• 大型（> 500 個測試）

3. 升級時程壓力：

• 不急，可以慢慢遷移
• 需要儘快完成

---

您：中型專案，主要是想跟上最新版本，不急

AI：了解！我推薦使用 dotnet-testing-advanced-xunit-upgrade-guide skill。

升級計劃：

階段 1：了解差異（1 天）

• 閱讀重大變更清單
• 了解哪些功能受影響
• 評估遷移工作量

階段 2：準備升級（半天）

• 備份目前程式碼
• 更新 .csproj 套件版本
• 檢查編譯錯誤

階段 3：處理相容性（1-2 天）

• 修正編譯錯誤
• 處理執行階段問題
• 驗證所有測試通過

總工時估計：2-3 天

風險評估：⭐⭐ 中低 xUnit 3.x 升級通常很順利，大部分變更都有向後相容。

需要我使用 dotnet-testing-advanced-xunit-upgrade-guide skill 協助您開始升級嗎？

---

範例 4：TUnit 評估

您：我聽說 TUnit 很不錯，應該遷移嗎？

AI：TUnit 確實是很有潛力的測試框架！讓我協助您評估。

TUnit 主要優勢：

1. ⚡ 更好的效能：平行執行優化
2. 💉 原生依賴注入：不需要額外設定
3. 🎯 現代化 API：更直覺的設計
4. 🔧 靈活性：更多自訂選項

評估重點：

1. 專案狀況：

• 新專案 → 可以考慮直接使用 TUnit
• 現有專案 → 需評估遷移成本

2. 團隊技能：

• 團隊對 xUnit 熟悉度
• 學習新框架的意願

3. 遷移成本：

• 測試數量
• 特殊測試模式（如 Theory、ClassFixture 等）

我的建議：

如果是新專案： 使用 dotnet-testing-advanced-tunit-fundamentals skill 了解 TUnit，考慮直接採用。

如果是現有專案：

1. 先用 dotnet-testing-advanced-tunit-fundamentals 了解基礎
2. 試驗性遷移一個測試檔案
3. 評估實際遷移工作量
4. 決定是否全面遷移

需要我協助您評估嗎？

---

與基礎技能的關係

進階技能建立在基礎技能之上：

基礎測試能力 → dotnet-testing（基礎技能集）

• 單元測試基礎
• 測試資料生成
• 斷言與模擬
• 特殊場景處理

↓ 進階應用

進階整合測試 → dotnet-testing-advanced（本技能集）

• Web API 整合測試
• 容器化測試
• 微服務測試
• 框架升級

學習建議： 先完成 dotnet-testing 基礎技能集的核心技能，再進入本進階技能集。

---

相關資源

原始資料來源

• iThome 鐵人賽系列文章：老派軟體工程師的測試修練 - 30 天挑戰 🏆 2025 iThome 鐵人賽 Software Development 組冠軍

• 完整範例程式碼：30Days_in_Testing_Samples 包含所有範例專案的可執行程式碼

技術需求

整合測試技能：

• .NET 8+
• Docker Desktop
• WSL2（Windows 環境）

Aspire 測試技能：

• .NET 8+
• .NET Aspire Workload
• Docker Desktop

---

下一步

選擇符合您需求的進階技能開始學習，或告訴我您的具體情況，我會推薦最適合的學習路徑！

快速開始：

• 想測試 API → 從 dotnet-testing-advanced-aspnet-integration-testing 開始
• 需要真實資料庫 → 從 dotnet-testing-advanced-testcontainers-database 開始
• 微服務專案 → 使用 dotnet-testing-advanced-aspire-testing
• 框架升級 → 使用對應的升級指南
• 不確定 → 告訴我您的專案情況，我會幫您分析