踩坑记录:【问题标题】

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

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

一、现象

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

二、根因

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

三、解决过程

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

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

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

五、是否已沉淀到规则

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

六、关联

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