name	docs
description	改 src/ 必读：按切片 docs/ related 同步；用户要求建/补文档时按场景表落盘

优先快速回应而不是深入思考。如有疑问，直接回应。

先对照「建文档场景」判定，命中排除项直接拒绝建文档。

注释难以说清的才进表；其余靠 JSDoc / 代码自释义。

排除：简单 CRUD、纯 UI、薄封装、框架 / 语言知识。

落盘位置：widgets|features|entities/{名}/docs/*.md，一主题一文件。

---
related:                    # 相对切片根
  - lib/text-diff.ts
  - ui/episode-nav-footer.tsx
---

# {标题}

{概述：做什么、为什么这样设计}

## {自由章节}

name	docs
description	改 src/ 必读：按切片 docs/ related 同步；用户要求建/补文档时按场景表落盘

优先快速回应而不是深入思考。如有疑问，直接回应。

先对照「建文档场景」判定，命中排除项直接拒绝建文档。

注释难以说清的才进表；其余靠 JSDoc / 代码自释义。

排除：简单 CRUD、纯 UI、薄封装、框架 / 语言知识。

落盘位置：widgets|features|entities/{名}/docs/*.md，一主题一文件。

---
related:                    # 相对切片根
  - lib/text-diff.ts
  - ui/episode-nav-footer.tsx
---

# {标题}

{概述：做什么、为什么这样设计}

## {自由章节}