用途
本技能是一份 Compose 界面与交互陷阱索引，来源于一个生产环境的 Kotlin 与 Compose Multiplatform 应用，共整理出 32 个陷阱，每个陷阱对应 references/ 下的一个短文件（均少于 150 行）。每个文件给出可用的正确模式、Trap（该模式在实践中具体如何失败及原因），以及一个 Verifying it 小节，包含可对用户自己的代码树运行的验证命令。
主要能力
索引按主题组织，每个条目说明其主题以及应当触发查阅的症状。主要覆盖以下方面：
- 屏幕、导航与自适应布局：响应式门控应基于窗口自身宽高而非平台；导航标签注册漂移；类型安全导航图组织；折叠视差工具栏；全屏视频手势覆盖层；正在播放分页器避免反馈循环；分层视频背景分页器；桌面迷你播放器窗口；屏幕外壳与内容拆分；变体布局数学保留在变体内；空状态必须保留其导航；堆叠栏重复消费窗口内边距；浮动覆盖层预留自身条带。
- 组件与交互：懒加载列表拖拽重排；滑动操作列表行；选择模式状态持有器；可展开与链接化文本；懒滚动辅助工具集；自定义细媒体滑块；自定义模态底部弹窗家族；控件范围必须覆盖存储值；将形状作为形状编辑；进度指示器作为拖动条；作用域内 composable 遮蔽顶层同名 composable；设置值通过其标签往返；自隐藏子项无法隐藏其槽位；一次性效果应使用事件而非状态边沿。
使用方式
将即将编写的代码或正在排查的症状与索引条目匹配：每个条目命名其主题以及应触发查阅的症状。在提出代码或修复方案之前，使用 Read 工具阅读所有可能适用的文件。当验证命令中命名了源项目的路径时，替换为用户代码树中的等效路径。文件中若出现未在此列出的反引号陷阱名，则位于同级领域技能中，可通过 glob ../*/references/<name>.md 打开。
适用场景
适用于 Kotlin 与 Compose Multiplatform 开发中编写或调试界面代码时，例如：自适应布局在手机正确但在窄桌面窗口错误；新增标签或徽章只在一个界面出现；导航文件膨胀到数百行；视差头部滚动时抖动；全屏视频单击只在半屏生效；正在播放分页器滑动回弹或跳过曲目；桌面迷你播放器窗口拖动漂移；列表拖拽重排后行回弹；多选在重排后漂移到错误行；滑块范围不覆盖存储值导致拇指停在末端；底部弹窗突然关闭而非滑动；设置选项在某种语言下不生效等。
限制
资料未提供该技能的安装命令、收费方式、价格、平台支持范围或效果保证。部分条目描述在提供的资料中被截断，完整内容需查阅对应文件。