AI编码助手经常因为训练数据过时而无法正确使用Dart新语法

核心洞察

先说结论：这个项目解决的是 AI 编程里一个很实在的痛点。模型训练数据永远比 DartGoogle开发的一种面向对象的编程语言，用于构建Flutter应用、Web服务等。 的发布节奏慢半拍，每次在 prompt 里纠正它，下次照样犯错，作者索性把按版本整理的官方知识库打包成技能，让智能体按需去查。我唯一存疑的是，skill 机制在不同编辑器里的支持程度参差不齐，装上了能不能真正生效，还得看你的工具链。

---

用 AI 编程助手写 Dart 和 Flutter，不管是 Claude Code、Google Antigravity、OpenAI Codex、GitHub Copilot、Cursor 还是 Cline，你八成碰到过同一个问题：模型的知识停在某个时间点，之后的新语法它一概不认。

Dart 的迭代速度很快。最近几年我们看到了：

• Dart 2.12：健全空安全Dart 2.12引入的编译器级特性，通过类型系统区分可为空和非空变量，消除空引用错误。（?、late、!、required）
• Dart 2.17：超参数（super.key）和增强枚举
• Dart 3.0：记录、模式匹配、switch 表达式和密封类（同时彻底移除非空安全模式）
• Dart 3.12 到 3.13+：私有命名参数、构造器简写和主构造器（class Point(var int x, var int y);）

预训练数据集天然跟不上最新版本，所以裸装的 LLM 经常：

1. 把 Dart 3.13 的新语法当成语法错误
2. 该用主构造器的地方，写了 15 行重复的构造器和 equals 样板代码
3. 在 pubspec.yaml 里把 environment.sdk 下限（minSdk）搞错
4. 抢救 2.12 之前的旧项目时，不知道跨过空安全分水岭要按什么版本顺序来

为了彻底解决这个问题，我把这些内容整理提取，做成了开源项目 dart-sdk-skills。

---

核心结论

1. dart-sdk-skills 是一个开源技能包，专门为 AI 编程智能体整理 Dart SDK 知识，覆盖 Dart 1.0 到 3.14 的按版本特性，仓库地址为 https://github.com/RandalSchwartz/dart-sdk-skills。

2. 该项目采用渐进式披露一种信息呈现策略，先在提示中只保留概览或索引，在需要时再加载详细内容，以节省上下文空间。：智能体只携带一份轻量特性矩阵一个紧凑的表格或文档，列出每个Dart版本引入的主要特性，方便智能体快速查询。，遇到具体问题时才按需读取对应版本的更新日志和参考指南，避免一次性塞入几千行 prompt 内容。

3. 它直接针对 LLM 常见错误设计，例如：误判 Dart 3.13 新语法为语法错误、不用主构造器而写出约 15 行重复构造器与 equals 样板代码、在 pubspec.yaml 中写错 environment.sdk 下限，以及不知道 Dart 2.12 空安全分水岭前的迁移版本顺序。

4. 它支持两类典型场景：新项目直接使用 Dart 3.13+（主构造器、通配符变量 _、数字分隔符 1_000_000、精确 minSdk 校验）；以及老代码库迁移（Dart 1.x 到 2.12 再到 Dart 3 需按四步流程操作）。

5. 安装只需一条命令，例如 npx skills add RandalSchwartz/dart-sdk-skills -g，或使用 Dart 的 skills CLI：skills add https://github.com/RandalSchwartz/dart-sdk-skills --global --all。

dart-sdk-skills 是什么？

dart-sdk-skills 是一个按版本组织的权威技能包，专门给 AI 编程智能体用。

它采用渐进式披露，不会把几千行内容一次性塞进每次对话的 prompt：

• 智能体手上有一份轻量紧凑的特性矩阵，覆盖 Dart 1.0 到 3.14 的每个版本
• 遇到"Dart 3.13 有什么新东西？"、"私有命名参数需要什么 minSdk？"或者"帮我把这个老 Flutter 项目现代化"这类问题时，它会按需读取对应的更新日志参考指南

---

两大使用场景

1. 新项目开发，直接上 Dart 3.13+

不用再跟 LLM 争论现代语言写法，你的智能体马上就知道：

• 主构造器和 this : assert(...) 断言体
• 通配符变量（_）和数字分隔符（1_000_000）
• 精确的 minSdk 校验，pubspec.yaml 不会再搞挂 CI

2. 抢救老代码库（Dart 1.x 和 2.12 之前）

Dart 3 完全不允许不带健全空安全运行，所以抢救老代码需要严格走四步：

1. Dart 1.x 到 2.0：删掉过时的 new 关键字，强制静态类型
2. 2.12 之前到 2.12：转换 @required 注解、未初始化的可空字段和防御性运行时断言
3. pubspec.yaml：把 environment 下限升到 ^3.5.0 或 ^3.13.0，替换废弃包（pedantic、tuple）
4. Dart 3 现代化：用上 super 初始化器、密封类和模式匹配

---

安装方式（一条命令）

用任意技能包管理器都能装，几秒钟搞定，全项目全局生效。

用 npx skills（通用 / Node）

npx skills add RandalSchwartz/dart-sdk-skills -g

用 Dart 的 skills CLI

skills add https://github.com/RandalSchwartz/dart-sdk-skills --global --all

装完之后，你的智能体就自动带上了整套 Dart SDK 知识库。

完整仓库在 GitHub 上：https://github.com/RandalSchwartz/dart-sdk-skills

常见问题（FAQ）

AI写Dart代码老报语法错误怎么办？

可以用dart-sdk-skills技能包，按版本整理Dart 1.0到3.14特性，渐进式披露让AI准确掌握新语法，一条命令全局安装，解决模型训练数据过时导致的报错和迁移问题。

dart-sdk-skills是什么？怎么安装？

dart-sdk-skills是开源技能包，按版本组织Dart特性，供Claude Code等AI使用。安装执行npx skills add RandalSchwartz/dart-sdk-skills -g 或用skills CLI，几秒完成全局生效。

如何让AI正确迁移Dart老项目到3.x？

安装dart-sdk-skills后，AI按版本顺序处理：1.x删new强制类型，2.12前转换注解，升级pubspec环境到3.5+，最后用Dart 3特性现代化，避免空安全错误。