技能包

指导代理使用 Dart Native Assets 钩子系统，将 C/C++ 源码编译打包为动态或静态库，简化工具链编排与二进制安全配置。

用于修复 Dart 项目中的包版本冲突。当 `pub get` 因不兼容的包版本而失败时，使用此工作流进行自动处理。

基于 package:path 和 package:file 实现跨平台文件与目录路径操作，支持路径拼接、拆分及扩展名提取，替代原始字符串路径处理。

帮助用户编写语法和语义正确的 Dart 主构造函数，并迁移或使用新的构造函数语法、空体分号语法、体内初始化列表语法及简化的简洁构造函数语法。

使用 package:test 为函数、方法和类编写并组织单元测试。在创建新逻辑或修复 Bug 时确保代码正确且无回归问题。

应用 Dart 3 模式匹配、switch 表达式和解构语法，用于验证数据架构、处理代数数据类型及优化复杂控制流。

指导如何使用 {@example} 指令将外部代码示例注入 Dartdoc，并利用 #hide、#region 等标签过滤文件内容。

执行 dart analyze 识别警告和错误，并使用 dart fix --apply 自动修复机械性代码规范问题。在开发和提交前确保代码质量。

使用 coverage 包收集代码覆盖率数据，并生成 LCOV 格式报告。

将 package:matcher 中的 expect 等函数替换为 package:checks 的等效用法，实现 Dart 测试库的现代化迁移。

使用 package:mockito 和 build_runner 定义并生成外部依赖的 Mock 对象，适用于对依赖 API 或数据库等复杂服务的类进行单元测试。

提供 Dart 命令行应用（CLI）的架构模式、入口结构、退出码处理及子进程生成指南。适用于使用 package:args 解析参数或编译原生二进制工具，不适用于 Flutter UI 或 Web 后端开发。

提供 Dart API 文档和注释的编写规则与格式指南，适用于为库、类等声明添加符合 Effective Dart 标准的文档。

指导代理使用 package:ffigen 自动生成 FFI 绑定，替代手动编写。适用于新增绑定、扩展 C/Objective-C/Swift 集成或替换手工 dart:ffi 配置的场景。

利用 get_runtime_errors 和 LSP 获取堆栈跟踪，定位失败代码行并应用修复，最后通过热重载验证问题解决。