android-design-guidelines

android-design-guidelines 技能概览

这个技能能做什么

android-design-guidelines 技能是一个面向 Material Design 3、Jetpack Compose 和基于 XML 的布局的实用型 Android UI 决策辅助工具。它可以把一个模糊的 UI 任务，转化为符合平台规范的实现选择，帮助你在主题、导航、可访问性、自适应布局和核心组件上做出正确判断。

适合谁使用

如果你正在构建或审查 Android 界面、向 Material You 迁移，或者希望避免破坏一致性和可访问性的平台级错误，就适合使用 android-design-guidelines 技能。对需要的是 android-design-guidelines for UI Design 这类面向产品团队的指导，而不是抽象设计理论时，它尤其有用。

它最擅长什么

当你需要关于 Android UI 应该如何表现的具体建议时，这个技能最强：动态颜色、颜色角色、predictive back、触控目标尺寸、字体缩放以及响应式布局模式。相比通用提示词，它更适合需要兼顾实现细节的指导，能够同时适用于 Compose 和 XML。

如何使用 android-design-guidelines 技能

安装并定位规则地图

先运行你的 skills manager 所使用的 android-design-guidelines install 命令，然后打开 skills/android 下的仓库上下文。先读 SKILL.md，再查看 AGENTS.md、metadata.json 和 rules/_sections.md，这样在针对某个具体界面或功能提问之前，先理解规则结构。

给这个技能一个真实的 Android 任务

当你提供界面类型、API level、UI toolkit 和约束条件时，这个技能效果最好。例如，可以让它为 Android 12+ 的 Compose 主题、平板应用的导航模式，或者自定义组件的可访问性审查提供建议。像“改进这个 UI”这样模糊的提示，效果通常不如一个聚焦的 android-design-guidelines usage 请求，例如：“请检查这个 Compose 设置页，确认是否符合 Material 3、动态颜色和 TalkBack 要求。”

先读对文件

先用 rules/_sections.md 跳转到相关类别，再查看 SKILL.md 里对应的规则组，以及 AGENTS.md 中的说明。如果你在处理主题、导航或可访问性，这些部分通常决定输出是否可用。这个仓库的辅助文件不多，所以主要价值来自规则正文和章节索引，而不是庞大的参考树。

提示约束，而不只是设计想法

高质量输入会明确提到平台版本、布局形态和实现方式。更好的提示是：“为 Android 14 上的照片应用设计一个 Material 3 Compose 界面，要求动态颜色、底部导航、支持大字号，并且不能使用自定义品牌色。” 这样 android-design-guidelines 技能就有足够上下文，返回既符合 Android 习惯、又能避免隐藏冲突的选择。

android-design-guidelines 技能常见问题

这只是给设计用的吗？

不是。android-design-guidelines 技能面向的是会影响实现的设计决策。当你需要开发者能够直接在 Compose 或 XML 中落地的指导时，它很有用，尤其适合生产应用里的 android-design-guidelines usage。

应该用它，而不是直接写普通提示词吗？

当你希望减少 Android 特有错误、获得更一致的平台行为时，就应该使用这个技能。普通提示词也能给出 UI 想法，但往往会漏掉动态颜色回退、触控目标最小尺寸或导航惯例这类要求。

它适合初学者吗？

适合，但前提是你已经有一个具体界面或组件目标。比如你已经知道任务是“做一个设置页”或“修复这个可访问性问题”，那它最好用。如果你完全没有 Android 背景，它就没那么有帮助。

什么情况下不该用它？

不要把它用于非 Android 的设计系统、营销网站布局，或 iOS 特有的交互模式。若你需要的是产品策略或不受平台约束的视觉品牌探索，它也不是合适工具。

如何改进 android-design-guidelines 技能

优先从高风险规则区域入手

通常，质量提升最大的地方是主题、导航和可访问性。使用 android-design-guidelines guide 时，务必明确说明你是否需要 Material You、predictive back、平板适配或读屏支持，这样技能才能优先处理最影响正确性的规则。

提供规则依赖的界面上下文

当你补充以下信息时，这个技能会给出更好的结果：Compose 还是 XML、目标 API level、手机还是平板、是否需要深色模式，以及界面是否使用自定义绘制还是标准 Material 组件。这样的上下文能帮助它避免泛泛而谈，并选出合适的 Android 模式。

先请求审查，再迭代

一个好的流程是：先让它给出初版实现方案，落地之后，再让它复查硬编码颜色、文本尺寸不当、焦点顺序薄弱或导航位置错误等问题。android-design-guidelines skill 的价值在这里最明显：它能抓住首稿里容易遗漏的结构性问题。

用具体输入换具体修复

不要只说“让它更可访问”，而要直接描述失败模式：“这个 Compose 卡片只有图标操作，触控目标是 36dp，而且用了自定义 canvas 绘制；请说明要改哪些地方才能符合 Material 3。” 具体越明确，回答越准确，因为技能可以把你的问题映射到实际规则集，而不是猜测你的意图。