compose-multiplatform-patterns

compose-multiplatform-patterns 技能概览

什么是 compose-multiplatform-patterns

compose-multiplatform-patterns 技能是一份面向实战的指南，帮助你在 KMP 应用中使用 Compose Multiplatform 和 Jetpack Compose 构建 UI。它聚焦的是最容易拖慢团队进度的那些决策：状态怎么组织、导航怎么串起来、如何安全地在多个平台之间共享 UI，以及怎样让 Compose 代码随着应用规模增长仍然保持可维护。

它最适合谁

当你要为 Android、iOS、Desktop 或 Web 交付共享 UI，并且希望用成熟模式减少返工时，可以把 compose-multiplatform-patterns 用在 Frontend Development 上。它最适合已经掌握 Compose 基础、但需要更清晰落地路径的开发者，尤其是面对真实页面、共享设计系统和平台特有边界情况时。

它解决什么问题

这个技能能帮你把“用 Compose Multiplatform 把这个页面做出来”这样的模糊目标，转成一套合理的 UI 架构。通常这意味着：选择合适的状态模型、决定业务逻辑放在哪一层、避免重组问题，以及在不强迫每个平台长得一模一样的前提下保持代码可复用。

如何使用 compose-multiplatform-patterns 技能

安装并定位这个技能

先按目录里的标准技能流程安装 compose-multiplatform-patterns，然后在开始写代码前先打开技能文件。建议先从 SKILL.md 看起，并优先检查任何相邻或关联的说明；在这个 repo 里，这个技能本身就是自包含的，所以真正的价值主要来自阅读这些模式示例，并把它们适配到你的应用结构里，而不是指望还有额外的辅助文件。

给这个技能一个具体的 UI 目标

当你的提示词明确写出页面、平台目标和约束时，compose-multiplatform-patterns usage 的效果最好。比如，不要只说“帮我处理 Compose”，而是直接要求“一个在 Compose Multiplatform 中共享的商品列表页，需要 loading、empty 和 error 状态，并且 iOS 和 desktop 要有不同的 padding”。这样技能就能获得足够上下文，给出合适的状态结构和 composable 边界建议。

先读会影响架构的部分

在真正实现之前，先重点看关于何时触发、状态管理、导航、主题和性能的章节。这些内容会直接改变设计决策。如果你是在现有代码库里采用 compose-multiplatform-patterns guide，先把它的模式和你当前的 ViewModel、状态容器、导航方案对照一下，再去照搬示例。

要求结构，不只是代码

除了实现，也要让它给出方案。一个更强的提示词可以同时要求：页面状态模型、ViewModel 职责、composable 层级、事件处理方式，以及任何 Compose 特有的取舍。这样通常比只要一个单独的 composable 更有用，因为这个技能本来就是围绕模式设计的，不是只给零散片段。

compose-multiplatform-patterns 技能 FAQ

compose-multiplatform-patterns 只适用于 KMP 吗？

不是。它的重点确实是 Kotlin Multiplatform，但这些模式同样适用于需要更好状态处理、可复用 composable 或更清晰页面架构的 Jetpack Compose 应用。如果你的项目只做 Android，它仍然可能有帮助，只是最大的价值还是体现在共享 UI 上。

它比普通提示词更好吗？

通常是的，前提是你需要稳定一致的架构。普通提示词可能给你一段一次性可用的代码，而 compose-multiplatform-patterns 更适合你想要一套可重复使用的方法来处理状态、导航和平台差异的时候。如果你只需要一个临时性的 composable，普通提示词也许就够了。

什么时候不该用它？

如果你的任务主要是后端、领域逻辑，或者只是一个不涉及共享 UI 的简单静态布局，就不要直接用 compose-multiplatform-patterns install。如果你想从零搭一个有主张的设计系统，但还没有确定平台目标或状态策略，它也不是最合适的选择。

它适合新手吗？

适合，只要你能清楚描述自己想做的页面。新手最容易从中获得价值的方式，是一次只问一个页面，并把需要的 UI 状态写完整。这个技能更强调从一开始就用干净的模式，而不是死记 Compose API。

如何改进 compose-multiplatform-patterns 技能

补齐这个技能缺少的输入

想明显提升结果质量，关键是把状态、事件和平台约束说清楚。告诉它哪些数据会变化、用户有哪些操作，以及 Android、iOS、Desktop 或 Web 上哪些部分必须不同。对 compose-multiplatform-patterns 来说，这类上下文通常比视觉设计本身更重要。

明确要求代码边界

如果你想要更好的输出，可以直接要求它给出方案形态：UiState、UiEvent、ViewModel flow、composable 树，以及导航该放在哪里。这样可以减少 composable 过度膨胀，也更容易把结果合并进真实应用。同时，这也能帮助技能避免把平台代码和共享 UI 代码混在一起。

检查复用性和重组风险

拿到第一版输出后，检查它是不是既能复用 UI，又没有过度抽象。最常见的失败模式，要么是重复太多，要么是间接层级太深。必要时，可以让技能简化 composable 层级、拆分平台专属包装层，或者把状态收集上移到更高层级。

用真实页面反复打磨

提升效果最快的办法，是直接喂给它一个真实功能，比如 onboarding、搜索或详情页，并要求它按你应用里现有的规范来实现。然后再加上约束继续细化，比如“Android 和 iOS 共享”“支持深色模式”“低端设备上滚动必须流畅”。