本技能收录了 35 个在 Kotlin 与 Compose Multiplatform 生产应用中实际遇到的视觉相关陷阱，每个陷阱对应 references/ 目录下的一个简短文件（均少于 150 行），内容结构统一：先给出可工作的实现模式，再列出具体的失败方式与原因，最后提供针对用户代码树的验证命令。
用途：当开发者需要编写或排查 Compose 界面中的主题、颜色、渐变、遮罩、动画、图片加载与特效等问题时，可以先根据症状或即将编写的代码，在索引中匹配相关条目，然后用 Read 工具阅读可能适用的文件，再提出代码或修复方案。
主要能力覆盖：
- 主题、颜色、渐变与遮罩：平滑遮罩渐变、任意角度线性渐变、从图片提取调色板并驱动主题、强制深色子树、语义颜色令牌的 CompositionLocal 管理、无封面物品的确定性占位图、倾斜溢出浏览卡片、基于图片的动态配色方案、调色板加载状态处理、共享基础组件中可选特效的开关、外壳背景与配色方案背景的区别、普通双胞胎共享几何而非材质、主题作用域外绘制的窗口装饰、扁平页面后的环境色调层。
- 效果、动画与图片：Material Symbols 图标系统、液态玻璃背景、微光骨架加载器、动画渐变边框环、提升标志而非动画、不要预动画自动画属性、绘制越界粒子修饰符、组合中的图片回退 URL 重试、文本画笔微光扫过。
使用方式：根据代码即将实现的功能或正在追踪的症状，在下方条目中查找对应主题与症状描述；阅读所有可能适用的文件（每个文件均较短）；对于验证命令中提到的源项目路径，替换为用户代码树中的等效路径。文件中若出现未列出的反引号陷阱名称，则位于同级技能区域，可通过 glob ../*/references/<name>.md 打开。
适用场景：适用于 Compose Multiplatform 应用开发中的界面视觉调试与优化，特别是主题适配、渐变渲染、图片加载、加载占位、动画效果等常见问题。
限制：技能内容以英文编写，需具备 Kotlin 与 Compose 基础；每个陷阱文件均较短，可能不覆盖所有边缘情况；验证命令需根据用户项目结构调整路径；部分效果依赖第三方库（如 backdrop 库），具体依赖信息暂未提供。