errors

[UDS] 設計一致的錯誤碼，遵循 PREFIX_CATEGORY_NUMBER 格式

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

orchestrate

[UDS] 以 Claude 原生 Agent tool 编排多任务执行计划（DAG-based，无外部引擎）。 Use when: executing a plan.json file with parallel/sequential task dependencies. Keywords: orchestrate, plan, execute, DAG, task plan, 编排, 执行计划, 并行.

2026-07-20

plan

[UDS] 从 Spec 文档、OpenSpec 变更或自由文本需求生成 plan.json。 Use when: converting specifications into executable task plans for /orchestrate. Keywords: plan, spec, task plan, 计划, 规格, 任务, plan.json, DAG.

2026-07-20

push

[UDS] AI 辅助 git push 安全层：质量门禁 + 协作护栏。 Use when: pushing commits, force pushing, pushing to protected branches, pushing feature branches. Keywords: git push, force push, protected branch, quality gate, push receipt, PR automation, 推送, 保护分支, 质量门禁.

2026-07-20

Alle aus diesem Repository ansehen

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	[UDS] 設計一致的錯誤碼，遵循 PREFIX_CATEGORY_NUMBER 格式
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	[UDS] 設計一致的錯誤碼，遵循 PREFIX_CATEGORY_NUMBER 格式
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

錯誤碼指南

目的

快速參考

錯誤碼格式

錯誤碼指南

目的

快速參考

錯誤碼格式

範例

錯誤類別

類別編號範圍

HTTP 狀態碼對應

詳細指南

AI 優化格式（節省 Token）

錯誤回應格式

單一錯誤

多個錯誤

內部錯誤物件

國際化 (i18n)

訊息鍵值格式

翻譯檔案範例

範例

✅ 良好的錯誤碼

❌ 不良的錯誤碼

檢查清單

設定偵測

偵測順序

首次設定

相關標準

版本歷史

授權

Next Steps Guidance | 下一步引導

Related Standards

Version History

License

Mehr aus diesem Repository