makepad-2.0-migration

makepad-2.0-migration 技能概览

这个技能能做什么

makepad-2.0-migration 技能可以帮助你更稳妥地把 Makepad 项目从 1.x 迁移到 2.0，减少试错成本。它面向的是需要从旧的 live_design! 模型切换到新的 script_mod! 工作流的人，覆盖语法更新、derive macro 重命名，以及运行时脚本模式等迁移要点。

它适合谁

如果你正在更新现有代码库、梳理 breaking changes，或者想把旧的 widget 定义翻译成新语法，就适合使用 makepad-2.0-migration 技能。它尤其适合维护者、支持 UI 代码的后端工具负责人，以及需要一份更像实施清单、而不是泛泛教程的迁移指南的开发者。

它有什么不同

这个技能的重点是精确映射和迁移流程，而不是从零学习 Makepad。它的核心价值在于减少转换错误：比如把尖括号改成花括号、把 Live 改成 Script、把 LiveHook 改成 ScriptHook、把 apply_over 改成 script_apply_eval，以及相关的生命周期和主题变化。对于手上已经有旧代码的人来说，makepad-2.0-migration 比通用提示词更适合做迁移决策。

如何使用 makepad-2.0-migration 技能

正确安装并触发它

按目录里常规的技能命令安装 makepad-2.0-migration 技能，然后在任务明确涉及 Makepad 1.x 到 2.0 转换时调用它。一个好的触发提示应清楚说明源版本、目标版本和你要迁移的文件类型，例如：将这个 Makepad 1.x widget 文件迁移到 2.0 的 script_mod 语法，并保留行为。

提供合适的输入

这个技能在你提供代表性代码片段时效果最好，而不是只给一个高层请求。请包含旧的 live_design! block、任何 #[derive(...)] 声明、生命周期方法，以及你希望保留的 widget 状态。如果你只说“帮我升级 UI”，技能就需要猜太多；如果你贴出准确的旧语法，它就能逐项直接映射。

先看这些文件

先打开 SKILL.md 看迁移框架，再打开 references/migration-guide.md 看详细的语法对照表和示例。这两个文件能最快帮你进入实际的 makepad-2.0-migration usage 工作流，尤其适合你需要确认某个改动到底是重命名、结构重写，还是运行时模式切换的时候。

一个靠谱的工作流

建议分三步用这个技能：先识别旧构造，再按映射表转换，最后检查语义变化，比如状态引用语法和属性合并行为。做大规模迁移时，最好按文件逐个处理，这样你可以在每次转换后验证输出，而不是一口气要求整仓重写。

makepad-2.0-migration 技能常见问题

这个技能只适用于 Makepad 1.x 到 2.0 升级吗？

是的。makepad-2.0-migration 技能是给迁移工作用的，不是给通用 Makepad 应用设计用的。如果你是在 2.0 上新建项目，可能更适合用一个新的提示词，或者直接找面向 2.0 的指南。

我需要先懂新语法吗？

不需要，但你必须提供足够多的旧代码，技能才能准确翻译。初学者也能用，不过最好的效果通常来自于你贴出具体片段，并要求直接迁移，而不是抽象解释。

它为什么比普通提示词更好？

普通提示词经常漏掉那些会真正破坏 Makepad 迁移的精确重命名和结构变化。makepad-2.0-migration skill 提供了更严格的转换框架，因此更擅长捕捉升级时最关键的语法漂移、生命周期重命名和属性更新差异。

什么时候不该用它？

不要把它用在无关的 Rust 重构、通用 UI 整理，或者宽泛的 Makepad 架构规划上。如果你的任务并不是专门围绕 makepad-2.0-migration install 这类升级工作，这个技能就不如针对你实际技术栈的定制提示词有用。

如何改进 makepad-2.0-migration 技能

提供源端和目标端的约束

最好的结果通常来自于你明确告诉技能哪些内容必须保持不变：widget 行为、状态名称、主题意图，或者文件布局。如果你有诸如“保持公开 API 稳定”或“不要改变事件流”这样的约束，最好一开始就说明，这样迁移输出就不会只顾语法优化，而忽略了实际行为。

先给出最难的几行

Makepad 迁移里最容易出错的地方，通常是最棘手的部分：宏边界、嵌套 widget 定义，以及生命周期 hook。请优先贴出使用 live_design!、derive 属性、状态引用或合并行为的代码行，因为这些地方决定了 makepad-2.0-migration usage 的质量。

要求“带检查”的迁移，而不只是转换

更好的请求方式是：把这个文件转换到 Makepad 2.0，列出任何行为变化，并标出需要人工确认的语法。 这种提法更容易让技能返回一个更稳妥的结果，特别适合需要可靠迁移说明、而不只是改写代码的 makepad-2.0-migration for Backend Development 团队。

先对一个文件迭代，再泛化到全局

拿到第一次结果后，先对照 references/migration-guide.md 检查，并在上下文中测试转换后的文件。如果有问题，把准确的编译错误或运行时不一致反馈回去，再要求做更小范围的修正。这个循环通常比反复要求整份重写、却不给诊断信息，产出更好。