Dart Language 是一个用于在非并发代码中应用现代 Dart 语言与 API 模式的技能,来源为 thienqo/flutter-skills。其核心目标是:编写清晰的 Dart 代码,并使其符合项目自身的 SDK 约束与既有风格。
用途 该技能面向 Dart 语言层面的编码决策,帮助开发者在类型、记录、模式匹配、密封类、扩展、构造函数、空安全等语言特性上做出符合项目实际的选择。它不处理并发相关代码,也不涉及 Flutter 组件组合或状态归属。
主要能力与决策准则
- 在使用较新语法前,先阅读 pubspec.yaml 中的 SDK 约束。
- 优先使用简单类型和直接控制流,而非没有实际复用价值的抽象。
- 当穷尽式切换能提升正确性时,用密封类型建模封闭变体。
- 小型结构值使用记录(records);当身份、校验、文档或演进更重要时,使用具名领域类型。
- 当模式匹配能让分支或解构更清晰时使用它,而不是为了新奇而使用。
- 除非明确要求破坏性变更,否则保持公共 API 兼容性。
- 保持可变状态私有,只暴露最小可用接口。
- 绝不手工编辑生成文件(.g.dart、.freezed.dart 或任何标记为生成的文件);应编辑带注解的源文件,并通过项目命令重新生成。
- 遵循 Effective Dart 的命名、文档、用法与设计指南,并匹配仓库的 lint 规则,而不是添加冲突的风格策略。
使用方式与验证 在当前环境支持时,使用 Dart MCP 的语义查找与分析;否则检查源码并使用项目 CLI。运行格式化、静态分析以及最窄范围的相关测试。当修改公共包 API 时,检查示例与下游调用点。
适用场景 适用于日常 Dart 代码编写与重构,尤其是涉及类型设计、记录与模式匹配、密封类层次、扩展方法、构造函数与空安全等语言特性时。也适用于需要遵循 Effective Dart 与仓库 lint 规则、维护公共 API 兼容性、以及处理 build_runner 生成代码(freezed、json_serializable 等)的场景。
限制与边界
- 异步、流、取消与 isolate:应使用 dart-concurrency。
- Flutter 组件组合或状态归属:应使用相应的 Flutter 技能。
- JSON 与持久化模式行为:属于对应的数据技能。
- 代码生成器或 build_runner 版本升级后的重新生成:属于 flutter-dependency-upgrades;本技能负责针对已固定版本的生成器正确编写代码。
参考资料 该技能引用的资料包括:Dart language、Effective Dart、Dart and Flutter MCP server、build_runner、freezed、json_serializable。在采用模式匹配、解构、switch 表达式或多返回值时,可阅读 patterns and records migration;在设计代数数据类型、封闭结果模型或穷尽验证的状态族时,可阅读 sealed class hierarchies;当类使用 freezed、json_serializable 或其他 build_runner 生成器,或生成代码过期、冲突、构建失败时,可阅读 code generation with build_runner。
关于收费、价格、平台支持等具体信息,资料中暂未提供。