关于 android-compose-foundations
为 Android 开发者提供 Jetpack Compose 基础指导，涵盖布局、修饰符、主题和组件组织。强调稳定状态、可访问性及适配边界情况，并在涉及状态或 Material 3 时交接给相关技能。
主要功能
- 01选择 Compose、View 或混合界面方案
- 02构建布局、修饰符与主题
- 03采用可复用设计令牌和组件
- 04检查可访问性与性能
- 05验证长文本、字体缩放和窄屏
适用场景
- 01实现 Android Compose 屏幕
- 02整理 Compose 布局和 Modifier
- 03检查 RTL 与动态文本表现
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/android-compose-foundations确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/official-links.mdpatterns.mdscenarios.mdscripts/run_examples.sh详细介绍
Android Compose 基础
适用场景
- 在请求涉及以下内容时使用此技能：Jetpack Compose 屏幕、Android 中的 Compose 布局、Compose 修饰符清理。
- 主要目标：使用 Jetpack Compose 基础、布局、修饰符、主题和稳定的组件结构构建 Android UI。
- 范围扩展时移交给以下技能：
android-compose-state-effectsandroid-material3-design-system
工作流
- 确定目标界面使用的是 Compose、View 系统，还是混合互操作屏幕。
- 选择满足响应式、无障碍和性能需求的最低摩擦 UI 模式。
- 围绕稳定状态、明确的副作用和可复用的设计令牌构建 UI。
- 在测试应用中检查长文本、字体缩放、RTL 和窄屏设备等边界情况。
- 移交前通过单元测试、UI 测试和适合截图的检查进行验证。
防护措施
- 在添加动画或抽象之前，优先确保状态稳定且渲染可预测。
- 默认遵循无障碍语义、对比度、焦点顺序和触控目标指南。
- 除非明确划定互操作边界，否则不要混合由 Compose 和 View 系统负责的内容。
- 优先进行有测量依据的性能优化，避免过早进行微优化。
反模式
- 在叶子 UI 组件中嵌入导航或业务逻辑。
- 使用会因本地化或动态文本而出问题的固定尺寸。
- 忽略语义，只播报视觉变化。
- 不调整思维模型，直接将 XML 模式移植到 Compose。
示例
顺利完成
- 场景：使用稳定的插槽和主题令牌优化 Compose OrbitTasks 看板。
- 命令：
cd examples/orbittasks-compose && ./gradlew :app:testDebugUnitTest
边界情况
- 场景：确保预览和布局行为在窄屏宽度和长文本下保持稳定。
- 命令：
cd examples/orbittasks-compose && ./gradlew :app:assembleDebug
故障恢复
- 场景：避免一般 Compose 请求偏离到状态/副作用或性能优化工作。
- 命令：
python3 scripts/eval_triggers.py --skill android-compose-foundations
完成检查清单
- 实现路径明确、精简，并针对正确的 Android 界面。
- 已运行或更新相关示例命令和基准测试提示词。
- 请求涉及相邻技能时，已记录技能移交情况。
- 官方参考资料涵盖所选模式以及主要的迁移或故障排查路径。
官方参考资料
评论
支持 Markdown