SuperAPI AI 工具集

dsh-error-handling

设计与创作

查看项目

更新于 10-15 20:35

技能介绍

用途:在设计或审查系统失败、恢复、重试、后台任务以及用户可见错误报告时,应用统一的错误处理原则。核心是明确失败的定义、责任归属,以及失败后哪些状态仍然安全。

主要能力:强调类型化、结构化的失败——预期失败需声明类型、稳定的判别标识与处理相关信息,复用包内错误约定,保留原因,区分机器标识与展示文本,禁止依靠解析消息文本来决定处理方式。对每个失败,需在所属 API 文档中定义处理与报告责任方、隔离范围与保证,包括有效不变量、效果状态(不存在/部分/已提交/未知)与清理责任,后台工作同样承担这些义务。

使用方式:捕获只限制异常传播而非变更,只有受影响状态的所有者才能确立安全续行;否则应停止依赖工作、丢弃无效状态或实例,或升级处理。仅记录日志不算恢复;重试需满足可安全重复、可取消且有明确责任方,有限操作需预算,持续监督需生命周期归属与可观测的降级。最终报告需包含可读摘要、受影响操作与安全下一步,按接收应用的 locale 机制本地化,避免泄露敏感内部细节。未知结果与不可信状态须通过界面或默认开启的可访问日志可见,持久无效状态需持久可见,不得在无保证时声称成功、回滚或安全重试。

适用场景:适合在错误处理设计评审、后台任务与重试机制设计、用户可见错误报告设计时使用。

限制:资料未提供具体安装命令、代码示例、平台与收费信息。