Jetpack Compose 样式集成技能
将 Jetpack Compose Styles API 集成到 Android 项目，实现组件主题统一和布局参数迁移。
证据显示该技能基于官方文档，无恶意行为，操作限定于构建配置和文件创建，风险较低。但发布者身份未经验证，且缺少对第三方依赖的审计和回滚机制，因此扣分。
步骤清晰，但未提供自动化测试或执行验证，仅依赖文档和示例，异常输入的错误反馈不足，静态审阅限制可靠性的评分。
明确限定了实验性API和自定义组件场景，但未提供非适用范围的详细边界，且参考文档链接可能受网络限制，影响中国大陆用户的可达性。
文档结构完整，包含限制、前置条件和分步指南，但缺少版本历史、故障排查明确的维护责任，且发布者未验证。
核心任务（迁移到Styles）的步骤可合理完成，但输出直接可用性未经验证，且无对比基准证明其边际价值。
依赖官方文档，但未提供可独立复现的证据，静态审阅无法验证执行结果。
- 该技能基于实验性API，要求升级到alpha版本，可能导致生产环境不稳定。
- 参考文档链接可能从中国大陆无法访问，需注意网络可达性。
- 发布者身份未经验证，使用前请自行评估。
这个 Skill 能做什么，适合哪些场景？
该技能指导开发者将 Jetpack Compose 项目迁移到新的 Styles API。它涵盖了依赖升级、编译器配置、组件主题设置、自定义组件的可样式化改造，以及将硬编码的布局参数迁移为统一的 Style 属性。技能提供分步工作流，包括创建 ComponentStyles、迁移自定义组件和视觉回归验证。注意：此技能仍处于实验阶段，需要 Compose alpha 版本，仅支持自定义组件和主题，不支持 Material Design 组件样式。
读取项目的主题文件和组件代码，分析设计令牌和现有参数；指导升级 compileSdk 到 37+ 和 foundation 库到 1.12.0-alpha01+，并添加编译器 opt-in 标志；创建 ComponentStyles 数据类并在自定义主题中暴露；对每个自定义组件，移除单个样式参数、添加 style 参数、使用 Modifier.styleable 并管理交互状态；迁移后指导构建、截图测试和视觉对比验证。
- Android 开发者希望在自定义组件库中使用统一的 Style 定义，减少重复代码。
- 团队需要将现有 Compose 自定义按钮、文本框等组件迁移到 Styles API，以便集中管理主题。
- 设计系统维护者需要将颜色、排版、形状等设计令牌与组件样式关联。
- 开发者需要在不影响视觉结果的前提下，重构组件签名，移除冗余参数。
这个 Skill 有哪些优点和局限？
- 提供明确的逐步迁移流程，降低出错率
- 强调视觉基线验证，确保迁移后视觉一致
- 支持自定义主题和设计令牌的集成
- 由 Google 维护，文档参考官方指南
- 实验性 API，需要 Compose alpha 版本，可能不稳定
- 仅支持自定义组件，不支持 Material Design 组件样式
- 需要手动更新依赖和编译器选项，前置条件较多
- 无自动化测试，迁移后需手动检查截图
如何安装这个 Skill？
该技能是 Android skills 集合的一部分，使用 Android CLI 安装：运行 'android skills add --skill=styles --project=.' 将技能安装到当前项目，或使用 'android skills add --all' 安装全部技能。
如何使用这个 Skill？
在 agent 环境中，将技能目录添加到 agent 的 skills 路径，并用类似 '帮我用 Styles API 迁移我的自定义按钮' 的提示触发。技能会指导按步骤操作，包括升级依赖、配置编译器、创建 ComponentStyles、迁移组件并验证。