errors

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

Jump to install

Repository: AsiaOstrich/universal-dev-standards
Last source activity: May 14, 2026 at 05:32
Detected SKILL.md language: Chinese
Stars: 70
Forks: 13

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

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

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

Back to search Back to 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

View all from this repository

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

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

Install options

Review the source files

错误码指南

目的

快速參考

错误码格式

错误码指南

目的

快速參考

错误码格式

範例

错误类别

类别编号範圍

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

Source facts

Install options

Review the source files

More from this repository

错误码指南

目的

快速參考

错误码格式

错误码指南

目的

快速參考

错误码格式

範例

错误类别

类别编号範圍

HTTP 状态码对应

详细指南

AI 優化格式（节省 Token）

错误响应格式

单一错误

多个错误

內部错误物件

國际化 (i18n)

消息鍵值格式

翻譯文件範例

範例

✅ 良好的错误码

❌ 不良的错误码

检查清单

设置偵测

偵测順序

首次设置

相关标准

版本历史

授权

Next Steps Guidance | 下一步引導

Related Standards

Version History

License

More from this repository