Orquestrador de Testes .NET para Claude Code
kevintsengtw/dotnet-testing-agent-orchestration-claude
Automação end-to-end de testes .NET com subagentes Claude
Ver no GitHubAgent que automatiza a criação e execução de testes .NET através de orquestração com subagentes especializados. Implementa fluxo completo de análise, escrita, execução e revisão de testes (unitários, integração, Aspire e TUnit) via modelo 1+4 (1 orchestrator + 4 subagentes).
Instalação
npx convez-ai kevintsengtw/dotnet-testing-agent-orchestration-claude1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Geração automática de suítes de testes para projetos .NET
- Testes de integração com Docker e Testcontainers
- Testes Aspire com orquestração de múltiplos serviços
- Validação e revisão contínua de qualidade de testes
Veredito

Solução robusta para times .NET que buscam automatizar o ciclo completo de testes via agents Claude. Requer domínio de .NET, Docker e Claude Code, mas oferece retorno significativo em redução de tempo de teste manual e padronização de qualidade.
README
A tradução para o português deste README ainda está na fila.
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 專案的開發人員,提供可直接套用於實際專案的工作流程範例與練習素材。
架構概覽
Orchestrator Skill 接收使用者指令後,依序呼叫四個 Subagent:
Orchestrator Skill
├── Analyzer Subagent (分析目標類別、依賴項、測試技術)
├── Writer Subagent (載入 Skills,產生測試程式碼)
├── Executor Subagent (建置並執行測試,處理修正迴圈)
└── Reviewer Subagent (審查命名、斷言、覆蓋率、框架合規性)
每個階段必須依序完成,Reviewer 提出改善建議後,Orchestrator 會再次呼叫 Writer + Executor 進行修正。
詳細架構圖與各 Orchestrator 流程說明,請參閱 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:
dotnet workload install aspire
安裝與環境設定
一鍵安裝(推薦)
Clone 本 repo 後,從 repo 根目錄執行安裝指令碼,有兩種呼叫方式:
方式 A:指定目標專案的工作區路徑(在本 repo 內執行)
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:切換到目標專案目錄後執行(目標預設為當前工作目錄)
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。
步驟 1:Clone 儲存庫
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 提供,需另行安裝到本 repo 的 .claude/skills/ 目錄下。
npx skills install dotnet-testing-agent-skills
安裝後,.claude/skills/ 目錄下會新增以下 29 個 Agent Skill 目錄:
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/ 的完整預期結構如下:
.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(可選)
node .claude/hooks/install-hooks.js
Hook 會自動記錄每個 Subagent 的執行耗時,執行後設定寫入 .claude/settings.json。未安裝時 Orchestrator 仍可正常運作,只是不會顯示耗時資訊。
步驟 5:驗證安裝
在 Claude Code 中輸入以下任一指令,確認斜線指令可用:
/dotnet-testing-orchestrator-unit
/dotnet-testing-orchestrator-integration
/dotnet-testing-orchestrator-aspire
/dotnet-testing-orchestrator-tunit
完整安裝說明與常見問題排查,請參閱 docs/SETUP.md
快速開始
在 Claude Code 內輸入對應指令,並提供目標資訊即可啟動工作流程。
單元測試:
/dotnet-testing-orchestrator-unit
目標:src/Services/OrderService.cs
說明:訂單服務,依賴 IOrderRepository 和 INotificationService
整合測試:
/dotnet-testing-orchestrator-integration
目標:Controllers/OrdersController.cs
資料庫:PostgreSQL
說明:訂單 CRUD API 整合測試
Aspire 測試:
/dotnet-testing-orchestrator-aspire
目標:AppHost/AppHost.csproj
說明:電商平台的 Aspire 分散式應用整合測試
TUnit 測試:
/dotnet-testing-orchestrator-tunit
目標:src/Services/CalculationService.cs
說明:純函式計算服務,使用 TUnit 框架
四種測試工作流程
| 工作流程 | 觸發指令 | 適用場景 | 必要環境 | 詳細說明 |
|---|---|---|---|---|
| 單元測試 | /dotnet-testing-orchestrator-unit | xUnit + Mock + AutoFixture | .NET SDK | 使用指南 |
| 整合測試 | /dotnet-testing-orchestrator-integration | WebAPI + Testcontainers | .NET SDK + Docker | 使用指南 |
| Aspire 測試 | /dotnet-testing-orchestrator-aspire | 分散式應用 | .NET SDK + Docker + Aspire | 使用指南 |
| TUnit 測試 | /dotnet-testing-orchestrator-tunit | TUnit 框架 / xUnit 遷移 | .NET SDK | 使用指南 |
練習專案
每組練習專案皆提供 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
- 一鍵安裝指令碼:scripts/README.md
- 安裝說明:docs/SETUP.md
- 架構總覽:docs/architecture/overview.md
- 使用指南:docs/guides/