SuperAPI AI 工具集

j5ik2o-error-handling

编程与开发

查看项目

更新于 10-15 22:39

技能介绍

用途:在设计或评审跨领域逻辑、应用服务与基础设施的错误处理时,按“可恢复性”和“调用方责任”选择错误机制,避免异常被滥用为普通业务分支。

主要能力:

  1. 错误分类:将错误归为领域错误、校验错误、应用错误、基础设施错误、编程缺陷或致命系统条件。
  2. 机制选择:可恢复的领域与校验错误使用类型化 Result/Either 风格返回值;缺陷与调用方无法本地决策的真正异常基础设施故障使用异常或 panic。
  3. 上下文与安全:保留因果上下文,但不泄露敏感信息。
  4. 边界策略:重试、超时与熔断策略放在集成边界。

规则要点:语言支持时,领域错误应在函数签名中显式表达;不要用异常做普通业务分支;在负责处理或上报错误的边界只记录一次日志;在层边界把底层错误转换为面向应用的错误。

使用方式:技能正文给出工作流与规则;非平凡实现、评审或重构前,应先阅读 references/guidelines.md 获取详细模式,并阅读 references/details.md 获取详细规则、示例、坏味道与迁移说明,再给出最终建议。

输出:返回错误分类法、机制选择、API 变更与测试。

限制:资料未提供具体语言、框架、代码示例、安装命令或平台支持范围;实际落地需结合所用语言与项目约定。