القائمة
錯誤處理與 Result Pattern 技能，協助開發者實作統一的錯誤處理機制，包含 Result Pattern 應用、Failure 物件建立與分層錯誤處理策略。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | error-handling |
| description | 錯誤處理與 Result Pattern 技能，協助開發者實作統一的錯誤處理機制，包含 Result Pattern 應用、Failure 物件建立與分層錯誤處理策略。 |
本 SKILL 須搭配閱讀：開發規則
錯誤處理與 Result Pattern 技能，協助開發者實作統一的錯誤處理機制，包含 Result Pattern 應用、Failure 物件建立與分層錯誤處理。
錯誤處理是跨層級的通用模式，不受「API First vs Code First」選擇影響：
因此本 SKILL 未區分 API 開發流程，所有 Result Pattern 與錯誤處理指導均適用於兩種方式。
👉 API 開發流程選擇 → 參考 /api-development SKILL
使用 CSharpFunctionalExtensions 套件，統一錯誤處理：
public async Task<Result<TSuccess, Failure>> MethodAsync(...)
{
// 成功路徑
return Result.Success<TSuccess, Failure>(data);
// 失敗路徑
return Result.Failure<TSuccess, Failure>(new Failure { ... });
}
public class Failure
{
public string Code { get; set; } // 錯誤代碼
public string Message { get; set; } // 錯誤訊息
public string TraceId { get; set; } // 追蹤 ID
public Exception? Exception { get; set; } // 原始例外（不序列化）
public Dictionary<string, object>? Data { get; set; } // 額外資料
}
public enum FailureCode
{
Unauthorized, // 401
ValidationError, // 400
DuplicateEmail, // 409
NotFound, // 404
DbError, // 500
DbConcurrency, // 409
InvalidOperation, // 400
Timeout, // 408
InternalServerError, // 500
Unknown // 500
}
開發者應參考專案內的實際實作代碼：
Failure 實作：
node .claude/skills/shared/FileResolver.js get-content \
src/JobBank1111.Infrastructure/Results/Failure.cs
API 開發流程引導技能，協助開發者選擇合適的開發流程（API First 或 Code First），並提供 OpenAPI 規格管理、程式碼產生等自動化支援。
BDD 測試實作技能，協助開發者使用 Reqnroll 撰寫行為驅動開發測試，包含 Gherkin 語法、測試步驟實作與 Docker 測試環境設定。
快取策略與多層快取設計技能，協助開發者實作 L1 Memory + L2 Redis 分層快取，包含 TTL 管理、版本控制與失效策略。
EF Core 操作與最佳化技能，協助開發者正確使用 Entity Framework Core，包含 DbContextFactory 模式、查詢最佳化、Migration 管理與反向工程。
專案初始化與配置技能，負責引導使用者完成新專案的初始化、配置設定、GitHub 範本套用與專案狀態檢測。
Repository 設計指導技能，協助開發者根據業務需求選擇最合適的 Repository 設計策略（資料表導向 vs 需求導向 vs 混合模式）。