# 可维护性与测试策略检查清单

## 可维护性与设计边界

- 函数和类职责是否清晰，是否存在过长函数和隐式副作用。
- 命名是否表达意图，是否避免单字母变量和歧义缩写。
- 复杂分支是否可读，是否适合拆分为可测试单元。
- 新增公共接口是否有最小必要注释与类型提示。

## 接口演进与兼容性

- 公开 API 的输入输出契约是否清晰且保持兼容。
- 默认值、可选参数和异常语义是否与历史行为一致。
- 配置项、环境变量和开关语义是否明确，避免隐式破坏。

## 测试策略与回归防护

- 新增逻辑是否有对应单测，关键分支是否覆盖。
- 异常分支和失败路径是否有测试。
- 测试是否稳定且无随机失败风险。
- 关键回归场景是否具备最小可复现用例。