makepad-2.0-theme

makepad-2.0-theme 技能概览

什么是 makepad-2.0-theme

makepad-2.0-theme 技能帮助你以保持 design token 一致性的方式使用 Makepad 2.0 主题系统。它最适合用于处理 theme.* 变量、在深色和浅色主题之间切换，或理解 Makepad 的 theme 全局变量如何影响 widget 和应用级样式。

适合谁使用

如果你正在构建或维护 Makepad UI，尤其是关注产品、内部工具，或 makepad-2.0-theme for Design Systems 的可扩展样式管理，就应该使用 makepad-2.0-theme 技能。当硬编码的颜色、间距或字体值会导致不同界面之间风格漂移时，它尤其合适。

它解决什么问题

它的核心任务，是把松散的视觉意图转换成符合主题系统的实现。与其凭感觉猜哪些值该写进代码，不如借助这个技能，把“深色模式且对比度更强”或“更紧凑的面板需要更密集的间距”这类需求映射到 Makepad 期望的主题变量上。

为什么值得安装

makepad-2.0-theme 技能不只是一个泛化的样式提示词：它围绕的是 Makepad 的主题加载顺序、变量命名，以及语义化主题值和直接数值字面量之间的区别。这样一来，当你需要输出与真实 Makepad runtime 兼容时，采用风险会更低。

如何使用 makepad-2.0-theme 技能

正确安装并触发

对于 makepad-2.0-theme install，请先用仓库里的安装命令把该技能加入你的 skills 集合；只要你的请求提到主题变量、widget 样式、主题切换，或 Makepad 的颜色 / 字体 / 间距决策，就应该调用它。如果你的提示词只是说“让它更好看一点”，这个技能的信息会不够明确。

从合适的输入开始

更好的结果来自包含以下信息的提示词：

• 你想要的主题模式：深色、浅色或 skeleton
• 你正在处理的屏幕或组件
• 你希望调整的 token：颜色、字体、间距、圆角、对比度
• 改动是否必须保留现有 widget 行为

较弱的请求是“改进主题”。更强的请求是：“使用 makepad-2.0-theme 为一个紧凑型 inspector 面板调深色模式，保持排版不变，提高间距清晰度，并避免硬编码值。”

先读取正确的文件

在实际使用 makepad-2.0-theme 时，先看 SKILL.md，然后打开 references/theme-variables.md。这个参考文件是最快了解可用 token、全局调节参数，以及哪些值应该用语义化表达而不是字面量的路径。

遵循主题加载流程

实现上最关键的细节是顺序：主题定义必须先加载，widget 才能引用它们。使用这个技能时，要留意 App::run 里的初始化流程，然后把这个模式迁移到你的项目中，而不是机械地复制一组值。若忽略这一点，它也是最容易阻碍落地的地方。

makepad-2.0-theme 技能 FAQ

这只是一个深色模式样式提示词吗？

不是。makepad-2.0-theme 技能覆盖的是更完整的 Makepad 2.0 主题系统，包括主题变量、间距、排版、widget 状态样式，以及主题切换。深色模式只是其中一个常见场景。

我必须先非常懂 Makepad 吗？

不一定。如果你能描述自己想修改的 UI，这个技能就足够友好。你不需要把每个 token 都背下来，但需要准备好说明组件、视觉目标，以及对硬编码值的限制。

什么情况下不该用它？

如果你并不是在 Makepad 里工作、你的 design system 不使用主题 token，或者你只是需要一次性的视觉 mockup 且没有实现约束，就不该用 makepad-2.0-theme。这些情况下，一个通用的样式提示词就够了。

它和普通提示词有什么不同？

普通提示词可能只会提供一些视觉想法，但 makepad-2.0-theme 更适合依赖 Makepad 约定的实现决策。尤其当你需要的结果要符合仓库里的 theme 变量结构，而不是自己发明一套新的样式规范时，它会更有用。

如何改进 makepad-2.0-theme 技能

给出具体的视觉目标

提升 makepad-2.0-theme 输出的最快方式，是明确你真正想要的取舍。可以直接说“提高信息密集型 dashboard 的对比度”、“减少 skeleton 状态下的视觉噪音”，或“让间距更紧凑，但不要压缩可读文字”。这些约束比笼统形容词更能有效引导 token 选择。

提供现有主题上下文

如果你的项目已经在使用 theme.* 变量，请贴一小段当前用法，以及问题出在哪里。说明问题是 token 选择、加载顺序、间距不一致，还是深浅色模式之间不匹配。这样可以帮助技能生成修复方案，而不是重新设计一套样式。

留意常见失败模式

最常见的问题是硬编码值、在 widget 之后才加载主题设置，以及只改局部颜色却没有检查语义 token 的级联影响。如果第一次结果不理想，应该要求按 token 级别修订，而不是重写整个视觉方案。比如：“保持布局不变，但重新平衡 color_contrast，并稍微提高 space_factor。”

从输出回到实现，逐步迭代

第一次生成后，先在应用里测试结果，再用一个窄范围的后续需求继续微调。如果感觉太平，可以要求调整调色板对比度；如果感觉太拥挤，可以要求调整间距和圆角；如果主题切换出问题，则重点检查加载顺序和当前的 mod.theme 选择。这是在真实项目中使用 makepad-2.0-theme for Design Systems 最有效的方式。