# 踩坑记录:【问题标题】

> 文件位置:`docs/06-standards/lessons-learned.md`(按日期追加)。目的:知识沉淀,避免重复踩坑;值得长期遵守的经验可进一步反哺 claude-rules 规则文件。

| 字段 | 值 |
|---|---|
| 日期 | YYYY-MM-DD |
| 来源场景 | 项目 / 功能 / 会话描述 |

## 一、现象

- 遇到的问题(报错信息/异常行为):

## 二、根因

- 为什么会出现(根本原因,不是表面现象):

## 三、解决过程

- 排查步骤与最终解决方式:

## 四、经验总结(可复用要点)

- 以后遇到同类问题的处理方式:

## 五、是否已沉淀到规则

- [ ] 已写入 claude-rules 规则(注明哪条)
- [ ] 已写入项目 docs 规范
- [ ] 暂不需要,记录即可

## 六、关联

- 相关修改留痕:
- 相关代码/文件: