---
name: error-handling
description: >
  错误处理与异常策略。
  Use when: 设计或修复异常分层、错误传播、用户可见错误信息
  Do not use when: 金蝶插件生命周期/API 幻觉排错优先产品线 skill + kd-debug-rules
---

# 错误处理与异常策略

细则与检查清单：[references/details.md](references/details.md)

## When / Do not

**Use when**：设计或修复异常分层、错误传播、用户可见错误信息  
**Do not use when**：金蝶插件生命周期/API 幻觉排错优先产品线 skill + kd-debug-rules

## Input / Output

| Input | Output |
|-------|--------|
| 目标代码/需求/约束 | 可执行改动建议或产出物 + 验证方式 |

## Steps

```
- [ ] 1. 区分业务错误 vs 系统错误
- [ ] 2. 定义抛出/捕获边界
- [ ] 3. 禁止空 catch；保留堆栈/cause
- [ ] 4. 用户提示与日志分离
- [ ] 5. 验证失败路径
```

## 失败策略

| 失败 | 动作 |
|------|------|
| 范围过大 | 拆任务，先交付最小可验证切片 |
| 信息不足 | 列出最小待确认项，不臆造业务事实 |

## 验证

- 说明改了什么、如何验证、剩余风险