csharp-testing

csharp-testing 技能概覽

csharp-testing 是做什麼的

csharp-testing 技能是一份實用指南，專門用來撰寫與改進 C# 和 .NET 測試，涵蓋 xUnit、FluentAssertions、mock、以及整合測試模式。它最適合那些想把一個零散的測試任務整理成乾淨、可維護的測試實作，而不是只丟給一般模型一句「幫我寫一些測試」的人。

誰適合使用它

如果你正在為既有的 .NET 程式碼庫補測試、檢視不穩定或低價值的測試，或是替已經使用 C# 的應用程式建立新的測試堆疊，就很適合使用 csharp-testing 技能。它特別適合測試自動化工作，因為你需要清楚的結構、可讀的斷言，以及單元測試與整合測試之間明確的界線。

它有什麼不同

這個技能聚焦的是具體的測試決策：什麼時候用 xUnit、什麼時候要 mock、什麼時候應該優先考慮 Testcontainers 或 WebApplicationFactory，以及如何用 Arrange-Act-Assert 來組織測試。也因為如此，csharp-testing 技能比鬆散的提示更有用，因為它會把你往真正的工作流程推，而不只是產出一次性的片段。

如何使用 csharp-testing 技能

安裝並啟用它

請在你的技能目錄中使用 csharp-testing install 流程，或依照這個 repo 的技能安裝命令模式來安裝，然後在要求測試相關工作之前，先把你的代理指向這個技能。如果你使用的是共用 repo 安裝路徑，基礎命令如下：

npx skills add affaan-m/everything-claude-code --skill csharp-testing

提供正確的輸入給技能

csharp-testing usage 的效果最好，是在你提供了正式程式碼、測試目標、目前使用的框架，以及你想驗證的行為時。像「幫這個 service 寫測試」這種弱提示，會留下太多選擇空間；更強的提示應該直接指出 class 名稱、框架、需要隔離的依賴，以及要涵蓋的邊界情況。

先從對的檔案開始看

如果你要快速使用 csharp-testing guide，請先讀 SKILL.md，再視情況檢查 README.md、AGENTS.md、metadata.json，以及任何支援資料夾。這個 repository 內，SKILL.md 是主要的事實來源，所以你的第一步應該先了解偏好的技術堆疊、啟用觸發條件與測試結構，再把它套用到你的應用程式。

提示工作流程，不只是輸出結果

一個有用的請求通常會像這樣：「使用 csharp-testing 進行 Test Automation，為 OrderService 寫 xUnit 測試，mock repository 和 logger 相依性，使用 FluentAssertions，保留 Arrange-Act-Assert，並在資料庫行為重要時加上一個整合測試建議。」這種細節程度可以幫助技能選對測試類型、斷言風格與 fixture 形狀，而不會憑空發明與情境無關的慣例。

csharp-testing 技能 FAQ

csharp-testing 只適合新測試嗎？

不是。csharp-testing 技能在你檢視既有測試、重構脆弱測試，或判斷某個失敗案例應該是單元測試還是整合測試時，也同樣有用。只要任務重點是測試設計，而不只是產生測試，就很適合。

它和一般提示相比有什麼差別？

一般提示也能產出程式碼，但 csharp-testing 會幫你把輸出限制在 .NET 特定選擇上，例如 xUnit 慣例、FluentAssertions、NSubstitute 或 Moq，以及在情境需要時使用 WebApplicationFactory。通常這代表後續整理較少，也比較不需要再修正一輪。

對初學者友善嗎？

可以，只要你能描述要測試的程式碼，以及什麼叫做「正確」。初學者最有收穫的方式，是提供一個小範圍的目標方法、預期輸入與預期結果，而不是直接要求整個專案層級的測試套件。

什麼情況下不建議使用？

如果你的專案不是 C#/.NET、如果你需要的是語言無關的 QA 建議，或如果問題範圍比測試機制更廣，就可以先跳過 csharp-testing。如果你只是想純粹比較框架，卻沒有任何程式碼可套用，它也不是理想選擇。

如何改進 csharp-testing 技能

給更明確的測試邊界

最大的品質提升，來自於清楚指出哪些部分應該隔離、哪些部分應該保留真實行為。如果你要的是單元測試，就說明哪些 collaborator 應該被 mock；如果你要的是整合覆蓋，就說明要不要真的跑資料庫、HTTP 層或外部服務。

說明你在意的失敗模式

當你明確指出風險時，csharp-testing 的結果會更好：例如時間競態造成的不穩定、斷言難讀、過度 mock、缺少邊界案例，或整合測試太慢。這樣技能才會針對真正的問題最佳化，而不是只產出一般化的「成功路徑」覆蓋。

要求測試形狀，不只是測試數量

如果你希望 csharp-testing skill 產出真正有用的內容，請直接要求命名慣例、Arrange-Act-Assert 結構、fixture 風格，以及斷言函式庫的選擇。像「為成功、驗證失敗與依賴失敗各寫 3 個測試」就比「多寫一些測試」更有幫助。

配合 repository 限制逐步調整

第一次產出後，請告訴技能你的程式碼庫已經使用了什麼、又有哪些東西不能改，例如現有的 xUnit fixture、mocking 函式庫、命名規則，或 CI 執行時間限制。這樣可以讓 csharp-testing guide 更貼近你實際的 repo，避免提出看起來正確、但不符合你建置流程的建議。