error-taxonomy 是一个错误分类与恢复策略设计技能,用于在使用方需要处理 API、子进程、安装器、解析器、服务提供方、网络或校验失败,并涉及重试、上报、分组或映射到恢复动作时提供指导。
主要能力与规则:
用途:把错误划分为可操作的类别,包括暂时性传输/容量问题、永久性输入/不支持操作、认证/授权、配置或依赖缺失、数据损坏、不变量违反和内部缺陷等,并据此决定恢复方式,而不是依赖通用兜底捕获。
结构化上下文:要求保留原始错误或退出码,并保留足够的结构化上下文以便诊断。
显式策略映射:每个错误类别应对应明确策略,例如重试、回退、修复、回滚、请求凭据或立即失败。
限制与禁止项:不应对语法错误、无效 API 参数或确定性不兼容进行重试;不应把所有超时都视为暂时性错误,因为子进程可能仍在运行;未知错误应保持未知,并在有证据支持归类前保守失败。
使用方式与适用场景:资料未提供具体安装命令、代码示例或调用步骤,暂未提供。该技能适合在设计错误处理、重试逻辑、故障分组与恢复映射流程时作为分类原则参考。