Agent Skills › qufei1993/skills-hub › dsh-error-handling

dsh-error-handling

GitHub

用于实现或审查错误传播、重试、恢复及状态保证的 Skill。通过追踪入口、分类错误、明确责任方和验证副作用，确保失败行为可预测且符合项目约定。

skills/dsh-error-handling/SKILL.md qufei1993/skills-hub

实现或审查错误处理逻辑设计重试与恢复机制定义状态保证与失败反馈

npx skills add qufei1993/skills-hub --skill dsh-error-handling -g -y

更多选项

不安装直接使用

npx skills use qufei1993/skills-hub@dsh-error-handling

指定 Agent (Claude Code)

npx skills add qufei1993/skills-hub --skill dsh-error-handling -a claude-code -g -y

安装 repo 全部 skill

npx skills add qufei1993/skills-hub --all -g -y

预览 repo 内 skill

npx skills add qufei1993/skills-hub --list

Frontmatter

{
    "name": "dsh-error-handling",
    "description": "实现或审查错误传播、部分成功、结果未知、恢复、重试、取消或失败反馈时使用，明确状态保证和错误处理责任。"
}

明确失败行为及处理责任

阅读项目上下文、生命周期和验证证据。沿用项目现有的错误约定。

追踪操作的公开入口、状态负责方、外部副作用和最终报告。建立简短对应关系：触发条件 → 错误分类 → 状态保证 → 处理者 → 用户可见结果。区分响应失败与操作失败。
用稳定标识区分已知业务错误；保留意外错误的原因，不把所有异常都转成成功默认值或同一个通用业务错误码。
明确失败后状态属于未变化、部分完成、已提交还是结果未知。只有状态负责方能证明恢复和继续执行的前提；无法证明时停止依赖该状态的后续工作。写入结果不明确时，使用真实服务支持的核对或幂等机制，不能仅根据异常文字无条件重试。
确保取消、回调错误和清理失败到达适当的处理位置。避免重复报告；保留足够的处理线索，不泄露秘密。
通过真实调用方验证副作用发生前后的失败，包括“已经提交但响应丢失”。分别断言可观察状态和报告内容；支持恢复时，覆盖恢复成功和恢复失败。

完成时说明明确的状态保证、负责的处理者和实际测试的失败场景。服务行为约定不足以建立保证时，如实报告结果未知。