makepad-2.0-dsl

makepad-2.0-dsl 技能概览

makepad-2.0-dsl 是一项聚焦于 Makepad 2.0 DSL 的实用技能，尤其适合在编写、阅读或修复 script_mod! UI 代码时，避免沿用 1.x 的语法习惯。它最适合前端开发者、Rust UI 作者，以及需要一份实用的 makepad-2.0-dsl 指南来处理属性赋值、命名 widget、合并行为和 Rust 绑定模式的 agent。

这个技能能帮你做什么

它的核心作用，是把模糊的 UI 意图转成可用的 Makepad 2.0 DSL：选对 : 而不是 =，在命名实例时使用 :=，并正确应用 merge 语法。这一点很重要，因为很多失败本质上是语法问题，而不是设计问题；通用 prompt 往往抓不住 Makepad 真正要求的那些操作符。

为什么值得安装

当输出正确性取决于一些细小的 DSL 规则时，makepad-2.0-dsl 技能最有价值：兄弟节点之间不能用逗号、支持 dot-path 覆盖、let 绑定，以及会影响布局或绘制的属性分类。如果你需要稳定的 Makepad 2.0 代码生成或代码审查支持，这项技能能明显减少反复试错。

最适合的使用场景

当你在构建 Makepad 应用、转换旧的 live_design! 示例，或检查一个 widget 树在运行时是否会按预期工作时，用它最合适。如果你只是想要一个通用 UI prompt，而不需要精确的 Makepad 语法，它就没那么适用。

如何使用 makepad-2.0-dsl 技能

正确安装并触发它

安装方式：

npx skills add ZhangHanDong/makepad-skills --skill makepad-2.0-dsl

当你的请求明确提到 Makepad 2.0 DSL、script_mod!、属性系统问题，或命名 widget 问题时，就应该触发 makepad-2.0-dsl 技能。如果你是在让 agent 帮忙，最好把目标和失败模式说清楚：比如“把这段旧版 Makepad 代码转换成 2.0 DSL”，比“帮我整理一下”更有效。

提供 DSL 真正能用的输入

高质量输入会描述 widget 结构、布局意图，以及哪些部分必须能从 Rust 中访问。比如要明确某个子元素是否需要 id、父容器是否是 Fit，以及哪些属性应当继承、哪些应当替换。弱一点的 prompt 只会说“让它更好看”；更强的 prompt 会说“做一个两栏面板，带一个命名的提交按钮、固定的 header 高度，以及继承的背景样式”。

先读这些文件

先看 SKILL.md，然后再检查 references/dsl-syntax-reference.md 和 references/property-system.md。这两份参考覆盖了最容易卡住落地的规则：语法形式、merge 语义、布局默认值，以及 height: Fit 这个容易踩坑的点——它可能让嵌套容器看起来像“消失了”。

能产出更好结果的工作流

用一个短循环：先描述 widget 目标，再让它生成一版 Makepad 2.0 DSL 草稿，最后对照语法参考检查结果，再决定是否应用。对于 makepad-2.0-dsl 的使用，要特别留意答案是否把 width、height、flow 和 draw_* 放在正确的属性类别里，因为位置不对通常意味着布局或样式会出问题。

makepad-2.0-dsl 技能 FAQ

这只适用于 Makepad 2.0 项目吗？

是的。这个 makepad-2.0-dsl 技能面向的是 2.0 DSL 及其 script_mod! 工作流，不是旧的 live_design! 宏风格。如果你的代码库还停留在 1.x 约定上，可以把它当作迁移辅助工具，而不是直接替换方案。

它比通用 prompt 更好吗？

通常是的，因为这里的价值在于语法精度，而不是创意表达。通用 prompt 可以描述 UI，但 makepad-2.0-dsl 更可能保留 Makepad 真正会强制执行的冒号语法、命名实例和 merge 规则。

初学者能用吗？

可以，只要他们有一个明确的目标 widget 或布局。初学者通常在提供粗略草图、预期的子元素名称，以及是否需要通过 id! 或 ids! 从 Rust 访问元素时，效果最好。

什么时候不该用它？

如果你不是在写 Makepad UI 代码，或者你只需要不受 DSL 约束的宽泛前端建议，就不该用它。另一个不适合的场景是需求过于模糊，无法映射成 widget 树、属性集合或绑定模式。

如何改进 makepad-2.0-dsl 技能

先给出最关键的约束

质量提升最大的地方，是一开始就把布局和归属细节说清楚：父容器的尺寸行为、是否有命名子元素，以及模板应该 merge 还是 replace。对于 Frontend Development 场景下的 makepad-2.0-dsl，这些约束往往比视觉风格偏好更重要。

避免最常见的失败模式

最常见的错误包括：用了 =、忘记兄弟属性之间要用空白分隔，以及把容器放进 Fit 里却没有设置 height: Fit。另一个常见问题是要求命名 widget，却忘了 := 会改变实例的存储和引用方式。

按你需要的输出形状来提问

如果你想要可复用代码，就直接说明，并要求一个基于 let 的模板或已注册 widget 的示例。如果你想要直接补丁，就只要求变更的那一块，并写明精确的属性路径，比如 draw_bg.color 或 title.text，这样结果更容易直接应用。

通过一次只测一条规则来迭代

当第一次输出已经接近但还不对时，把 prompt 改成尽可能小的变化：只调整一条布局规则、一个绑定目标，或者一条 merge 路径。这样可以让 makepad-2.0-dsl 指南始终聚焦在真正失败的点上，通常比整套 UI 重新生成更快。