Agent Skills
› skydoves/compose-performance-skills
skydoves/compose-performance-skills
GitHubJetpack Compose性能审计编排技能，通过测量、诊断、修复、验证四阶段循环，协调25个专注技能进行端到端性能审查并生成报告。
安装全部 Skills
npx skills add skydoves/compose-performance-skills --all -g -y
集合内 Skills (25)
Jetpack Compose性能审计编排技能，通过测量、诊断、修复、验证四阶段循环，协调25个专注技能进行端到端性能审查并生成报告。
应用整体感觉卡顿
启动性能冲刺
请求全面性能审计或评审
无具体症状需排查方向
npx skills add skydoves/compose-performance-skills --skill auditing-compose-performance -g -y
指导AI代理通过MCP协议驱动Compose HotSwan进行Kotlin文件编辑、热重载、截图验证及迭代优化，实现无需人工介入的UI自动化调试与调优流程。
用户希望AI自动调整UI以匹配设计稿
询问AI能否查看设备屏幕变化或截图
配置Claude Code/Cursor工作流以访问HotSwan MCP工具
npx skills add skydoves/compose-performance-skills --skill iterating-with-ai-and-mcp -g -y
指导开发者在Jetpack Compose HotSwan热重载中保持状态，通过理解三个层级选择合适编辑和状态持有者，避免滚动位置、对话框等UI状态丢失。
热重载后滚动位置重置或对话框状态丢失
询问HotSwan重载层级及状态保留机制
npx skills add skydoves/compose-performance-skills --skill preserving-state-across-reloads -g -y
指导开发者在 Android Studio 中从零配置 Compose HotSwan，包括安装 IDE 插件、配置 Gradle 编译器插件及 DSL，并在真机或模拟器上验证秒级热重载功能。
用户询问如何设置 Compose HotSwan
需要实现 Compose 即时 UI 更新或快速迭代
已安装插件但需配置 Gradle 编译器插件
团队新项目接入 HotSwan
npx skills add skydoves/compose-performance-skills --skill setting-up-compose-hotswan -g -y
解析 Android Compose HotSwan 热重载限制，区分可热更新与需全量重建的 Kotlin/Compose 变更场景。指导开发者规避 ART 类结构变更陷阱，优化迭代效率，适用于排查构建失败或重构风险评估。
询问为何触发全量重建
排查热重载失效原因
评估重构对热重载的影响
学习 HotSwan 支持边界
npx skills add skydoves/compose-performance-skills --skill understanding-hot-reload-limits -g -y
配置 Jetpack Compose 懒加载预取策略，通过调整缓存窗口和暂停式组合优化高滚动速度下的帧率，解决掉帧问题。
开发者提到掉帧、预取窗口或 LazyLayoutCacheWindow
需要优化嵌套懒布局的预取性能
npx skills add skydoves/compose-performance-skills --skill configuring-lazy-prefetch -g -y
解决Jetpack Compose中Lazy布局的滚动卡顿、状态丢失及动画失效问题。指导配置稳定key、contentType，优化animateItem()使用，提升列表性能与稳定性。
LazyColumn/Row滚动卡顿或掉帧
列表项在增删改时丢失滚动位置或状态
混合类型Feed滑动迟缓
animateItem()动画未生效
编译器报告Item不稳定性导致重绘
npx skills add skydoves/compose-performance-skills --skill optimizing-lazy-layouts -g -y
生成和测量Jetpack Compose基线配置文件，通过Macrobenchmark验证冷启动及首屏滚动性能优化效果。
用户提到“baseline profile”或“macrobenchmark”
需要解决冷启动缓慢或首屏卡顿问题
发布前需进行性能基准测试
npx skills add skydoves/compose-performance-skills --skill generating-baseline-profiles -g -y
指导开发者在发布模式下测试 Jetpack Compose 性能，确保数据真实反映生产环境。涵盖设置带符号的构建、配置 Macrobenchmark 及编译器报告，解决调试模式下的性能误导问题。
报告启动慢或卡顿等性能问题
需要验证基准测试数据的真实性
准备提交性能回归报告或 PR
npx skills add skydoves/compose-performance-skills --skill testing-compose-in-release-mode -g -y
在 Jetpack Compose 中使用 @TraceRecomposition 进行运行时重组追踪，支持发布模式下的性能诊断与稳定性验证。
trace recomposition
compose-stability-analyzer
recomposition logcat
release-mode recomposition counts
npx skills add skydoves/compose-performance-skills --skill tracing-recompositions-at-runtime -g -y
指导将 Jetpack Compose 自定义修饰符从 Modifier.composed 迁移至高性能的 Modifier.Node，涵盖节点生命周期、专用接口及手动失效机制。
代码中出现 Modifier.composed
需要创建高性能自定义修饰符
处理节点生命周期或性能优化
npx skills add skydoves/compose-performance-skills --skill migrating-to-modifier-node -g -y
用于诊断和修复 Jetpack Compose 中 Modifier 链顺序错误导致的 UI 问题，如背景绘制区域错位、点击范围异常及裁剪失效。指导开发者正确理解修饰符嵌套逻辑并调整顺序。
询问为什么点击区域超出可见按钮
询问为什么背景绘制在错误位置
代码审查中发现 Modifier 顺序不当
探讨是否应缓存 Modifier 链
npx skills add skydoves/compose-performance-skills --skill ordering-modifier-chains -g -y
解决 Jetpack Compose 中 SubcomposeLayout、BoxWithConstraints 等导致额外测量和重复组合的性能问题，提供检测、替换及优化方案。
报告首帧慢或布局传递过多
提到 BoxWithConstraints 或 SubcomposeLayout
滚动卡顿疑似由嵌套引起
npx skills add skydoves/compose-performance-skills --skill avoiding-subcomposition-pitfalls -g -y
指导在 Jetpack Compose 中何时使用 derivedStateOf 以优化重组性能，涵盖高频输入转低频输出的场景、必须包裹 remember 的规则及避免捕获非状态变量的陷阱。
询问是否应使用 derivedStateOf
滚动位置驱动布尔值或阈值检查
derivedStateOf 未降低重组次数
处理高频动画或拖拽输入
npx skills add skydoves/compose-performance-skills --skill choosing-derivedstateof -g -y
用于诊断Jetpack Compose重组问题，通过Layout Inspector和TraceRecomposition工具定位触发重组的组件及参数原因。
开发者询问为何组件未跳过重组
需要查看重组计数以验证修复效果
解释Inspector中的参数变化原因
确认发布构建中稳定性修复是否生效
npx skills add skydoves/compose-performance-skills --skill debugging-recompositions -g -y
优化Jetpack Compose性能，将高频状态读取从Composition阶段延迟至Layout或Draw阶段，解决滚动和动画导致的过度重组问题。
动画或滚动导致每一帧触发重组
出现滚动卡顿或掉帧现象
状态值在Modifier中直接读取引发全子树重组
npx skills add skydoves/compose-performance-skills --skill deferring-state-reads -g -y
指导在Kotlin 2.0.20+中正确使用Jetpack Compose的强跳过模式，涵盖自动remember、跳过逻辑验证及@DontMemoize等逃逸机制，解决不必要的重组和Lambda分配问题。
询问是否仍需使用@Stable注解
Composable函数未按预期跳过重组
从旧版Compose迁移至Kotlin 2.0.20+
排查Lambda每轮重组时的内存分配问题
npx skills add skydoves/compose-performance-skills --skill using-strong-skipping-correctly -g -y
指导在 Jetpack Compose 中安全收集 Flow，将 collectAsState 迁移至 lifecycle-aware 版本以节省电量，优化高频流并解决反模式。
涉及 collectAsState 或 collectAsStateWithLifecycle 的迁移
报告后台电池消耗或唤醒锁问题
Composable 接收 Flow 参数
需要处理传感器、位置等高频数据流
npx skills add skydoves/compose-performance-skills --skill collecting-flows-safely -g -y
指导在Jetpack Compose中选择最合适的Effect API（如LaunchedEffect、DisposableEffect等），避免内存泄漏和性能浪费，提供决策树以处理副作用、状态同步及ViewModel作用域问题。
询问Compose Effect API选择
调试LaunchedEffect意外重启
处理Listener泄漏或清理逻辑
LazyColumn中为每行创建独立ViewModel
npx skills add skydoves/compose-performance-skills --skill using-efficient-effects -g -y
通过读取 Jetpack Compose 编译器报告（classes.txt等）诊断重组稳定性问题，识别不稳定参数和非可跳过组件。适用于卡顿、帧率下降或怀疑参数不稳定的场景。
询问为何发生重组
报告界面卡顿或掉帧
提及 Compose Compiler Reports 或 classes.txt
排查非可跳过的组件
npx skills add skydoves/compose-performance-skills --skill diagnosing-compose-stability -g -y
在 CI 中配置 Compose 稳定性检查，通过基线比对自动拦截性能回归。支持 Gradle 插件集成与 GitHub Actions 流水线，确保 UI 渲染稳定性。
CI 构建失败需排查稳定性问题
需要为 Compose 项目设置稳定性 SLO
用户提及 stabilityCheck 或稳定性回归
npx skills add skydoves/compose-performance-skills --skill enforcing-stability-in-ci -g -y
用于修复Jetpack Compose中不稳定的类型，通过结构重写、添加注解或配置稳定文件三种层级策略解决重组问题。
编译器报告显示不稳定参数
询问如何稳定User类或List参数
提及@Immutable或@Stable等注解
npx skills add skydoves/compose-performance-skills --skill stabilizing-compose-types -g -y
解释 Compose 编译器稳定性推断结果，基于12阶段算法分析类型为何被标记为稳定、运行时、未知或不稳定。适用于排查泛型、跨模块或复杂继承导致的意外分类。
开发者询问特定类或参数的稳定性分类原因
稳定性报告出现意外的 runtime stable/unknown/unstable 判定
涉及泛型、循环引用、接口或跨模块类的稳定性问题
npx skills add skydoves/compose-performance-skills --skill understanding-stability-inference -g -y
指导开发者在IDE中安装和配置Compose稳定性分析插件，实现编辑时实时反馈，包括解读颜色标记、内联提示及快速修复。
询问编辑器中的稳定性 gutter 图标或内联提示
查询 UnstableComposable 警告原因
需要 IDE 实时 Compose 稳定性反馈
npx skills add skydoves/compose-performance-skills --skill using-stability-analyzer-ide-plugin -g -y
用于分析Jetpack Compose重组级联和热图的IDE技能，通过静态调用图和运行时Logcat数据评估状态变更影响范围及重组性能。
询问组件变更的重组影响范围
查询滚动或动画期间的重组次数
提及重组级联可视化或热图功能
npx skills add skydoves/compose-performance-skills --skill visualizing-recomposition-cascades -g -y
