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

4 万行超の openapi.yaml のツラミ ファイルが大きすぎて編集しづらい OpenAPI が肥大化していくにつれて開発体験の低下を招いていました。 GitHub Copilot や Cursor の Tab 機能で随分楽になりましたが、それでも 4 万行もあるファイルを手作業で入力するのは純粋に辛いです。 AI Agent のコンテキストを大きく圧迫する Cursor 等の AI Agent のコンテキストを大きく圧迫することが直近の開発で大きな課題となりました。 具体的には次のような問題が発生したため、ファイルを分割することが急務となりました。 コンテキストが溢れて Cursor Agent が停止する Longer Context を有効化すると処理できるようになるが、トークンを余分に消費してしまう TypeSpec とは TypeSpec は、API を記述するための Mi

[KoshianX]

まだ 1.0.0-RC なのか。Typescript っぽく API を定義できて OpenAPI にも変換できるとな。ここまで Typescript っぽいとそのまま動かねえのかという気分にもなってもにょるな……

[Nunocky]

バックエンドのAPIってそんな規模感なのか。 考えを改めねば

[hurafula]

いつのまにかRC出てたとは！共有ありがとうございます！昨年学習した内容は全部忘れてるけど

[meltedsoysource]

TypeSpec、初知り