mcpField
A
android-compose-foundations

android-compose-foundations

github.com/midudev设计与 UI7.0k62 次安装1 周前更新
代码仓库

关于 android-compose-foundations

面向 Android UI 开发者的 Jetpack Compose 基础技能,涵盖布局、Modifier、主题与组件结构,并强调无障碍、稳定状态和适配边界情况。

主要功能

  1. 01Compose 布局与 Modifier
  2. 02主题和可复用组件结构
  3. 03无障碍与响应式设计
  4. 04长文本及 RTL 验证

适用场景

  1. 01构建 Jetpack Compose 界面
  2. 02整理 Compose Modifier
  3. 03验证窄屏和动态文字布局

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/midudev/autoskills --skill android-compose-foundations

安装后在 Claude Code 中输入/android-compose-foundations确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
official-links.md
patterns.md
scenarios.md
scripts/
run_examples.sh

详细介绍

Android Compose 基础

适用场景

  • 在请求涉及以下内容时使用此技能:Jetpack Compose 屏幕、Android 中的 Compose 布局、Compose 修饰符清理。
  • 主要目标:使用 Jetpack Compose 基础、布局、修饰符、主题和稳定的组件结构构建 Android UI。
  • 范围扩展时移交给以下技能:
  • android-compose-state-effects
  • android-material3-design-system

工作流

  1. 确定目标界面使用的是 Compose、View 系统,还是混合互操作屏幕。
  2. 选择满足响应式、无障碍和性能需求的最低摩擦 UI 模式。
  3. 围绕稳定状态、明确的副作用和可复用的设计令牌构建 UI。
  4. 在测试应用中检查长文本、字体缩放、RTL 和窄屏设备等边界情况。
  5. 移交前通过单元测试、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