convez.ai
AgenteDevOps & InfraestruturaAvançado
kevintsengtw

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 GitHub
InicialPluginScore · de 0 a 100

Agent 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-claude

1 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

Estrelas
0
Forks
1
Acompanhando
0
Saúde
28%
Último commit
há 1 mês
Versão
v1.7.3
Issues abertas
0
Contribuidores
2

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 SDK8.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-unitxUnit + Mock + AutoFixture.NET SDK使用指南
整合測試/dotnet-testing-orchestrator-integrationWebAPI + Testcontainers.NET SDK + Docker使用指南
Aspire 測試/dotnet-testing-orchestrator-aspire分散式應用.NET SDK + Docker + Aspire使用指南
TUnit 測試/dotnet-testing-orchestrator-tunitTUnit 框架 / xUnit 遷移.NET SDK使用指南

練習專案

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

測試類型目錄支援版本說明
單元測試samples/unit/practice/net8.0 / net9.0 / net10.06 個學習階段
整合測試samples/integration/practice_integration/net8.0 / net9.0 / net10.05 個驗證情境
Aspire 測試samples/aspire/practice_aspire/net8.0 / net9.0 / net10.04 個驗證階段
TUnit 測試samples/tunit/practice_tunit/net8.0 / net9.0 / net10.05 個學習階段

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


文件

完整文件請參閱 docs/README.md

Ver o original no GitHub

Bom para

Relacionados