dotnet-backend-patterns

概覽

什麼是 dotnet-backend-patterns？

dotnet-backend-patterns 是一套全面的技能，專注於掌握 C#/.NET 後端開發。它提供實用的模式與最佳實踐，幫助打造生產等級的 API、MCP 伺服器與企業應用程式。此技能聚焦於現代 .NET 技術，包括 async/await、依賴注入、Entity Framework Core、Dapper、設定管理、快取策略，以及使用 xUnit 進行自動化測試。

誰適合使用這個技能？

• 建置新 API 或服務的 .NET 後端開發者
• 進行 C# 程式碼可維護性與效能審查的團隊
• 設計可擴展且易測試後端解決方案的架構師
• 優化資料存取與快取的開發者

解決的問題

• 建立乾淨的 .NET 專案架構
• 指導依賴注入與服務註冊
• 使用 EF Core 與 Dapper 優化資料庫存取
• 實作 Redis 與記憶體快取
• 提供設定、錯誤處理與韌性模式
• 支援使用 xUnit 進行穩健測試

使用說明

安裝步驟

1. 使用以下指令將技能加入代理或專案：
   npx skills add https://github.com/wshobson/agents --skill dotnet-backend-patterns
2. 首先閱讀 SKILL.md，了解高階摘要與工作流程。
3. 如有提供，請參考 README.md、AGENTS.md 與 metadata.json 以獲得更多背景資訊。
4. 探索 assets/ 資料夾中的程式碼範本：
   • repository-template.cs：儲存庫模式範本
   • service-template.cs：服務層結構範本
5. 查閱 references/ 以取得深入指南：
   • dapper-patterns.md：高效能 Dapper 使用
   • ef-core-best-practices.md：EF Core 優化實務

適應您的專案

• 以提供的範本與參考資料作為起點。
• 根據您的儲存庫結構、商業邏輯與基礎架構調整模式。
• 根據應用需求整合依賴注入、快取與測試。

涵蓋的核心概念

• 乾淨架構專案結構，提升程式碼可維護性
• 依賴注入設定與最佳實踐
• 使用 Dapper 與 EF Core 進行進階資料存取
• 利用 Redis 與記憶體快取的快取策略
• 使用 IOptions 模式進行應用程式設定
• 使用 xUnit 進行單元與整合測試

常見問題

什麼時候應該使用 dotnet-backend-patterns？

當您開始新的 .NET 後端專案、重構舊有程式碼，或在團隊間標準化後端開發實務時，這個技能非常適合。特別適用於需要可擴展 API、穩健資料存取與易維護架構的專案。

哪些檔案或資料夾最重要？

建議先從 SKILL.md 瞭解整體概覽。實作細節可參考 assets/repository-template.cs、assets/service-template.cs，以及 references/ 資料夾中關於 Dapper 與 EF Core 的最佳實踐。

這個技能同時涵蓋 EF Core 和 Dapper 嗎？

是的。它提供並列的指導，說明何時使用 EF Core 或 Dapper，並包含效能考量與程式碼範例。

這個技能適合微服務架構嗎？

適合。這些模式與實務同樣適用於 .NET 的單體與微服務架構。

我在哪裡可以找到更多範例？

請開啟檔案標籤，瀏覽 dotnet-backend-patterns 附帶的所有範本、參考資料與輔助腳本。