---
name: kd-no-overengineering
description: 反过度工程 - 禁止无意义封装、过度判空、假兜底、窄上下文乱改
alwaysApply: false
---

# 反过度工程

编码时遵守；与 `.kcode/RULES.md` 第 8～12 条一致。

## 禁止

- 仅为 1～2 行表达式抽取私有方法 / 局部函数（应内联）
- 调用方或类型系统已保证非空时，再写 `if (x == null)` / `?.` 层层兜底
- `catch` 后 `return null` / `return false` / 空集合假装成功
- 未读同类实现就新建「工具类 / Helper / 抽象层」
- 把「最小修改」当成借口：该对齐风格时却只改半截

## 允许

- 导出 API、≥3 处调用、类型守卫、非显然公式的命名封装
- 边界输入（外部 HTTP / 用户输入 / 反序列化）的显式校验
- 失败路径：平台日志 + 抛出或明确错误提示

## 写前

至少打开 1 个同目录或同基类实现，对齐风格后再改。