SuperAPI AI 工具集

error-handling-design-review

设计与创作

查看项目

更新于 10-16 06:50

技能介绍

用途:在实现前评审错误处理设计,覆盖错误分类、异常边界、超时、重试/退避、熔断、降级、幂等性、事务一致性、传播、消费方契约、遥测与恢复。适用于错误处理尚不完整、需要一次有边界首轮评审的场景,用于区分预期行为、传播、重试条件与人工介入路径,并检查错误消息/状态、数据一致性、遥测、恢复与消费方契约。

主要能力:产出 EH-## 失败模式发现,每条包含失败模式、触发条件、边界、预期行为、传播/转换、重试/回退、数据一致性、可观测证据、负责人与验证方式;区分可重试、不可重试、需人工介入与安全拒绝路径;区分事实、有证据的推断、建议与人工决策。

使用方式:先阅读 prompts/error-handling-design-review.md,审计目标、失败边界、版本、来源与证据;将输入分类为已知、缺失、冲突、过期、超范围与假设;构建失败模式矩阵;交付有边界首轮评审与最小验证动作。默认输出 Markdown,若要求表格、CSV 或 JSON,需保留同样的证据、状态、影响、负责人与验证字段。回归时阅读 evals/eval.yaml 及其用例;触发检查使用 evals/trigger-prompts.csv 与 evals/local-rules.json,缺少选择轨迹视为 BLOCKED。

限制:不执行故障注入,不声称已验证真实事故、恢复、SLA 或错误率;不将异常类、状态码、错误处理代码或文档存在视为行为正确;不替人工选择 SLA、文案或风险接受;缺少身份、时间、环境、输入与原始结果时,运行时状态保持未验证、未执行或未评估。常见误区是用一个通用错误响应覆盖超时、依赖、数据冲突与授权失败,或在未检查幂等、退避、预算与重复副作用时决定重试次数。