메뉴
錯誤處理與 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 混合模式）。