# Tech Debt

> 已知技术债清单。**不写细节**——每条只链 GitHub issue。

## High（影响开发体验或正确性）

- [ ] [#NNN](https://github.com/<owner>/<repo>/issues/NNN) — <债务描述>

## Medium（明显但可绕开）

- [ ] [#NNN](https://github.com/<owner>/<repo>/issues/NNN) — <债务描述>

## Low（小痛点，可忍）

- [ ] [#NNN](https://github.com/<owner>/<repo>/issues/NNN) — <债务描述>

## Already paid off

- ~~[#NNN](https://github.com/<owner>/<repo>/issues/NNN) — <已修描述>~~（v<X.Y> 修复）

## 添加新条目的规则

1. 必须有对应 GitHub issue
2. 标题一句话
3. 分类按"实际影响"
4. **禁止**写细节、修复方案、讨论

## 自动化补充

CI 自动生成 health.md 里的 TODO/FIXME 计数（代码级）。本文件管项目级。

---

> 此文件由 koala-core init 创建。Tier 1 部分自动 + Tier 3 人编。
