error-code-guide

# 錯誤碼指南 > **語言**: [English](../../../../skills/error-code-guide/SKILL.md) | 繁體中文 **版本**: 1.0.0 **最後更新**: 2025-12-30 **適用範圍**: Claude Code Skills --- ## 目的 此技能幫助設計一致的錯誤碼，遵循標準格式，實現更好的除錯、監控和使用者體驗。 ## 快速參考 ### 錯誤碼格式 ``` <前綴>_<類別>_<編號> ``` | 元素 | 說明 | 範例 | |------|------|------| | 前綴 (PREFIX) | 應用/服務識別碼 | AUTH, PAY, USR | | 類別 (CATEGORY) | 錯誤類別 | VAL, SYS, BIZ | | 編號 (NUMBER) | 唯一數字識別碼 | 001, 100, 404 | ### 範例 ``` AUTH_VAL_001 → 認證驗證錯誤 PAY_SYS_503 → 付款系統無法使用 USR_BIZ_100 → 使用者商業規則違規 API_NET_408 → API 網路逾時 ``` ### 錯誤類別 | 類別 | 全名 | 說明 | HTTP 狀態碼 | |------|------|------|-------------| | **VAL** | Validation | 客戶端輸入驗證失敗 | 400 | | **BIZ** | Business | 商業規則違規 | 422 | | **SYS** | System | 內部系統錯誤 | 500 | | **NET** | Network | 通訊錯誤 | 502/503/504 | | **AUTH** | Auth | 安全相關錯誤 | 401/403 | ### 類別編號範圍 | 範圍 | 說明 | 範例 | |------|------|------| | *_VAL_001-099 | 欄位驗證 | 缺少必填欄位 | | *_VAL_100-199 | 格式驗證 | 電子郵件格式無效 | | *_VAL_200-299 | 約束驗證 | 密碼太短 | | *_BIZ_001-099 | 狀態違規 | 訂單已取消 | | *_BIZ_100-199 | 規則違規 | 超過 30 天無法退貨 | | *_BIZ_200-299 | 限制違規 | 超過每日限制 | | *_AUTH_001-099 | 認證 | 帳號密碼錯誤 | | *_AUTH_100-199 | 授權 | 權限不足 | | *_AUTH_200-299 | Token/Session | Token 已過期 | ## HTTP 狀態碼對應 | 類別 | HTTP 狀態碼 | 說明 | |------|-------------|------| | VAL | 400 | Bad Request | | BIZ | 422 | Unprocessable Entity | | AUTH (001-099) | 401 | Unauthorized | | AUTH (100-199) | 403 | Forbidden | | SYS | 500 | Internal Server Error | | NET | 502/503/504 | Gateway errors | ## 詳細指南 完整標準請參考： - [錯誤碼標準](....