用途:当请求涉及 Android UI 的 state reducer、Compose 或 XML Android 状态管理、Android 屏幕中的一次性事件时使用。主要产出是为 Android UI 建模屏幕状态、事件、reducer 与副作用,并保持可预测、感知生命周期的状态持有。范围扩大时可移交 android-coroutines-flow、android-ui-states-validation 技能。
工作流:确认用户可见流程、目标设备行为和需关注的失败状态;识别流程的所属屏幕、Activity、目的地与状态持有者;以显式的加载、成功、空和错误处理实现流程;在示例应用中验证无障碍、配置变更与返回栈行为;将数据、架构或发布问题升级到交接说明中列出的专门技能。
防护准则:将加载、空、错误、离线与权限拒绝视为一等 UI 状态;不要在可复用 UI 组件内隐藏导航或权限副作用;优先使用感知生命周期的 API,而非手动回调链;保持深链、intent 与权限提示可测试、可观察。
反模式:认为仅需快乐路径即可满足产品流程;在多处硬编码请求码或路由字符串;从仓库或网络层直接触发导航;发布未提供权限拒绝或状态损坏恢复 UI 的流程。
修复示例片段:保持单一不可变 UI 状态面 TaskBoardState;用 MutableStateFlow 分离持久状态与一次性事件(MutableSharedFlow 事件);用 _uiState.update 归约状态更新而非直接改 UI。
示例命令:cd examples/orbittasks-compose && ./gradlew :app:testDebugUnitTest;cd examples/orbittasks-xml && ./gradlew :app:testDebugUnitTest;python3 scripts/eval_triggers.py --skill android-state-management。
完成清单包括实现路径明确、最小且绑定正确 Android 面;相关示例命令与基准提示已运行或更新;跨边界时记录相邻技能交接;官方参考覆盖所选模式及主要迁移或排障路径。官方参考提供了 Android 状态生产、事件、ViewModel 与 Compose state 的文档链接。