关于 dart-type-bridger
一项开发技能,可从本地 OpenAPI 文件生成 Dart API 模型,并可获取 Firebase 架构信息,适用于需要准确后端数据结构而非猜测字段的 Flutter 开发。
主要功能
- 01从 OpenAPI 生成 Dart 模型
- 02读取项目中的本地 OpenAPI 文件
- 03获取 Firebase Firestore 架构
- 04支持 FastAPI 模型同步
适用场景
- 01根据本地 API 规范创建 Flutter 模型
- 02实现 API 调用时核对数据结构
- 03为 Flutter 开发获取 Firebase 架构
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ heyeddi-com/ heyeddi-skills --skill dart-type-bridger安装后在 Claude Code 中输入/dart-type-bridger确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
manifest.jsoncontext/ANTI_PATTERNS.mdEXAMPLES.mdPROSE_ANTI_SLOP.mdVOCABULARY.mdscripts/_skill_cli.pyfetch_firestore_schema.pysync_openapi.py详细介绍
Dart 类型桥接器
使用场景
- Flutter Agent 需要准确的 API 负载结构
- 项目根目录下存在本地
openapi.json(或其他 OpenAPI 文件) - Firebase 项目存在 Firestore 规则或架构文件
说明
-
确保本地存在 OpenAPI 文件
openapi.json。优先使用脚手架生成的文件。如果 API 正在运行,而文件缺失或已过时,请先导出到磁盘(不要将 URL 传入此技能):curl -fsS http://127.0.0.1:8090/openapi.json -o openapi.json -
FastAPI 模型:
python scripts/sync_openapi.py --project-root <root>:仅根据本地openapi.json生成lib/models/api_models.dart(可选参数--openapi path/rel.json)。 -
Firebase:
python scripts/fetch_firestore_schema.py --project-root <root> -
在存储库中导入生成的模型:切勿猜测字段名称。
评论
支持 Markdown