bianhaifeng789-hue/errors-utils

Errors Utils Skill - Errors Utils

Errors Utils 错误处理工具。

为什么需要这个？

场景：

• Custom error classes
• Abort error detection
• errno extraction
• Telemetry safe errors
• Error normalization

Claude Code 方案：errors.ts + 239+ lines OpenClaw 飞书适配：Errors utils + Error handling

---

Error Classes

ClaudeError

export class ClaudeError extends Error {
  constructor(message: string) {
    super(message)
    this.name = this.constructor.name
  }
}

MalformedCommandError

export class MalformedCommandError extends Error {}

AbortError

export class AbortError extends Error {
  constructor(message?: string) {
    super(message)
    this.name = 'AbortError'
  }
}

ConfigParseError

export class ConfigParseError extends Error {
  filePath: string
  defaultConfig: unknown

  constructor(message: string, filePath: string, defaultConfig: unknown) {
    super(message)
    this.name = 'ConfigParseError'
    this.filePath = filePath
    this.defaultConfig = defaultConfig
  }
}

ShellError

export class ShellError extends Error {
  constructor(
    public readonly stdout: string,
    public readonly stderr: string,
    public readonly code: number,
    public readonly interrupted: boolean,
  ) {
    super('Shell command failed')
    this.name = 'ShellError'
  }
}

TeleportOperationError

export class TeleportOperationError extends Error {
  constructor(
    message: string,
    public readonly formattedMessage: string,
  ) {
    super(message)
    this.name = 'TeleportOperationError'
  }
}

TelemetrySafeError

export class TelemetrySafeError_I_VERIFIED_THIS_IS_NOT_CODE_OR_FILEPATHS extends Error {
  readonly telemetryMessage: string

  constructor(message: string, telemetryMessage?: string) {
    super(message)
    this.name = 'TelemetrySafeError'
    this.telemetryMessage = telemetryMessage ?? message
  }
}

---

Functions

1. isAbortError

export function isAbortError(e: unknown): boolean {
  return (
    e instanceof AbortError ||
    e instanceof APIUserAbortError ||
    (e instanceof Error && e.name === 'AbortError')
  )
}

2. hasExactErrorMessage

export function hasExactErrorMessage(error: unknown, message: string): boolean {
  return error instanceof Error && error.message === message
}

3. toError

export function toError(e: unknown): Error {
  return e instanceof Error ? e : new Error(String(e))
}

4. errorMessage

export function errorMessage(e: unknown): string {
  return e instanceof Error ? e.message : String(e)
}

5. getErrnoCode

export function getErrnoCode(e: unknown): string | undefined {
  if (e && typeof e === 'object' && 'code' in e && typeof e.code === 'string') {
    return e.code
  }
  return undefined
}

6. isENOENT

export function isENOENT(e: unknown): boolean {
  return getErrnoCode(e) === 'ENOENT'
}

7. getErrnoPath

export function getErrnoPath(e: unknown): string | undefined {
  if (e && typeof e === 'object' && 'path' in e && typeof e.path === 'string') {
    return e.path
  }
  return undefined
}

---

飞书卡片格式

Errors Utils 卡片

{
  "config": {"wide_screen_mode": true},
  "elements": [
    {
      "tag": "div",
      "text": {
        "tag": "lark_md",
        "content": "**⚠️ Errors Utils**\n\n---\n\n**Error Classes**：\n• ClaudeError\n• MalformedCommandError\n• AbortError\n• ConfigParseError\n• ShellError\n• TeleportOperationError\n• TelemetrySafeError\n\n---\n\n**Functions**：\n• isAbortError()\n• hasExactErrorMessage()\n• toError()\n• errorMessage()\n• getErrnoCode()\n• isENOENT()\n• getErrnoPath()"
      }
    }
  ]
}

---

持久化存储

// memory/errors-utils-state.json
{
  "stats": {
    "totalErrors": 0,
    "abortErrors": 0
  },
  "lastUpdate": "2026-04-12T12:37:00Z",
  "notes": "Errors Utils Skill 创建完成。"
}