.NET 測試基礎技能總覽

---

🤖 AI Agent 重要提示

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

📋 本技能的定位

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

您的任務是

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

禁止行為

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

---

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

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

最常用技能（必須熟記）

ä½¿ç”¨è€ èªª…	è¼‰å ¥æŒ‡ä»¤	用途說明
Validator、驗證器、CreateUserValidator	/skill dotnet-testing-fluentvalidation-testing	FluentValidation 測試
Mock、模擬、IRepository、IService	/skill dotnet-testing-nsubstitute-mocking	模擬外部依賴
AutoFixture、測試資料生成	/skill dotnet-testing-autofixture-basics	自動產生測試資料
斷言、Should()、BeEquivalentTo	/skill dotnet-testing-awesome-assertions-guide	æµæš¢æ–·è¨€ï¼ˆå¿ å­¸ï¼‰
DateTime、時間測試、TimeProvider	/skill dotnet-testing-datetime-testing-timeprovider	時間相關測試
File、檔案系統、IFileSystem	/skill dotnet-testing-filesystem-testing-abstractions	檔案系統測試
Bogus、假資料、Faker	/skill dotnet-testing-bogus-fake-data	擬真資料生成
Builder Pattern、WithXxx	/skill dotnet-testing-test-data-builder-pattern	Test Data Builder
深層比對、DTO 比對、Excluding	/skill dotnet-testing-complex-object-comparison	複雜物件比對

基礎入門技能

ä½¿ç”¨è€ èªª…	è¼‰å ¥æŒ‡ä»¤	用途說明
從零開始、測試基礎、FIRST 原則	/skill dotnet-testing-unit-test-fundamentals	å–®å ƒæ¸¬è©¦åŸºç¤Ž
測試命名、如何命名測試	/skill dotnet-testing-test-naming-conventions	命名規範
建立測試專案、xUnit 設定	/skill dotnet-testing-xunit-project-setup	專案建置

進階技能組合

ä½¿ç”¨è€ èªª…	è¼‰å ¥æŒ‡ä»¤	用途說明
AutoFixture + Bogus	/skill dotnet-testing-autofixture-bogus-integration	自動化+擬真資料
AutoFixture + NSubstitute	/skill dotnet-testing-autofixture-nsubstitute-integration	自動建立 Mock
AutoData、Theory 測試	/skill dotnet-testing-autodata-xunit-integration	參數化測試
測試輸出、ITestOutputHelper	/skill dotnet-testing-test-output-logging	測試日誌
覆蓋率、Coverlet	/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 適合：需要真實感的測試資料（姓名、地址、Email 等）

選項 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 處理：DateTime.Now、時區轉換、時間計算

檔案系統測試 → dotnet-testing-filesystem-testing-abstractions 處理：檔案讀寫、目錄操作、路徑處理

私有/內部成員測試 → dotnet-testing-private-internal-testing 處理：需要測試 private、internal 成員（但應謹慎使用）

---

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

基礎需求 – 流暢斷言 → dotnet-testing-awesome-assertions-guide 所有專案都應該使用，提升測試可讀性

進階需求 – 複雜物件比較 → dotnet-testing-complex-object-comparison 處理：深層物件比較、DTO 驗證、Entity 比對

驗證規則測試 → dotnet-testing-fluentvalidation-testing 處理：測試 FluentValidation 驗證器

---

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

→ dotnet-testing-code-coverage-analysis 學習：使用 Coverlet 分析程式碼覆蓋率、產生報告

技能分類地圖

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

技能名稱	核心價值	適合新手	何時使用
dotnet-testing-unit-test-fundamentals	理解 FIRST 原則、3A Pattern、測試金字塔等基礎概念	⭐⭐⭐	所有測試的起點，建立正確的測試觀念
dotnet-testing-test-naming-conventions	學習三段式命名法、中文命名建議	⭐⭐⭐	提升測試可讀性與可維護性
dotnet-testing-xunit-project-setup	建立標準的 xUnit 測試專案結構	⭐⭐⭐	建立新測試專案時

學習順序建議：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	客製化 AutoFixture 行為	控制資料生成規則、符合業務邏輯	需要特定規則的測試資料
dotnet-testing-bogus-fake-data	產生擬真假資料（姓名、地址、Email 等）	資料看起來真實、易於除錯	需要真實感的測試資料、展示用途
dotnet-testing-test-data-builder-pattern	使用 Builder Pattern 建立測試資料	èªžæ„æ¸ æ™°ã€è¡¨é”æ¸¬è©¦æ„åœ–	需要高可讀性、複雜物件建構
dotnet-testing-autofixture-bogus-integration	結合 AutoFixture 與 Bogus	å ©è€ å„ªå‹¢äº’è£œ	同時需要自動化和擬真資料

選擇指南：

需要大量資料 + 不在乎真實感？
  → 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	NSubstitute Mock 框架	Mock、Stub、Spy、驗證呼叫	有外部依賴需要模擬
dotnet-testing-autofixture-nsubstitute-integration	AutoFixture + NSubstitute 整合	自動建立 Mock 物件	使用 AutoFixture 且有大量依賴

核心概念：

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

學習順序建議：

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

常見用途：

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

---

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

技能名稱	特色	æå‡å¹ åº¦	何時使用
dotnet-testing-awesome-assertions-guide	FluentAssertions 流暢斷言	⭐⭐⭐ 高	所有測試（強烈推薦）
dotnet-testing-complex-object-comparison	深層物件比對技巧	⭐⭐⭐ 高	DTO、Entity、複雜物件驗證
dotnet-testing-fluentvalidation-testing	測試 FluentValidation 驗證器	⭐⭐ 中	使用 FluentValidation 的專案

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	時間相關測試（使用 .NET 8+ 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、ReportGenerator	評估測試完整性、CI/CD 整合

涵蓋內容：

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

重要提醒：

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

---

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

技能名稱	整合對象	價值	何時使用
dotnet-testing-autodata-xunit-integration	AutoFixture + xUnit Theory	簡化參數化測試	使用 xUnit Theory 且需要測試資料
dotnet-testing-test-output-logging	ITestOutputHelper + ILogger	測試輸出與除錯	需要查看測試執行過程、除錯複雜測試

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() 產生大量資料
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 skill 學習重點：FIRST 原則、3A Pattern、基本測試結構

第二步：學習命名規範（半天） 使用 dotnet-testing-test-naming-conventions skill 學習重點：三段式命名法、提升可讀性

第三步：建立測試專案（1 天） 使用 dotnet-testing-xunit-project-setup skill 學習重點：專案結構、套件設定

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

---

範例 2：處理依賴

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

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

必要技能：

1. dotnet-testing-nsubstitute-mocking – 模擬資料庫與 API 依賴 用途：建立 IUserRepository 和 IApiClient 的 Mock 物件

建議搭配： 2. dotnet-testing-autofixture-basics – 自動產生測試資料 用途：快速產生 User 測試物件

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 skill。

問題分析： DateTime.Now 每次執行都不同，無法寫出可重複的測試（違反 FIRST 原則中的 Repeatable）。

解決方案：

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 skill 協助您重構並建立測試嗎？

---

範例 4：改善現有測試

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

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

1. 命名規範 使用 dotnet-testing-test-naming-conventions skill

• 採用三段式命名：[方法]_[情境]_[預期]
• 讓測試名稱自我說明

2. 流暢斷言 使用 dotnet-testing-awesome-assertions-guide skill

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

3. 清晰的測試資料 使用 dotnet-testing-test-data-builder-pattern skill

• 使用 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 開始
• 有經驗 → 告訴我您遇到的具體問題
• 不確定 → 告訴我您的專案情況，我會幫您分析