---

name: dotnet-testing
description: .NET 測試基礎技能總覽與引導中心。當使用者詢問「如何寫 .NET 測試」、「.NET 測試入門」、「需要哪些測試工具」、「測試最佳實踐」、「從零開始學測試」等一般性測試需求時觸發。會根據具體需求推薦適合的子技能組合，涵蓋測試基礎、測試資料、斷言、模擬、特殊場景等 19 個基礎技能。

triggers:
# 入口關鍵字
- dotnet testing
- .NET 測試
- 測試入門
- testing guide
- 如何寫測試
- 測試最佳實踐
- testing overview
- test fundamentals overview

# 測試基礎
- unit test
- 單元測試
- xunit
- test project
- 測試專案
- 3A pattern
- FIRST principles
- FIRST 原則
- test fundamentals
- 測試基礎

# 斷言相關
- assertion
- 斷言
- Should()
- FluentAssertions
- BeEquivalentTo
- 流暢斷言
- assert
- verify

# 模擬與測試替身
- mock
- stub
- spy
- NSubstitute
- Substitute.For
- 模擬
- 測試替身
- mock object
- test double

# 測試資料生成
- test data
- 測試資料
- AutoFixture
- Bogus
- Builder Pattern
- Create<>
- CreateMany
- Faker
- fake data
- 假資料
- test data builder
- 測試資料生成

# 驗證器測試
- validator
- 驗證器
- FluentValidation
- CreateUserValidator
- UpdateValidator
- validation testing
- 驗證測試

# 時間測試
- DateTime
- TimeProvider
- FakeTimeProvider
- 時間測試
- DateTime.Now
- time testing

# 檔案系統測試
- IFileSystem
- MockFileSystem
- 檔案測試
- 檔案系統
- file testing
- filesystem

# 程式碼覆蓋率
- code coverage
- 覆蓋率
- Coverlet
- coverage report

# 測試輸出與日誌
- ITestOutputHelper
- ILogger
- test output
- 測試輸出
- logging

# 私有成員測試
- Private method
- Internal class
- InternalsVisibleTo
- 私有方法
- 內部類別

# 測試命名
- test naming
- 測試命名
- naming convention
- 命名規範

license: MIT
metadata:
author: Kevin Tseng
version: "1.0.0"
tags: ".NET, testing, xUnit, overview, guide, fundamentals"
related_skills: "dotnet-testing-advanced"
skill_count: 19
skill_type: "overview"

---

.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. [ ] 完全沒寫過測試
3. [ ] 寫過一些基礎測試

4. [ ] 有一定經驗，想深入學習

5. 您的專案情況：

6. [ ] 新專案，從零開始
7. [ ] 現有專案，想加入測試
8. [ ] 改善現有測試品質

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

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

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 測試物件

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