.NET 測試基礎技能總覽

🤖 AI Agent 重要提示

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

📋 本技能的定位

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

您的任務是

1. ✅ 根據使用者需求匹配對應的子技能
2. ✅ 使用

   Skill

   tool 載入具體的子技能
3. ✅ 讓子技能提供專業的測試指引

禁止行為

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

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

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

最常用技能（必須熟記）

/skill dotnet-testing-fluentvalidation-testing

/skill dotnet-testing-nsubstitute-mocking

/skill dotnet-testing-autofixture-basics

/skill dotnet-testing-awesome-assertions-guide

/skill dotnet-testing-datetime-testing-timeprovider

/skill dotnet-testing-filesystem-testing-abstractions

/skill dotnet-testing-bogus-fake-data

/skill dotnet-testing-test-data-builder-pattern

/skill dotnet-testing-complex-object-comparison

基礎入門技能

/skill dotnet-testing-unit-test-fundamentals

/skill dotnet-testing-test-naming-conventions

/skill dotnet-testing-xunit-project-setup

進階技能組合

/skill dotnet-testing-autofixture-bogus-integration

/skill dotnet-testing-autofixture-nsubstitute-integration

/skill dotnet-testing-autodata-xunit-integration

/skill dotnet-testing-test-output-logging

/skill dotnet-testing-code-coverage-analysis

⚠️ 使用流程範例

✅ 正確流程

使用者：請幫我建立 CreateUserValidator 的測試

AI：我注意到您需要測試 Validator。根據快速對照表，
    我應該載入 dotnet-testing-fluentvalidation-testing skill。

    [使用 Skill tool 載入子技能]

AI：現在按照 FluentValidation Testing skill 的指引為您建立測試...

❌ 錯誤流程

使用者：請幫我建立 CreateUserValidator 的測試

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

📚 完整技能清單

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

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

適用情境

當您遇到以下情況時，我會協助您找到正確的技能：

• 剛開始學習 .NET 測試，不知從何下手
• 想為現有專案建立測試，需要完整指引
• 需要改善測試品質，尋找最佳實踐
• 遇到特定測試場景，不確定該用哪個工具
• 想了解測試資料生成、斷言、模擬等技術
• 希望提升測試可讀性與維護性
• 需要處理時間、檔案系統等特殊測試場景

快速決策樹

我應該從哪裡開始？

情境 1：完全新手，從未寫過測試

推薦學習路徑：

1. dotnet-testing-unit-test-fundamentals

   - 理解 FIRST 原則與 3A Pattern

2. dotnet-testing-test-naming-conventions

   - 學習命名規範

3. dotnet-testing-xunit-project-setup

   - 建立第一個測試專案

為什麼這樣學：

• FIRST 原則是所有測試的基礎，先建立正確的觀念
• 命名規範讓測試易讀易維護
• 實際動手建立專案，將理論轉化為實踐

情境 2：會寫基礎測試，但測試資料準備很麻煩

推薦技能（擇一或組合）：

選項 A - 自動化優先 →

dotnet-testing-autofixture-basics

選項 B - 擬真資料優先 →

dotnet-testing-bogus-fake-data

選項 C - 語意清晰優先 →

dotnet-testing-test-data-builder-pattern

選項 D - 兩者兼具 →

dotnet-testing-autofixture-basics

dotnet-testing-autofixture-bogus-integration

情境 3：有外部依賴（資料庫、API、第三方服務）需要模擬

推薦技能組合：

1. dotnet-testing-nsubstitute-mocking

   - NSubstitute Mock 框架基礎

2. dotnet-testing-autofixture-nsubstitute-integration

   - （可選）整合 AutoFixture 與 NSubstitute

何時需要第二個技能：

• 如果您已經在使用 AutoFixture 產生測試資料
• 想要自動建立 Mock 物件，減少手動設定

情境 4：測試中有特殊場景

時間相關測試 →

dotnet-testing-datetime-testing-timeprovider

檔案系統測試 →

dotnet-testing-filesystem-testing-abstractions

私有/內部成員測試 →

dotnet-testing-private-internal-testing

情境 5：需要更好的斷言方式

基礎需求 - 流暢斷言 →

dotnet-testing-awesome-assertions-guide

進階需求 - 複雜物件比較 →

dotnet-testing-complex-object-comparison

驗證規則測試 →

dotnet-testing-fluentvalidation-testing

情境 6：想了解測試覆蓋率

→

dotnet-testing-code-coverage-analysis

技能分類地圖

1. 測試基礎（3 個技能）- 必學基礎

dotnet-testing-unit-test-fundamentals

dotnet-testing-test-naming-conventions

dotnet-testing-xunit-project-setup

學習順序建議：fundamentals → naming-conventions → xunit-project-setup

核心收穫：

• FIRST 原則：Fast、Independent、Repeatable、Self-Validating、Timely
• 3A Pattern：Arrange-Act-Assert 結構化測試
• 命名規範：

  [被測方法]_[測試情境]_[預期行為]

• 專案結構：tests/ 目錄、.csproj 設定、NuGet 套件管理

2. 測試資料生成（5 個技能）- 提升效率

dotnet-testing-autofixture-basics

dotnet-testing-autofixture-customization

dotnet-testing-bogus-fake-data

dotnet-testing-test-data-builder-pattern

dotnet-testing-autofixture-bogus-integration

選擇指南：

需要大量資料 + 不在乎真實感？
  → autofixture-basics

需要看起來真實的資料？
  → bogus-fake-data

需要高度可讀性和語意清晰？
  → test-data-builder-pattern

需要靈活控制生成規則？
  → autofixture-basics + autofixture-customization

需要自動化 + 擬真？
  → autofixture-basics + autofixture-bogus-integration

學習路徑：

• 入門：autofixture-basics 或 bogus-fake-data
• 進階：autofixture-customization + test-data-builder-pattern
• 整合：autofixture-bogus-integration

3. 測試替身（2 個技能）- 處理依賴

dotnet-testing-nsubstitute-mocking

dotnet-testing-autofixture-nsubstitute-integration

核心概念：

• Mock：模擬物件並驗證互動
• Stub：提供預設回應
• Spy：記錄呼叫並驗證

學習順序建議：

1. 先學 nsubstitute-mocking（理解 Mock 基礎）
2. 如果已使用 AutoFixture，再學 integration（提升效率）

常見用途：

• 模擬資料庫存取層（Repository）
• 模擬外部 API 呼叫
• 模擬第三方服務
• 驗證方法是否被正確呼叫

4. 斷言驗證（3 個技能）- 寫出清晰測試

dotnet-testing-awesome-assertions-guide

dotnet-testing-complex-object-comparison

dotnet-testing-fluentvalidation-testing

FluentAssertions 範例對比：

// 傳統斷言
Assert.Equal(expected.Name, actual.Name);
Assert.Equal(expected.Age, actual.Age);
Assert.True(actual.IsActive);

// FluentAssertions（更易讀）
actual.Should().BeEquivalentTo(expected, options => options
    .Including(x => x.Name)
    .Including(x => x.Age));
actual.IsActive.Should().BeTrue();

學習路徑：

1. awesome-assertions-guide（所有專案必學）
2. complex-object-comparison（處理複雜比對）
3. fluentvalidation-testing（特定需求）

5. 特殊場景（3 個技能）- 解決棘手問題

dotnet-testing-datetime-testing-timeprovider

dotnet-testing-filesystem-testing-abstractions

dotnet-testing-private-internal-testing

時間測試常見問題：

// 問題：難以測試
public bool IsExpired()
{
    return DateTime.Now > ExpiryDate;  // DateTime.Now 無法控制
}

// 解決：使用 TimeProvider
public bool IsExpired(TimeProvider timeProvider)
{
    return timeProvider.GetUtcNow() > ExpiryDate;  // 可在測試中注入假時間
}

檔案系統測試常見問題：

// 問題：難以測試
public void SaveToFile(string content)
{
    File.WriteAllText("data.txt", content);  // 真實檔案操作
}

// 解決：使用 IFileSystem 抽象
public void SaveToFile(string content, IFileSystem fileSystem)
{
    fileSystem.File.WriteAllText("data.txt", content);  // 可在測試中使用記憶體檔案系統
}

何時需要這些技能：

• TimeProvider：排程系統、有效期檢查、時間計算
• FileSystem：檔案上傳、報表產生、設定檔讀寫
• Private Testing：重構遺留程式碼（但應優先考慮重構設計）

6. 測試度量（1 個技能）- 品質監控

dotnet-testing-code-coverage-analysis

涵蓋內容：

• 使用 Coverlet 收集覆蓋率資料
• 產生 HTML 報告
• 設定覆蓋率門檻
• CI/CD 整合

重要提醒：

• 高覆蓋率 ≠ 高品質測試
• 目標是有意義的測試，而非追求 100% 覆蓋率
• 覆蓋率是參考指標，不是絕對標準

7. 框架整合（2 個技能）- 進階整合

dotnet-testing-autodata-xunit-integration

dotnet-testing-test-output-logging

AutoData 範例：

// 傳統寫法
[Theory]
[InlineData("user1", "pass1")]
[InlineData("user2", "pass2")]
public void Login_ValidCredentials_Success(string username, string password)
{
    // ...
}

// 使用 AutoData
[Theory, AutoData]
public void Login_ValidCredentials_Success(string username, string password)
{
    // username 和 password 自動產生
}

Test Output 範例：

public class MyTests
{
    private readonly ITestOutputHelper _output;

    public MyTests(ITestOutputHelper output)
    {
        _output = output;
    }

    [Fact]
    public void Test()
    {
        _output.WriteLine("Debug information");  // 在測試輸出中顯示
    }
}

常見任務映射表

任務 1：從零建立測試專案

情境：全新專案，需要建立完整的測試基礎設施

推薦技能組合：

1. dotnet-testing-xunit-project-setup

   - 建立專案結構

2. dotnet-testing-test-naming-conventions

   - 設定命名規範

3. dotnet-testing-unit-test-fundamentals

   - 撰寫第一個測試

實施步驟：

1. 使用 xunit-project-setup 建立測試專案
2. 配置 .csproj 檔案與 NuGet 套件
3. 學習命名規範，制定團隊標準
4. 按照 3A Pattern 撰寫第一個測試

提示詞範例：

請使用 dotnet-testing-xunit-project-setup skill 為我的專案建立測試結構，
專案名稱是 MyProject，然後使用 dotnet-testing-unit-test-fundamentals skill
為 Calculator 類別建立第一個測試。

任務 2：為有依賴的服務類別寫測試

情境：UserService 依賴 IUserRepository 和 IEmailService

推薦技能組合：

1. dotnet-testing-unit-test-fundamentals

   - 測試結構

2. dotnet-testing-nsubstitute-mocking

   - 模擬依賴

3. dotnet-testing-autofixture-basics

   - 產生測試資料

4. dotnet-testing-awesome-assertions-guide

   - 清晰斷言

實施步驟：

1. 使用 NSubstitute 建立 Repository 和 EmailService 的 Mock
2. 用 AutoFixture 產生 User 測試資料
3. 按照 3A Pattern 撰寫測試
4. 使用 FluentAssertions 驗證結果

提示詞範例：

請使用 dotnet-testing-nsubstitute-mocking 和 dotnet-testing-autofixture-basics skills
為 UserService 建立測試。UserService 的建構函式需要 IUserRepository 和 IEmailService。
請測試 CreateUser 方法。

預期程式碼結構：

[Fact]
public void CreateUser_ValidUser_ShouldSaveAndSendEmail()
{
    // Arrange - 使用 NSubstitute 建立 Mock
    var repository = Substitute.For<IUserRepository>();
    var emailService = Substitute.For<IEmailService>();

    // 使用 AutoFixture 產生測試資料
    var fixture = new Fixture();
    var user = fixture.Create<User>();

    var sut = new UserService(repository, emailService);

    // Act
    sut.CreateUser(user);

    // Assert - 使用 FluentAssertions
    repository.Received(1).Save(Arg.Is<User>(u => u.Email == user.Email));
    emailService.Received(1).SendWelcomeEmail(user.Email);
}

任務 3：測試有時間邏輯的程式碼

情境：OrderService 判斷訂單是否過期

推薦技能組合：

1. dotnet-testing-datetime-testing-timeprovider

   - TimeProvider 抽象化

2. dotnet-testing-unit-test-fundamentals

   - 測試基礎

3. dotnet-testing-nsubstitute-mocking

   - Mock TimeProvider

實施步驟：

1. 重構程式碼，注入 TimeProvider
2. 在測試中使用 FakeTimeProvider
3. 控制時間進行測試

提示詞範例：

請使用 dotnet-testing-datetime-testing-timeprovider skill 協助重構 OrderService，
使其可測試時間相關邏輯。訂單在建立 30 天後視為過期。

預期程式碼結構：

// 重構前
public class OrderService
{
    public bool IsExpired(Order order)
    {
        return DateTime.Now > order.CreatedDate.AddDays(30);  // 無法測試
    }
}

// 重構後
public class OrderService
{
    private readonly TimeProvider _timeProvider;

    public OrderService(TimeProvider timeProvider)
    {
        _timeProvider = timeProvider;
    }

    public bool IsExpired(Order order)
    {
        return _timeProvider.GetUtcNow() > order.CreatedDate.AddDays(30);
    }
}

// 測試
[Fact]
public void IsExpired_Order31DaysOld_ShouldReturnTrue()
{
    // Arrange
    var fakeTime = new FakeTimeProvider();
    fakeTime.SetUtcNow(new DateTimeOffset(2024, 1, 31, 0, 0, 0, TimeSpan.Zero));

    var order = new Order
    {
        CreatedDate = new DateTimeOffset(2024, 1, 1, 0, 0, 0, TimeSpan.Zero)
    };

    var sut = new OrderService(fakeTime);

    // Act
    var result = sut.IsExpired(order);

    // Assert
    result.Should().BeTrue();
}

任務 4：改善測試可讀性

情境：現有測試難以理解，維護困難

推薦技能組合：

1. dotnet-testing-test-naming-conventions

   - 命名規範

2. dotnet-testing-awesome-assertions-guide

   - 流暢斷言

3. dotnet-testing-test-data-builder-pattern

   - 清晰的測試資料

實施步驟：

1. 重新命名測試方法，遵循三段式命名
2. 使用 FluentAssertions 改寫斷言
3. 使用 Builder Pattern 建立測試資料

提示詞範例：

請使用 dotnet-testing-awesome-assertions-guide 和 dotnet-testing-test-naming-conventions skills
檢視並改善這些測試的可讀性：
[貼上測試程式碼]

任務 5：產生大量測試資料

情境：效能測試需要 1000 筆 Customer 資料

推薦技能組合：

1. dotnet-testing-autofixture-basics

   - 自動產生

2. dotnet-testing-bogus-fake-data

   - 擬真資料（可選）

3. dotnet-testing-autofixture-bogus-integration

   - 結合兩者優勢（可選）

實施步驟：

1. 使用 AutoFixture.CreateMany<T>() 產生大量資料
2. （可選）使用 Bogus 讓資料更真實
3. （可選）整合兩者，自動化 + 擬真

提示詞範例：

請使用 dotnet-testing-autofixture-basics skill 為效能測試產生 1000 筆 Customer 資料，
每筆資料需要有 Name、Email、PhoneNumber 等欄位。

任務 6：測試 FluentValidation 驗證器

情境：CreateUserValidator 有多條驗證規則

推薦技能：

• dotnet-testing-fluentvalidation-testing

實施步驟：

1. 使用 FluentValidation.TestHelper
2. 測試每條驗證規則
3. 測試組合情境

提示詞範例：

請使用 dotnet-testing-fluentvalidation-testing skill 為 CreateUserValidator 建立測試。
驗證器的規則包括：Name 必填、Email 格式驗證、Age 必須大於 18。

任務 7：測試檔案上傳功能

情境：FileUploadService 需要儲存上傳的檔案

推薦技能：

• dotnet-testing-filesystem-testing-abstractions

實施步驟：

1. 重構程式碼，使用 IFileSystem
2. 在測試中使用 MockFileSystem
3. 驗證檔案操作

提示詞範例：

請使用 dotnet-testing-filesystem-testing-abstractions skill 協助測試 FileUploadService。
該服務會將上傳的檔案儲存到 uploads/ 目錄。

學習路徑建議

新手路徑（1-2 週）

目標：建立測試基礎，能夠撰寫基本的單元測試

階段 1：建立基礎（Day 1-5）

Day 1-2：測試基礎概念

• 技能：

  dotnet-testing-unit-test-fundamentals

• 學習重點：
  • FIRST 原則
  • 3A Pattern
  • [Fact] 與 [Theory] 的使用
  • 基本斷言方法
• 實作練習：為簡單的 Calculator 類別寫測試

Day 3：命名規範

• 技能：

  dotnet-testing-test-naming-conventions

• 學習重點：
  • 三段式命名法
  • 中文命名建議
  • 測試類別命名
• 實作練習：重新命名 Day 1-2 的測試

Day 4-5：建立測試專案

• 技能：

  dotnet-testing-xunit-project-setup

• 學習重點：
  • 專案結構規劃
  • .csproj 設定
  • NuGet 套件管理
  • xunit.runner.json 設定
• 實作練習：為現有專案建立測試專案

階段 2：提升品質（Day 6-10）

Day 6-7：流暢斷言

• 技能：

  dotnet-testing-awesome-assertions-guide

• 學習重點：
  • FluentAssertions 基礎
  • 集合斷言
  • 例外斷言
  • 物件比對
• 實作練習：改寫之前的測試，使用 FluentAssertions

Day 8：測試輸出

• 技能：

  dotnet-testing-test-output-logging

• 學習重點：
  • ITestOutputHelper 使用
  • 整合 ILogger
  • 除錯技巧
• 實作練習：為複雜測試加入輸出

Day 9-10：處理依賴

• 技能：

  dotnet-testing-nsubstitute-mocking

• 學習重點：
  • Mock vs Stub vs Spy
  • 基本模擬設定
  • 驗證呼叫
  • Returns 和 Throws
• 實作練習：測試有 Repository 依賴的 Service

階段 3：自動化測試資料（Day 11-14）

Day 11-12：AutoFixture 基礎

• 技能：

  dotnet-testing-autofixture-basics

• 學習重點：
  • 匿名測試資料
  • Create 和 CreateMany
  • 減少測試樣板程式碼
• 實作練習：使用 AutoFixture 簡化測試

Day 13-14：整合應用

• 技能：

  • dotnet-testing-autodata-xunit-integration

  • dotnet-testing-autofixture-nsubstitute-integration

• 學習重點：
  • AutoData 屬性
  • 自動建立 Mock
  • 組合使用
• 實作練習：綜合應用 AutoFixture + NSubstitute

階段 4：總結與實戰（Day 15）

• 為一個小型專案建立完整測試
• 應用所學的所有技能
• 設定 Code Coverage

進階路徑（2-3 週）

前置條件：完成新手路徑

第一週：測試資料專精

Day 1-2：AutoFixture 進階

• 技能：

  dotnet-testing-autofixture-customization

• 學習重點：
  • Customizations
  • Specimens
  • Behaviors
  • 自訂生成規則

Day 3-4：擬真資料

• 技能：

  dotnet-testing-bogus-fake-data

• 學習重點：
  • Faker 使用
  • 真實感資料生成
  • 本地化資料

Day 5：Builder Pattern

• 技能：

  dotnet-testing-test-data-builder-pattern

• 學習重點：
  • 建立 Test Data Builder
  • Fluent Interface
  • 預設值設定

Day 6-7：整合應用

• 技能：

  dotnet-testing-autofixture-bogus-integration

• 學習重點：
  • 整合 AutoFixture 與 Bogus
  • 選擇合適的工具

第二週：特殊場景處理

Day 1-2：時間測試

• 技能：

  dotnet-testing-datetime-testing-timeprovider

• 學習重點：
  • TimeProvider 抽象化
  • FakeTimeProvider 使用
  • 時區處理

Day 3-4：檔案系統測試

• 技能：

  dotnet-testing-filesystem-testing-abstractions

• 學習重點：
  • IFileSystem 介面
  • MockFileSystem 使用
  • 檔案操作測試

Day 5-6：複雜物件比對

• 技能：

  dotnet-testing-complex-object-comparison

• 學習重點：
  • 深層物件比對
  • 排除特定屬性
  • 自訂比對規則

Day 7：私有成員測試

• 技能：

  dotnet-testing-private-internal-testing

• 學習重點：
  • InternalsVisibleTo
  • 測試策略
  • 何時應避免

第三週：品質與整合

Day 1-2：驗證測試

• 技能：

  dotnet-testing-fluentvalidation-testing

• 學習重點：
  • TestHelper 使用
  • 驗證規則測試
  • 錯誤訊息驗證

Day 3-4：程式碼覆蓋率

• 技能：

  dotnet-testing-code-coverage-analysis

• 學習重點：
  • Coverlet 使用
  • 報告產生
  • CI/CD 整合

Day 5-7：綜合實戰

• 為中型專案建立完整測試
• 應用所有學到的技能
• 建立測試最佳實踐文件

快速參考：我該先學什麼？

我是新手，完全沒寫過測試 → 新手路徑階段 1：unit-test-fundamentals → test-naming-conventions → xunit-project-setup

我會寫基礎測試，想提升品質 → 新手路徑階段 2：awesome-assertions-guide → nsubstitute-mocking

我想提升測試效率 → 進階路徑第一週：測試資料生成系列

我遇到特殊場景（時間、檔案系統） → 進階路徑第二週：特殊場景處理系列

我想評估測試品質 → code-coverage-analysis

引導對話範例

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

範例 1：新手入門

您：我想學習 .NET 測試

AI：我很樂意協助您學習 .NET 測試！為了提供最適合的指引，請告訴我：

1. 您的測試經驗：

   • 完全沒寫過測試
   • 寫過一些基礎測試
   • 有一定經驗，想深入學習

2. 您的專案情況：

   • 新專案，從零開始
   • 現有專案，想加入測試
   • 改善現有測試品質

請告訴我您的情況，我會推薦適合的學習路徑。

您：完全沒寫過測試，是新專案

AI：太好了！我會為您規劃一個循序漸進的學習路徑。建議您從以下三個技能開始：

第一步：理解測試基礎（1-2 天） 使用

dotnet-testing-unit-test-fundamentals

第二步：學習命名規範（半天） 使用

dotnet-testing-test-naming-conventions

第三步：建立測試專案（1 天） 使用

dotnet-testing-xunit-project-setup

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

範例 2：處理依賴

您：我需要為 UserService 寫測試，但它依賴資料庫和外部 API

AI：了解！您的情況需要模擬（Mock）外部依賴。我推薦以下技能組合：

必要技能：

1. dotnet-testing-nsubstitute-mocking

   - 模擬資料庫與 API 依賴 用途：建立 IUserRepository 和 IApiClient 的 Mock 物件

建議搭配： 2.

dotnet-testing-autofixture-basics

3. dotnet-testing-awesome-assertions-guide

   - 清晰的斷言 用途：讓測試更易讀

實施建議：

1. 先使用 NSubstitute 為依賴建立 Mock
2. 用 AutoFixture 產生 User 測試資料
3. 按照 3A Pattern 撰寫測試
4. 使用 FluentAssertions 驗證結果

需要我使用這些 skills 協助您建立測試嗎？

範例 3：特定問題

您：我的程式碼用 DateTime.Now，要怎麼測試？

AI：這是時間相關測試的經典問題！我推薦使用

dotnet-testing-datetime-testing-timeprovider

問題分析：

DateTime.Now

解決方案：

1. 重構程式碼，注入

   TimeProvider

2. 在測試中使用

   FakeTimeProvider

   控制時間
3. 這樣就能測試特定時間點的行為

範例：

// 重構前（難以測試）
public bool IsExpired()
{
    return DateTime.Now > ExpiryDate;
}

// 重構後（可測試）
public bool IsExpired(TimeProvider timeProvider)
{
    return timeProvider.GetUtcNow() > ExpiryDate;
}

需要我使用

dotnet-testing-datetime-testing-timeprovider

範例 4：改善現有測試

您：我的測試很難讀，維護困難

AI：測試可讀性問題很常見！我建議從以下三個方向改善：

1. 命名規範 使用

dotnet-testing-test-naming-conventions

• 採用三段式命名：

  [方法]_[情境]_[預期]

• 讓測試名稱自我說明

2. 流暢斷言 使用

dotnet-testing-awesome-assertions-guide

• 使用 FluentAssertions 取代傳統斷言
• 大幅提升可讀性

3. 清晰的測試資料 使用

dotnet-testing-test-data-builder-pattern

• 使用 Builder Pattern 建立測試資料
• 讓測試意圖更明確

快速範例：

// 改善前
[Fact]
public void Test1()
{
    var u = new User { Name = "test", Age = 20 };
    var r = svc.Validate(u);
    Assert.True(r);
}

// 改善後
[Fact]
public void Validate_AdultUser_ShouldReturnTrue()
{
    // Arrange
    var user = new UserBuilder()
        .WithName("test")
        .WithAge(20)
        .Build();

    // Act
    var result = _service.Validate(user);

    // Assert
    result.Should().BeTrue();
}

要不要我協助您改善特定的測試？請貼上您的測試程式碼。

與進階技能的關係

完成基礎技能後，如果您需要進行整合測試、API 測試、容器化測試或微服務測試，請參考：

進階整合測試 →

dotnet-testing-advanced

• ASP.NET Core 整合測試
• 容器化測試（Testcontainers）
• 微服務測試（.NET Aspire）
• 測試框架升級與遷移

相關資源

原始資料來源

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

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

學習文檔

本技能集基於以下完整教材提煉而成：

• Agent Skills：從架構設計到實戰應用 (docs/Agent_Skills_Mastery.pdf) 完整涵蓋 Agent Skills 從理論到實踐

• Claude Code Skills: 讓 AI 變身專業工匠 (docs/Agent_Skills_Architecture.pdf) 深入解析 Agent Skills 的架構設計

• .NET Testing：寫得更好、跑得更快 (docs/NET_Testing_Write_Better_Run_Faster.pdf) 測試執行優化與除錯技巧

下一步

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

快速開始：

• 新手 → 從

  dotnet-testing-unit-test-fundamentals

  開始
• 有經驗 → 告訴我您遇到的具體問題
• 不確定 → 告訴我您的專案情況，我會幫您分析