mcpField
E
error-patterns

error-patterns

github.com/athola开发34397 次安装1 天前更新
代码仓库

关于 error-patterns

此技能为可靠的集成提供统一的错误分类、恢复和调试模式，面向采用 leyline 基础设施模式的项目，并涵盖常见认证、限流、超时和上下文过大错误。

主要功能

  1. 01按严重程度与可恢复性分类
  2. 02标准化错误结果
  3. 03认证与权限错误处理
  4. 04速率限制和退避策略
  5. 05超时及超大上下文恢复

适用场景

  1. 01构建具备恢复能力的服务集成
  2. 02处理 API 速率限制与超时
  3. 03排查生产环境中的错误

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/athola/claude-night-market --skill error-patterns

安装后在 Claude Code 中输入/error-patterns确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

modules/
agent-damage-control.md
classification.md
recovery-strategies.md

详细介绍

原文在翻译后有更新，译文可能不是最新。

错误模式

概述

为插件提供标准化的错误处理模式，确保行为一致且达到生产级别。提供错误分类、恢复策略和调试工作流。

适用场景

  • 构建具有韧性的集成
  • 需要一致的错误处理
  • 希望实现优雅降级
  • 调试生产环境问题

不适用场景

  • 项目不采用 leyline 基础设施模式
  • 不需要服务架构的简单脚本

错误分类

按严重程度
级别操作示例
Critical停止运行，发出警报身份验证失败、服务宕机
Error重试或采用备用策略速率限制、超时
Warning记录日志，继续运行部分结果、弃用
Info仅记录日志非阻塞问题
按可恢复性
class ErrorCategory(Enum):
    TRANSIENT = "transient"  # Retry likely to succeed
    PERMANENT = "permanent"  # Retry won't help
    CONFIGURATION = "config"  # User action needed
    RESOURCE = "resource"  # Quota/limit issue

验证： 使用 --help 标志运行命令，以验证其是否可用。

快速入门

标准错误处理器
from leyline.error_patterns import handle_error, ErrorCategory

try:
    result = service.execute(prompt)
except RateLimitError as e:
    return handle_error(
        e, ErrorCategory.RESOURCE, {"retry_after": e.retry_after, "service": "gemini"}
    )
except AuthError as e:
    return handle_error(
        e, ErrorCategory.CONFIGURATION, {"action": "Run 'gemini auth login'"}
    )

验证： 使用 --help 标志运行命令，以验证其是否可用。

错误结果
@dataclass
class ErrorResult:
    category: ErrorCategory
    message: str
    recoverable: bool
    suggested_action: str
    metadata: dict

验证： 使用 --help 标志运行命令，以验证其是否可用。

常见模式

身份验证错误（401/403）
  • 验证凭据是否存在
  • 检查令牌是否过期
  • 验证权限/范围
  • 建议重新进行身份验证
速率限制错误（429）
  • 提取 retry-after 标头
  • 记录日志以跟踪配额
  • 实现退避机制
  • 考虑使用替代服务
超时错误
  • 增加重试时的超时时间
  • 将请求拆分为更小的请求
  • 使用异步模式
  • 考虑使用其他模型
上下文过大（400）
  • 在请求前估算令牌数
  • 拆分为多个请求
  • 减少输入内容
  • 使用上下文窗口更大的模型

集成模式

# In your skill's frontmatter
dependencies: [leyline:error-patterns]

验证： 使用 --help 标志运行命令，以验证其是否可用。

详细资源

  • 分类： 查看 modules/classification.md，了解错误分类体系
  • 恢复： 查看 modules/recovery-strategies.md，了解处理模式
  • Agent 损害控制： 查看 modules/agent-damage-control.md，了解多 Agent 错误恢复和升级处理

完成标准

  • 正确分类错误
  • 已尝试适当的恢复措施
  • 提供用户可采取行动的消息
  • 已记录错误以供调试

评论

支持 Markdown