← 返回 Skills 市场
mike47512

Error Handling

作者 mike47512 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ 安全检测通过
257
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install error-handling
功能描述
Deep error handling workflow—taxonomy, user-visible vs internal errors, retries and idempotency, observability, and supportability. Use when standardizing fa...
使用说明 (SKILL.md)

Error Handling

Consistent errors reduce support load and on-call pain. Design a taxonomy, stable codes, safe user messaging, and operator visibility—without leaking secrets or stack traces to clients.

When to Offer This Workflow

Trigger conditions:

  • Inconsistent HTTP status codes and response bodies
  • Retry storms or duplicate side effects from naive retries
  • Logs that cannot be tied to user-visible failures

Initial offer:

Use six stages: (1) classify errors, (2) map to transport, (3) user messaging, (4) retries & idempotency, (5) observability, (6) client SDKs & DX). Confirm REST/GraphQL/gRPC and sync/async patterns.

Stage 1: Classify Errors

Goal: Distinguish validation, authentication, authorization, not found, conflict, rate limit, dependency failure, and internal bugs.

Exit condition: Table or enum of codes with owning team and meaning.

Stage 2: Map to Transport

Goal: Correct HTTP 4xx/5xx; GraphQL errors with extensions; gRPC status codes; optional RFC 7807 Problem Details for JSON APIs.

Stage 3: User Messaging

Goal: Actionable copy for end users; opaque support reference id; no internal hostnames, SQL fragments, or stack traces in client responses.

Stage 4: Retries & Idempotency

Goal: Retry only safe or idempotent operations; exponential backoff with jitter; align with idempotency keys on writes.

Stage 5: Observability

Goal: Structured logs with error.code, trace_id, user_id (where allowed); metrics by error class; alerts on error-rate SLO burn.

Stage 6: Client SDKs & DX

Goal: Typed errors in SDKs; documented recovery; map codes to user-facing strings in apps consistently.

Final Review Checklist

  • Taxonomy and ownership defined
  • Transport mapping correct and consistent
  • User-safe messages with correlation ids
  • Retry policy matches idempotency story
  • Logs and metrics wired for ops

Tips for Effective Guidance

  • Separate expected validation errors from unexpected 500s in dashboards.
  • Pair with idempotency for write paths and queues.

Handling Deviations

  • Mobile offline: queue with explicit user-visible sync state.
安全使用建议
This skill is a safe, high-level checklist for standardizing error handling and does not install code or ask for credentials. Before using it in production, adapt the taxonomy and logging recommendations to your privacy and compliance rules (avoid logging PII where prohibited), ensure the suggested correlation ids integrate with your tracing system, and translate the guidance into concrete code/SDK changes under your team’s review process.
功能分析
Type: OpenClaw Skill Name: error-handling Version: 1.0.0 The skill bundle contains architectural guidance and workflow instructions for implementing standardized error handling in software systems. It focuses on best practices such as error taxonomy, idempotency, and preventing the leakage of sensitive information (stack traces/secrets) in API responses, with no executable code or malicious instructions present in SKILL.md or _meta.json.
能力评估
✓ Purpose & Capability
The name/description promise a design workflow for error handling and the skill is purely instruction-only with no binaries, env vars, or installs — a proportional and expected footprint for a guidance/template skill.
✓ Instruction Scope
SKILL.md contains step-by-step design guidance (taxonomy, transport mapping, messaging, retries, observability, SDKs). It does not instruct the agent to read system files, access credentials, or call external endpoints; guidance to include user IDs in logs is appropriately qualified with "where allowed."
✓ Install Mechanism
No install spec and no code files are present, so nothing is written to disk or executed during install — this is the lowest-risk pattern and appropriate for a documentation-style skill.
✓ Credentials
The skill requires no environment variables, credentials, or config paths. The guidance mentions logging user_id where permitted but does not request secrets or access to external services, which is proportionate for its purpose.
✓ Persistence & Privilege
always is false and the skill is user-invocable; it does not request persistent system privileges or attempt to modify other skills or system configuration.
如何使用
  1. 确保已安装 OpenClaw（本地或 Docker 部署）
  2. 在对话框中输入安装命令：/install error-handling
  3. 安装完成后，直接呼叫该 Skill 的名称或使用 /error-handling 触发
  4. 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
Initial public release introducing a comprehensive error-handling workflow across APIs and async workers. - Defines a six-stage process: error classification, transport mapping, user messaging, retries & idempotency, observability, and client SDK support. - Guides on building a stable taxonomy of error codes with operator visibility and safe user messages. - Provides clear recommendations for retry patterns and aligning idempotency in distributed systems. - Emphasizes structured logging, metrics by error class, and actionable user feedback.
元数据
Slug error-handling
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

Error Handling 是什么？

Deep error handling workflow—taxonomy, user-visible vs internal errors, retries and idempotency, observability, and supportability. Use when standardizing fa... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 257 次。

如何安装 Error Handling？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install error-handling」即可一键安装，无需额外配置。

Error Handling 是免费的吗？

是的，Error Handling 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

Error Handling 支持哪些平台？

Error Handling 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Error Handling？

由 mike47512（@mike47512）开发并维护，当前版本 v1.0.0。

推荐 Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191113 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 留言讨论