mcpField
D
dart-type-bridger

dart-type-bridger

github.com/heyeddi-com开发090 次安装1 天前更新
代码仓库

关于 dart-type-bridger

一项开发技能,可从本地 OpenAPI 文件生成 Dart API 模型,并可获取 Firebase 架构信息,适用于需要准确后端数据结构而非猜测字段的 Flutter 开发。

主要功能

  1. 01从 OpenAPI 生成 Dart 模型
  2. 02读取项目中的本地 OpenAPI 文件
  3. 03获取 Firebase Firestore 架构
  4. 04支持 FastAPI 模型同步

适用场景

  1. 01根据本地 API 规范创建 Flutter 模型
  2. 02实现 API 调用时核对数据结构
  3. 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.json
context/
ANTI_PATTERNS.md
EXAMPLES.md
PROSE_ANTI_SLOP.md
VOCABULARY.md
scripts/
_skill_cli.py
fetch_firestore_schema.py
sync_openapi.py

详细介绍

Dart 类型桥接器

使用场景

  • Flutter Agent 需要准确的 API 负载结构
  • 项目根目录下存在本地 openapi.json(或其他 OpenAPI 文件)
  • Firebase 项目存在 Firestore 规则或架构文件

说明

  1. 确保本地存在 OpenAPI 文件 openapi.json。优先使用脚手架生成的文件。如果 API 正在运行,而文件缺失或已过时,请先导出到磁盘(不要将 URL 传入此技能):

    curl -fsS http://127.0.0.1:8090/openapi.json -o openapi.json
    
  2. FastAPI 模型:python scripts/sync_openapi.py --project-root <root>:仅根据本地 openapi.json 生成 lib/models/api_models.dart(可选参数 --openapi path/rel.json)。

  3. Firebase:python scripts/fetch_firestore_schema.py --project-root <root>

  4. 在存储库中导入生成的模型:切勿猜测字段名称。

评论

支持 Markdown