errors

设计一致的错误码，遵循 PREFIX_CATEGORY_NUMBER 格式。使用时机：定義错误码、建立错误处理、设计 API。关鍵字：error code, error handling, error format, API errors, 错误码, 错误处理。

Zur Installation springen

Repository: AsiaOstrich/universal-dev-standards
Letzte Quellaktivität: 14. Mai 2026 um 05:32
Erkannte Sprache von SKILL.md: Chinesisch
Sterne: 70
Forks: 13

Installationsoptionen

Standardmäßig ist der Prompt ausgewählt, der zuerst die Quelle prüft. Sie können zu einem direkten Befehl wechseln oder eine lokale Kopie herunterladen.

Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.

Ein direkter Befehl überspringt den Prüf-Prompt. Prüfen Sie die Quelle, bevor Sie ihn ausführen.

npx skills add https://github.com/AsiaOstrich/universal-dev-standards --skill errors

Der Befehl bleibt in einer Zeile. Scrollen Sie horizontal, um ihn vor dem Kopieren vollständig zu prüfen.

Sie bevorzugen eine lokale Kopie? Laden Sie die Dateien herunter, die SkillsMP derzeit vorliegen.

Quelldateien prüfen

Lesen Sie SKILL.md und alle von SkillsMP angezeigten Begleitdateien, bevor Sie sich für eine Installation entscheiden.

SKILL.md

Quellanweisungen · Schreibgeschützte Vorschau

Zurück zur Suche Zurück zur Installation

<前綴>_<类别>_<编号>

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 已過期

{
  "success": false,
  "error": {
    "code": "AUTH_VAL_001",
    "message": "電子郵件为必填欄位",
    "field": "email",
    "requestId": "req_abc123"
  }
}

{
  "success": false,
  "errors": [
    {
      "code": "AUTH_VAL_001",
      "message": "電子郵件为必填欄位",
      "field": "email"
    },
    {
      "code": "AUTH_VAL_201",
      "message": "密码至少需要 8 个字元",
      "field": "password"
    }
  ],
  "requestId": "req_abc123"
}

interface ApplicationError {
  // 核心欄位
  code: string;          // "AUTH_VAL_001"
  message: string;       // 技術消息（用於日誌）

  // 使用者界面
  userMessage: string;   // 本地化使用者消息
  userMessageKey: string; // i18n 鍵值: "error.auth.val.001"

  // 上下文
  field?: string;        // 相关欄位: "email"
  details?: object;      // 附加信息

  // 除錯
  timestamp: string;     // ISO 8601
  requestId: string;     // 关联 ID
}

error.<前綴>.<类别>.<编号>

# en.yaml
error:
  auth:
    val:
      001: "Email is required"
      101: "Invalid email format"
    auth:
      001: "Invalid credentials"

# zh-TW.yaml
error:
  auth:
    val:
      001: "電子郵件为必填欄位"
      101: "電子郵件格式無效"
    auth:
      001: "帳号或密码错误"

AUTH_VAL_001  // 缺少必填欄位: email
AUTH_VAL_101  // 電子郵件格式無效
ORDER_BIZ_001 // 订单已取消
ORDER_BIZ_201 // 超過每日購买限制
DB_SYS_001    // 数据庫查詢失败
SEC_AUTH_001  // 帳号密码错误
SEC_AUTH_201  // Token 已過期

ERR_001       // 太模糊，没有前綴或类别
INVALID       // 不具描述性
error         // 不是错误码
AUTH_ERROR    // 缺少编号

export const ErrorCodes = {
  AUTH_VAL_001: {
    code: 'AUTH_VAL_001',
    httpStatus: 400,
    messageKey: 'error.auth.val.001',
    description: '電子郵件欄位为必填',
  },
  // ... 更多错误码
} as const;

name	errors
description	设计一致的错误码，遵循 PREFIX_CATEGORY_NUMBER 格式。使用时机：定義错误码、建立错误处理、设计 API。关鍵字：error code, error handling, error format, API errors, 错误码, 错误处理。
source	../../../../skills/error-code-guide/SKILL.md
source_version	1.0.0
translation_version	1.0.0
last_synced	"2026-01-08T00:00:00.000Z"
status	current

name	errors
description	设计一致的错误码，遵循 PREFIX_CATEGORY_NUMBER 格式。使用时机：定義错误码、建立错误处理、设计 API。关鍵字：error code, error handling, error format, API errors, 错误码, 错误处理。
source	../../../../skills/error-code-guide/SKILL.md
source_version	1.0.0
translation_version	1.0.0
last_synced	"2026-01-08T00:00:00.000Z"
status	current

元素	说明	範例
前綴 (PREFIX)	应用/服务識别码	AUTH, PAY, USR
类别 (CATEGORY)	错误类别	VAL, SYS, BIZ
编号 (NUMBER)	唯一數字識别码	001, 100, 404

errors

Installationsoptionen

Quelldateien prüfen

错误码指南

目的

快速參考

错误码格式

错误码指南

目的

快速參考

错误码格式

範例

错误类别

类别编号範圍

HTTP 状态码对应

详细指南

AI 優化格式（节省 Token）

错误响应格式

单一错误

多个错误

內部错误物件

國际化 (i18n)

消息鍵值格式

翻譯文件範例

範例

✅ 良好的错误码

❌ 不良的错误码

检查清单

设置偵测

偵测順序

首次设置

相关标准

版本历史

授权

Next Steps Guidance | 下一步引導

Related Standards

Version History

License

类别	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

errors

Quellinformationen

Installationsoptionen

Quelldateien prüfen

Mehr aus diesem Repository

错误码指南

目的

快速參考

错误码格式

错误码指南

目的

快速參考

错误码格式

Mehr aus diesem Repository

範例

错误类别

类别编号範圍

HTTP 状态码对应

详细指南

AI 優化格式（节省 Token）

错误响应格式

单一错误

多个错误

內部错误物件

國际化 (i18n)

消息鍵值格式

翻譯文件範例

範例

✅ 良好的错误码

❌ 不良的错误码

检查清单

设置偵测

偵测順序

首次设置

相关标准

版本历史

授权

Next Steps Guidance | 下一步引導

Related Standards

Version History

License