mcpField
D
dart-type-bridger

dart-type-bridger

github.com/heyeddi-com開発090 回インストール1 日前に更新
リポジトリ

dart-type-bridger について

ローカルのOpenAPIファイルからDartのAPIモデルを生成し、Firebaseのスキーマ情報も取得できる開発スキルです。フィールド名を推測せず、正確なバックエンドのデータ形状を必要とするFlutter開発向けです。

主な機能

  1. 01OpenAPIからDartモデルを生成
  2. 02プロジェクト内のOpenAPIファイルを参照
  3. 03Firebase Firestoreスキーマの取得
  4. 04FastAPIモデル同期への対応

活用シーン

  1. 01ローカルAPI仕様からFlutterモデルを作成
  2. 02API呼び出し実装時のデータ形状確認
  3. 03Flutter開発向け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 Type Bridger

使用する場面

  • Flutter エージェントで、API ペイロードの正確な形状が必要な場合
  • プロジェクトのルートディレクトリにローカルの openapi.json（または別の OpenAPI ファイル）がある場合
  • Firebase プロジェクトに Firestore ルールまたはスキーマファイルがある場合

手順

  1. openapi.json にローカルの OpenAPI ファイルがあることを確認します。足場として用意されたファイルを優先してください。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 対応