Agent Skills
› skydoves/compose-performance-skills
skydoves/compose-performance-skills
GitHubJetpack Compose性能审计编排技能，通过测量、诊断、修复、验证四阶段循环，协调25个专项技能进行端到端性能评估，生成包含基准对比的审计报告。
Install All Skills
npx skills add skydoves/compose-performance-skills --all -g -y
Skills in Collection (25)
Jetpack Compose性能审计编排技能，通过测量、诊断、修复、验证四阶段循环，协调25个专项技能进行端到端性能评估，生成包含基准对比的审计报告。
应用整体卡顿或滚动粗糙
启动性能优化冲刺
需要预发布性能门禁
新手进入性能问题代码库
npx skills add skydoves/compose-performance-skills --skill auditing-compose-performance -g -y
指导AI代理通过MCP工具驱动Compose HotSwan实现Kotlin文件编辑、热重载、截图及UI迭代，无需人工干预。适用于让AI自动调整界面以匹配设计稿的场景。
让AI自动调整UI直到匹配设计稿
询问AI能否看到变化或截图设备
设置Claude Code或Cursor的MCP工作流
npx skills add skydoves/compose-performance-skills --skill iterating-with-ai-and-mcp -g -y
指导开发者在Jetpack Compose中使用HotSwan热重载时，理解并维持状态存活。通过区分三个重载层级，选择合适状态持有者，避免滚动位置丢失或重组重置等问题，优化开发迭代体验。
热重载后滚动位置跳转或对话框状态丢失
询问为何重载升级至Tier 2或3
计划重构组件需确认作用域影响
npx skills add skydoves/compose-performance-skills --skill preserving-state-across-reloads -g -y
指导开发者在Android项目中从零配置Compose HotSwan，包括IDE插件安装、Gradle编译器插件集成及调试验证，实现亚秒级热重载。
询问如何启用JetBrains IDE的HotSwan热重载功能
需要配置Gradle插件以支持Compose即时UI更新
遇到HotSwan工具窗口状态异常或首次保存未触发重载
npx skills add skydoves/compose-performance-skills --skill setting-up-compose-hotswan -g -y
指导开发者理解Compose HotSwan热重载的限制边界，区分仅方法体重载与需全量重建的类结构变更，帮助维持快速迭代并避免意外触发完整构建。
询问为何触发全量重建或热重载失效
评估重构操作对热重载会话的影响
学习HotSwan支持范围以规划编辑顺序
npx skills add skydoves/compose-performance-skills --skill understanding-hot-reload-limits -g -y
针对Jetpack Compose懒加载布局，通过配置缓存窗口和暂停式组合优化高滚动速度下的帧率，解决掉帧问题。
高滚动速度下出现掉帧
提及 LazyLayoutCacheWindow 或 NestedPrefetchScope
需要调整预取范围以保留短暂滑过的项
npx skills add skydoves/compose-performance-skills --skill configuring-lazy-prefetch -g -y
解决 Jetpack Compose LazyLayouts 滚动卡顿、状态丢失及动画失效问题。通过稳定 Key、contentType 和 animateItem 优化，提升列表性能与流畅度。
LazyColumn/Row 滚动卡顿或掉帧
列表项在增删改时丢失滚动状态
animateItem() 动画不生效
混合类型 Feed 滑动迟缓
npx skills add skydoves/compose-performance-skills --skill optimizing-lazy-layouts -g -y
用于生成和测量 Jetpack Compose 基线配置文件，通过 AOT 预编译优化冷启动速度和首屏滚动流畅度。涵盖配置 Macrobenchmark、编写测试规则及验证性能指标。
用户提到 baseline profile, macrobenchmark, slow cold startup, first-scroll jank, TTFD 等关键词
需要优化 Compose UI 应用启动性能或首屏渲染体验
准备发布版本前的性能基准测试
npx skills add skydoves/compose-performance-skills --skill generating-baseline-profiles -g -y
指导在 Android Jetpack Compose 性能测试中，如何配置启用 R8 的 Release 构建以获取真实数据。解决 Debug 模式因解释执行和 Live Literals 导致的性能误判，涵盖 Macrobenchmark 等工具的正确使用场景。
报告启动慢、掉帧或高重组次数
引用 assembleDebug 等 Debug 构建的性能数据
审查性能 Bug 或设置 CI 性能门禁
准备提交性能回归报告
npx skills add skydoves/compose-performance-skills --skill testing-compose-in-release-mode -g -y
在Jetpack Compose中使用@TraceRecomposition追踪运行时重组差异，支持发布模式调试并生成logcat日志与热力图。
trace recomposition
compose-stability-analyzer
recomposition logcat
recomposition heatmap
npx skills add skydoves/compose-performance-skills --skill tracing-recompositions-at-runtime -g -y
指导将 Jetpack Compose 自定义修饰符从 Modifier.composed 迁移至高性能的 Modifier.Node，涵盖节点生命周期、专用接口实现及手动失效控制。
代码中包含 Modifier.composed
需要从零编写自定义修饰符
代码审查发现 Modifier.composed
涉及节点生命周期或 CompositionLocal 读取
npx skills add skydoves/compose-performance-skills --skill migrating-to-modifier-node -g -y
诊断并修复 Jetpack Compose 中 Modifier 链顺序错误导致的 UI bug，如背景绘制区域、点击范围及裁剪异常。指导正确排序以符合包裹模型，并澄清缓存 Modifier 的性能误区。
询问为什么点击区域超出可见按钮
背景被绘制在错误的位置
代码审查中发现 Modifier 顺序不当
询问 Modifier 顺序是否重要
npx skills add skydoves/compose-performance-skills --skill ordering-modifier-chains -g -y
解决Jetpack Compose中SubcomposeLayout、BoxWithConstraints等组件导致的重复测量和首帧卡顿问题，提供性能优化与正确用法指导。
报告额外测量次数或首帧缓慢
提到BoxWithConstraints或SubcomposeLayout
嵌套Scaffold导致性能下降
npx skills add skydoves/compose-performance-skills --skill avoiding-subcomposition-pitfalls -g -y
指导在Jetpack Compose中判断何时使用derivedStateOf以过滤高频输入、降低重组开销，涵盖频率对比规则、remember包裹必要性及变量捕获陷阱修复。
询问是否应使用derivedStateOf
滚动位置驱动UI状态更新
重组计数未下降或值不更新
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阶段，避免不必要的重组。适用于解决滚动卡顿、动画掉帧及每帧全树重组问题。
开发者提到滚动卡顿、动画掉帧或每帧工作
状态值在Composition中直接读取导致子树重组
npx skills add skydoves/compose-performance-skills --skill deferring-state-reads -g -y
针对 Kotlin 2.0.20+ Compose 强跳过模式，指导开发者理解自动 remember、跳过机制及逃逸方案。用于排查意外重组、迁移版本或优化 Lambda 捕获性能。
询问是否仍需 @Stable
组件仍频繁重组
Lambda 分配疑问
从旧版 Compose 迁移
遇到 @DontMemoize 等注解
npx skills add skydoves/compose-performance-skills --skill using-strong-skipping-correctly -g -y
将 Compose UI 中的 collectAsState 迁移至生命周期感知的 collectAsStateWithLifecycle，优化 Flow 参数传递及防抖策略，解决后台耗电与无效重组问题。
提及 collectAsState 或 collectAsStateWithLifecycle
报告应用后台运行时电池消耗异常
Composable 函数接收 Flow<T> 作为参数
需要处理高频传感器或位置数据流
npx skills add skydoves/compose-performance-skills --skill collecting-flows-safely -g -y
提供Jetpack Compose中Effect API的选择指南，帮助开发者根据场景选用LaunchedEffect、DisposableEffect等最合适的API，避免资源浪费和状态泄漏。
选择Compose Effect API
调试LaunchedEffect意外重启
处理Listener泄漏或清理
LazyColumn行级ViewModel管理
npx skills add skydoves/compose-performance-skills --skill using-efficient-effects -g -y
诊断 Jetpack Compose 稳定性问题。通过启用并分析 Compose Compiler Reports（如 classes.txt），识别导致过度重组的不稳定参数和非可跳过的组件，定位卡顿、掉帧等性能问题的根源。
询问为何发生重组或报告卡顿、掉帧
提及 Compose Compiler Reports 或具体报告文件
需要查找不稳定参数或评估类型稳定性
npx skills add skydoves/compose-performance-skills --skill diagnosing-compose-stability -g -y
在CI中集成Compose稳定性分析插件，通过对比基线自动拦截稳定性回归，防止UI卡顿问题引入生产环境。
需要建立稳定性SLO并强制在CI中执行
迁移至强跳过模式或修复静默稳定性退化
用户提及stabilityCheck、baseline drift或ComposeGuard
npx skills add skydoves/compose-performance-skills --skill enforcing-stability-in-ci -g -y
修复 Jetpack Compose 不稳定类型。提供三层策略：重构为不可变、使用注解或配置外部类型，解决编译警告和无效重组。
编译器报告参数不稳定
询问如何稳定 User 类或 List 参数
提及 @Immutable 或 stabilityConfigurationFiles
npx skills add skydoves/compose-performance-skills --skill stabilizing-compose-types -g -y
解释 Compose 编译器稳定性推断机制，基于12阶段算法分析类型为何被判定为稳定、运行时稳定或未知。适用于排查泛型、跨模块及复杂继承场景下的稳定性分类疑问。
询问特定类或参数为何被归类为稳定/不稳定
分析报告显示意外的运行时稳定或未知结果
涉及泛型、继承、循环引用或跨模块类的稳定性问题
提及 $stable 字段或 @StabilityInferred 注解
npx skills add skydoves/compose-performance-skills --skill understanding-stability-inference -g -y
用于在IDE中实时分析Jetpack Compose组件稳定性，提供编辑器内反馈、颜色标记及快速修复建议。
需要实时Compose稳定性反馈
询问编辑器中标记的UnstableComposable警告
查看行内提示或 gutter 图标
npx skills add skydoves/compose-performance-skills --skill using-stability-analyzer-ide-plugin -g -y
用于分析Jetpack Compose重组级联和实时热力图，辅助排查性能瓶颈与重构影响范围。
询问组件变更的重组影响范围
查询滚动或动画期间的重组频率
提及Cascade或Heatmap标签页
执行Analyze Recomposition Cascade操作
npx skills add skydoves/compose-performance-skills --skill visualizing-recomposition-cascades -g -y
