https://github.com/kevintsengtw/dotnet-testing-agent-orchestration-claude

.NET Testing Agent Orchestration for Claude Code
https://github.com/kevintsengtw/dotnet-testing-agent-orchestration-claude

Last synced: 4 days ago
JSON representation

.NET Testing Agent Orchestration for Claude Code

• Host: GitHub
• URL: https://github.com/kevintsengtw/dotnet-testing-agent-orchestration-claude
• Owner: kevintsengtw
• Created: 2026-04-27T10:07:44.000Z (about 2 months ago)
• Default Branch: master
• Last Pushed: 2026-06-09T06:22:01.000Z (6 days ago)
• Last Synced: 2026-06-09T08:22:25.551Z (6 days ago)
• Language: JavaScript
• Size: 307 KB
• Stars: 0
• Watchers: 0
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md

Awesome Lists containing this project

README

          
# dotnet-testing Agent Orchestration for Claude Code

這個 repo 提供完整的 **Claude Code Subagents** .NET 測試工作流程範例，展示如何透過 Agent Orchestration 自動化完成四種測試類型：**Unit Testing**、**Integration Testing**、**Aspire Testing**、**TUnit Testing**。

核心架構採用 **1+4 模型**：1 個 Orchestrator Skill 負責指揮 4 個專用 Subagent，依序完成 Analyzer → Writer → Executor → Reviewer 的完整測試流程——從分析目標程式碼、撰寫測試、執行驗證，到審查品質，全程自動化。

本 repo 的目標讀者是使用 Claude Code 開發 .NET 專案的開發人員，提供可直接套用於實際專案的工作流程範例與練習素材。

- [dotnet-testing Agent Orchestration for Claude Code](#dotnet-testing-agent-orchestration-for-claude-code)

  - [架構概覽](#架構概覽)

  - [系統需求](#系統需求)

  - [安裝與環境設定](#安裝與環境設定)

    - [一鍵安裝（推薦）](#一鍵安裝推薦)

    - [步驟 1：Clone 儲存庫](#步驟-1clone-儲存庫)

    - [步驟 2：安裝 Agent Skills](#步驟-2安裝-agent-skills)

    - [步驟 3：確認完整 .claude/ 目錄結構](#步驟-3確認完整-claude-目錄結構)

    - [步驟 4：安裝計時 Hook（可選）](#步驟-4安裝計時-hook可選)

    - [步驟 5：驗證安裝](#步驟-5驗證安裝)

  - [快速開始](#快速開始)

  - [四種測試工作流程](#四種測試工作流程)

  - [練習專案](#練習專案)

  - [文件](#文件)

---

## 架構概覽

Orchestrator Skill 接收使用者指令後，依序呼叫四個 Subagent：

```text

Orchestrator Skill

    ├── Analyzer Subagent  （分析目標類別、依賴項、測試技術）

    ├── Writer Subagent    （載入 Skills，產生測試程式碼）

    ├── Executor Subagent  （建置並執行測試，處理修正迴圈）

    └── Reviewer Subagent  （審查命名、斷言、覆蓋率、框架合規性）

```

每個階段必須依序完成，Reviewer 提出改善建議後，Orchestrator 會再次呼叫 Writer + Executor 進行修正。

> 詳細架構圖與各 Orchestrator 流程說明，請參閱 [docs/architecture/overview.md](docs/architecture/overview.md)

---

## 系統需求

**必要：**

| 工具                | 版本              | 說明                  |

| ------------------- | ----------------- | --------------------- |

| Claude Code CLI     | 最新版            | 必要                  |

| .NET SDK            | 8.0 / 9.0 / 10.0 | 三個版本的練習專案     |

| Node.js             | 最新版            | 用於安裝 Agent Skills |

**整合測試 / Aspire 測試額外需要：**

| 工具                    | 版本   | 說明                         |

| ----------------------- | ------ | ---------------------------- |

| Docker Desktop          | 最新版 | Testcontainers 容器執行環境  |

| .NET Aspire workload    | 最新版 | Aspire 測試專用              |

安裝 .NET Aspire workload：

```bash

dotnet workload install aspire

```

---

## 安裝與環境設定

### 一鍵安裝（推薦）

Clone 本 repo 後，從 repo 根目錄執行安裝指令碼，有兩種呼叫方式：

#### 方式 A：指定目標專案的工作區路徑（在本 repo 內執行）

```bash

git clone https://github.com/kevintsengtw/dotnet-testing-agent-orchestration-claude.git

cd dotnet-testing-agent-orchestration-claude

python scripts/install-dotnet-testing-agents.py /path/to/your-project

```

#### 方式 B：切換到目標專案目錄後執行（目標預設為當前工作目錄）

```bash

git clone https://github.com/kevintsengtw/dotnet-testing-agent-orchestration-claude.git

cd /path/to/your-project

python /path/to/dotnet-testing-agent-orchestration-claude/scripts/install-dotnet-testing-agents.py

```

> **注意：** 指令碼必須從本 repo 的 `scripts/` 目錄執行，或透過完整路徑呼叫。勿將 `install-dotnet-testing-agents.py` 單獨複製到目標專案執行，指令碼需要讀取本 repo 的 `.claude/` 來源目錄。

指令碼會自動依序完成：複製 agents / hooks / skills（5 個）、從 GitHub 下載 Agent Skills（29+ 個）、執行 `install-hooks.js` 寫入 hooks 配置，並在結束後驗證安裝結果。

**執行環境需求：** Python 3.8+、Node.js、網路連線。詳細說明請參閱 [scripts/README.md](scripts/README.md)。

---

### 步驟 1：Clone 儲存庫

```bash

git clone https://github.com/kevintsengtw/dotnet-testing-agent-orchestration-claude.git

cd dotnet-testing-agent-orchestration-claude

```

### 步驟 2：安裝 Agent Skills

Writer Subagent 在撰寫測試時，需要載入各技術的 Skill 來確保輸出符合最佳實踐。這些 Agent Skills 由獨立 repo [`dotnet-testing-agent-skills`](https://github.com/kevintsengtw/dotnet-testing-agent-skills) 提供，需另行安裝到本 repo 的 `.claude/skills/` 目錄下。

```bash

npx skills install dotnet-testing-agent-skills

```

安裝後，`.claude/skills/` 目錄下會新增以下 29 個 Agent Skill 目錄：

```text

dotnet-testing/

dotnet-testing-advanced/

dotnet-testing-advanced-aspire-testing/

dotnet-testing-advanced-aspnet-integration-testing/

dotnet-testing-advanced-testcontainers-database/

dotnet-testing-advanced-testcontainers-nosql/

dotnet-testing-advanced-tunit-advanced/

dotnet-testing-advanced-tunit-fundamentals/

dotnet-testing-advanced-webapi-integration-testing/

dotnet-testing-advanced-xunit-upgrade-guide/

dotnet-testing-autodata-xunit-integration/

dotnet-testing-autofixture-basics/

dotnet-testing-autofixture-bogus-integration/

dotnet-testing-autofixture-customization/

dotnet-testing-autofixture-nsubstitute-integration/

dotnet-testing-awesome-assertions-guide/

dotnet-testing-bogus-fake-data/

dotnet-testing-code-coverage-analysis/

dotnet-testing-complex-object-comparison/

dotnet-testing-datetime-testing-timeprovider/

dotnet-testing-filesystem-testing-abstractions/

dotnet-testing-fluentvalidation-testing/

dotnet-testing-nsubstitute-mocking/

dotnet-testing-private-internal-testing/

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

dotnet-testing-test-naming-conventions/

dotnet-testing-test-output-logging/

dotnet-testing-unit-test-fundamentals/

dotnet-testing-xunit-project-setup/

```

每個 Skill 目錄內含 `SKILL.md`（部分含 `references/` 與 `templates/` 子目錄）。

### 步驟 3：確認完整 .claude/ 目錄結構

完成步驟 1（Clone）與步驟 2（安裝 Agent Skills）後，`.claude/` 的完整預期結構如下：

```text

.claude/

├── agents/                                                  ← 本 repo 內建（16 個）

│   ├── dotnet-testing-analyzer.md                            Unit 組

│   ├── dotnet-testing-writer.md

│   ├── dotnet-testing-executor.md

│   ├── dotnet-testing-reviewer.md

│   ├── dotnet-testing-advanced-integration-analyzer.md       Integration 組

│   ├── dotnet-testing-advanced-integration-writer.md

│   ├── dotnet-testing-advanced-integration-executor.md

│   ├── dotnet-testing-advanced-integration-reviewer.md

│   ├── dotnet-testing-advanced-aspire-analyzer.md             Aspire 組

│   ├── dotnet-testing-advanced-aspire-writer.md

│   ├── dotnet-testing-advanced-aspire-executor.md

│   ├── dotnet-testing-advanced-aspire-reviewer.md

│   ├── dotnet-testing-advanced-tunit-analyzer.md              TUnit 組

│   ├── dotnet-testing-advanced-tunit-writer.md

│   ├── dotnet-testing-advanced-tunit-executor.md

│   └── dotnet-testing-advanced-tunit-reviewer.md

├── hooks/                                                   ← 本 repo 內建

│   ├── dotnet-testing-agent-timer-pre.sh

│   ├── dotnet-testing-agent-timer-post.sh

│   └── install-hooks.js

└── skills/

    ├── dotnet-test/                                         ← 本 repo 內建（5 個）

    ├── dotnet-testing-orchestrator-unit/

    ├── dotnet-testing-orchestrator-integration/

    ├── dotnet-testing-orchestrator-aspire/

    ├── dotnet-testing-orchestrator-tunit/

    │

    ├── dotnet-testing/                                      ← Agent Skills（29 個）

    ├── dotnet-testing-advanced/

    ├── dotnet-testing-advanced-aspire-testing/

    ├── dotnet-testing-advanced-aspnet-integration-testing/

    ├── dotnet-testing-advanced-testcontainers-database/

    ├── dotnet-testing-advanced-testcontainers-nosql/

    ├── dotnet-testing-advanced-tunit-advanced/

    ├── dotnet-testing-advanced-tunit-fundamentals/

    ├── dotnet-testing-advanced-webapi-integration-testing/

    ├── dotnet-testing-advanced-xunit-upgrade-guide/

    ├── dotnet-testing-autodata-xunit-integration/

    ├── dotnet-testing-autofixture-basics/

    ├── dotnet-testing-autofixture-bogus-integration/

    ├── dotnet-testing-autofixture-customization/

    ├── dotnet-testing-autofixture-nsubstitute-integration/

    ├── dotnet-testing-awesome-assertions-guide/

    ├── dotnet-testing-bogus-fake-data/

    ├── dotnet-testing-code-coverage-analysis/

    ├── dotnet-testing-complex-object-comparison/

    ├── dotnet-testing-datetime-testing-timeprovider/

    ├── dotnet-testing-filesystem-testing-abstractions/

    ├── dotnet-testing-fluentvalidation-testing/

    ├── dotnet-testing-nsubstitute-mocking/

    ├── dotnet-testing-private-internal-testing/

    ├── dotnet-testing-test-data-builder-pattern/

    ├── dotnet-testing-test-naming-conventions/

    ├── dotnet-testing-test-output-logging/

    ├── dotnet-testing-unit-test-fundamentals/

    └── dotnet-testing-xunit-project-setup/

```

> 安裝步驟 4（計時 Hook）完成後，會新增 `.claude/settings.json`。

### 步驟 4：安裝計時 Hook（可選）

```bash

node .claude/hooks/install-hooks.js

```

Hook 會自動記錄每個 Subagent 的執行耗時，執行後設定寫入 `.claude/settings.json`。未安裝時 Orchestrator 仍可正常運作，只是不會顯示耗時資訊。

### 步驟 5：驗證安裝

在 Claude Code 中輸入以下任一指令，確認斜線指令可用：

```text

/dotnet-testing-orchestrator-unit

/dotnet-testing-orchestrator-integration

/dotnet-testing-orchestrator-aspire

/dotnet-testing-orchestrator-tunit

```

> 完整安裝說明與常見問題排查，請參閱 [docs/SETUP.md](docs/SETUP.md)

---

## 快速開始

在 Claude Code 內輸入對應指令，並提供目標資訊即可啟動工作流程。

**單元測試：**

```text

/dotnet-testing-orchestrator-unit

目標：src/Services/OrderService.cs

說明：訂單服務，依賴 IOrderRepository 和 INotificationService

```

**整合測試：**

```text

/dotnet-testing-orchestrator-integration

目標：Controllers/OrdersController.cs

資料庫：PostgreSQL

說明：訂單 CRUD API 整合測試

```

**Aspire 測試：**

```text

/dotnet-testing-orchestrator-aspire

目標：AppHost/AppHost.csproj

說明：電商平台的 Aspire 分散式應用整合測試

```

**TUnit 測試：**

```text

/dotnet-testing-orchestrator-tunit

目標：src/Services/CalculationService.cs

說明：純函式計算服務，使用 TUnit 框架

```

---

## 四種測試工作流程

| 工作流程 | 觸發指令 | 適用場景 | 必要環境 | 詳細說明 |

|---------|---------|---------|---------|---------|

| 單元測試 | `/dotnet-testing-orchestrator-unit` | xUnit + Mock + AutoFixture | .NET SDK | [使用指南](docs/guides/unit-testing.md) |

| 整合測試 | `/dotnet-testing-orchestrator-integration` | WebAPI + Testcontainers | .NET SDK + Docker | [使用指南](docs/guides/integration-testing.md) |

| Aspire 測試 | `/dotnet-testing-orchestrator-aspire` | 分散式應用 | .NET SDK + Docker + Aspire | [使用指南](docs/guides/aspire-testing.md) |

| TUnit 測試 | `/dotnet-testing-orchestrator-tunit` | TUnit 框架 / xUnit 遷移 | .NET SDK | [使用指南](docs/guides/tunit-testing.md) |

---

## 練習專案

每組練習專案皆提供 net8.0 / net9.0 / net10.0 三個版本。

| 測試類型    | 目錄                                        | 支援版本                  | 說明         |

| ----------- | ------------------------------------------- | ------------------------- | ------------ |

| 單元測試    | `samples/unit/practice/`                    | net8.0 / net9.0 / net10.0 | 6 個學習階段 |

| 整合測試    | `samples/integration/practice_integration/` | net8.0 / net9.0 / net10.0 | 5 個驗證情境 |

| Aspire 測試 | `samples/aspire/practice_aspire/`           | net8.0 / net9.0 / net10.0 | 4 個驗證階段 |

| TUnit 測試  | `samples/tunit/practice_tunit/`             | net8.0 / net9.0 / net10.0 | 5 個學習階段 |

> **注意：** `samples/*/tests/` 目錄下的測試專案為初始空白狀態，由 Orchestrator 工作流程產生內容。工作流程執行過程中產生的測試類別檔案與 `.csproj` 修改**不得 commit 或推送至遠端**，以維持練習環境的初始狀態。

---

## 文件

> 完整文件請參閱 [docs/README.md](docs/README.md)

- 一鍵安裝指令碼：[scripts/README.md](scripts/README.md)

- 安裝說明：[docs/SETUP.md](docs/SETUP.md)

- 架構總覽：[docs/architecture/overview.md](docs/architecture/overview.md)

- 使用指南：[docs/guides/](docs/guides/)