SuperAPI AI 工具集

compose-ui

通用与其它

查看项目

更新于 10-16 00:22

技能介绍

Compose UI 是一套用于编写和评审 Compose 与 CMP 可组合项的技能,定位为资深移动端工程师视角下的架构规范。

用途:指导新增、修改或评审屏幕与可组合项时,如何组织 Route/Screen/叶子组件分层,如何放置状态读取,如何处理加载、空、错误与校验等 UX 状态,以及如何构建列表。

主要能力:提出“铁律”——状态读取会使最近的外层可组合作用域失效,因此过快重组应把读取下移到渲染它的叶子作用域,而不是用 remember 包裹。要求只有 Route 接触 ViewModel,Screen 无状态(状态进、回调出),叶子组件接收子状态与具体回调而非 onAction。要求时钟与动画驱动的值不得以格式化字符串进入 UiState,应携带 Instant 并在渲染时格式化。要求懒列表项使用来自领域身份与 contentType 的稳定键,而非索引。要求颜色只用主题 token,复用先查设计系统模块;刷新时不得清空已有内容;用户可见字符串须为各语言资源;分支面板依据收到的 size class,WindowInsets 每屏只应用一次。commonMain 不得导入 java.、android.、LocalContext 或 R。

使用方式:先按步骤确认变化的值及其频率,确定必须重执行的最小作用域,检查读取位置是否与作用域存在落差,检查进入该作用域的每个参数的稳定性,盘点设计系统模块组件与 token,从 ux-states.md 决策表中选择加载/空/错误/校验视觉,最后运行验证门。验证包括用 rg 检查 ViewModel 引用、硬编码颜色、键与 contentType、语言资源一致性,并确认模块在 common metadata 与一个平台编译通过、JVM 测试通过。另需按需加载 state-reads-and-stability.md、ux-states.md、lists.md、motion.md、shared-elements.md、accessibility.md、design-system.md、resources.md、images.md、modifiers.md、adaptive-and-insets.md、performance-diagnostics.md 等参考文件。评审功能 UI 改动时读 review-mode.md,改动 UI 行为时读 ui-testing.md。

适用场景:Compose 与 CMP 项目中的屏幕、目的地与切片的新增、变更或评审;重组性能与稳定性诊断;列表、主题、资源与无障碍规范落地。

限制:路由、状态分类与验证门的静默要求未在此展开;仓库、Ktor、Room、DataStore、Paging、离线优先应使用 compose-data 技能;commonMain 共享、expect/actual、iOS/Swift、桌面与 Web 应使用 compose-platform 技能;新项目或模块、约定插件、版本目录、CI 与守卫应使用 compose-project 技能;Navigation 3 机制与编译器报告内部细节属于可选深入内容。资料未提供收费、价格与平台支持信息。