/note/tech

4万行超のopenapi.yamlをTypeSpecに移行した話

TypeSpec へ移行したことで次の恩恵を享受することができました:

  • 移行後の TypeSpec ファイルの総量は約 2 万行になりました。手作業で管理するファイルの行数が減ったことは嬉しいポイントです。
  • モデルやルート定義を分割できるようになったことでスキーマ全体の可読性と開発体験が大幅に向上しました。
  • AI Agent のコンテキストを過度に圧迫することなく開発できるようになりました。
  • エミッターで OpenAPI のバージョンを簡単にアップデートできるようになりました.