SuperAPI AI 工具集

error-handling

编程与开发

查看项目

更新于 10-15 22:39

技能介绍

用途:在设计或评审错误处理时,按“可恢复性”和“调用方责任”选择错误机制,覆盖领域逻辑、应用服务与基础设施三层。

工作流程:先将每个错误归类为领域错误、校验错误、应用错误、基础设施错误、编程缺陷或致命系统状况;可恢复的领域与校验错误使用 Result/Either 风格的显式返回值;缺陷与调用方无法本地决策的真正异常基础设施故障使用异常或 panic;保留因果上下文但不得泄露敏感信息;重试、超时与熔断策略放在集成边界。

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

使用方式:详细模式见 references/guidelines.md;非平凡的实现、评审或重构工作,应在给出最终建议前阅读 references/details.md,其中包含详细规则、示例、坏味道与迁移说明。

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

限制:资料未提供具体语言、框架、代码示例及适用平台信息,需结合项目实际判断。