nitro について
サーバーサイド開発者向けの Nitro v3 スキルです。H3 v2 を基盤とする、フレームワークやデプロイ先に依存しないツールキットを扱います。ルーティング、キャッシュ、ストレージ、リアルタイム通信、データベース、デプロイ設定に加え、v2 からの移行点も説明します。
主な機能
- 01ファイルシステムルーティングとルートルール
- 02KV ストレージとキャッシュ
- 03ランタイム設定とライフサイクルフック
- 04スケジュールタスク、WebSocket、SSE
- 05SQL データベース層と OpenAPI ドキュメント
- 06複数プラットフォーム向けデプロイプリセット
活用シーン
- 01サーバーのルート、キャッシュ、レスポンスヘッダーの設定
- 02スケジュールタスクや WebSocket ハンドラーの追加
- 03SQL データ層の接続と OpenAPI ドキュメントの生成
- 04異なるランタイムやプラットフォームへのサービスのデプロイ
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ antfu/ skills --skill nitroインストール後、Claude Code で/nitroを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
GENERATION.mdreferences/advanced-migration.mdcore-assets.mdcore-cache.mdcore-configuration.mdcore-rendering.mdcore-routing.mdcore-storage.mddeploy-presets.mdfeatures-database.mdfeatures-openapi.mdfeatures-plugins.mdfeatures-tasks.mdfeatures-websocket.md詳細
このスキルは Nitro v3(ベータ版、3.0.260903)を基にしており、2026-09-25 に生成されました。
Nitro は、H3 v2、unstorage、Vite/Rolldown/Rollup を基盤とする、フレームワークやデプロイ先に依存しないサーバーツールキットです。Nuxt を支え、単独でも動作します。1 つのコードベースから、Node.js、Bun、Deno、Cloudflare、Vercel、Netlify などに最適化された出力を生成します。
主な機能:
- H3 v2 のイベントハンドラー、動的パラメーター、メソッドサフィックスに対応したファイルシステムルーティング。
- キャッシュ、ヘッダー、リダイレクト、プロキシ、CORS を宣言的に設定するルートルール。
- unstorage KV レイヤー上に構築されたキャッシュレイヤー(キャッシュ済みハンドラー/関数、SWR)。
NITRO_*環境変数で上書きできるランタイム設定。- タスク(オンデマンドおよびスケジュール/cron)、WebSocket/SSE、SQL データベースレイヤー、OpenAPI 自動ドキュメント生成。
- プラグインとライフサイクルフック、カスタムレンダラー/サーバーエントリー、移植可能なデプロイプリセット。
v3 の主な変更点(
nitropackv2 との比較):パッケージ名がnitropackからnitroに変更され、H3 v2(Web 標準のRequest/Response)に対応しました。自動インポートは削除されました(すべて明示的にインポートしてください)。ディレクトリのスキャンはserverDirによるオプトイン方式になりました。useStorageはuseKV(nitro/kv)に、storage設定オプションはkvに変更されました。キャッシュのswrはデフォルトでfalseになりました。v2 と v3 の API の違いがわからない場合は、まず advanced-migration をお読みください。
コア
| トピック | 説明 | リファレンス |
|---|---|---|
| ルーティング | ファイルベースのルート、defineHandler、パラメーター、ミドルウェア、ルートルール、エラー | core-routing |
| 設定 | nitro.config.ts、defineConfig、主なオプション、ランタイム設定 | core-configuration |
| ストレージ | unstorage KV、マウントポイント、ドライバー、動的マウント | core-storage |
| キャッシュ | defineCachedHandler、defineCachedFunction、SWR、無効化 | core-cache |
| アセット | パブリックアセット、圧縮、ストレージ経由のサーバーアセット | core-assets |
| レンダリング | レンダラー(HTML/SSR)、サーバーエントリー、フレームワーク連携 | core-rendering |
機能
| トピック | 説明 | リファレンス |
|---|---|---|
| プラグインとフック | definePlugin、ランタイムのライフサイクルフック、エラーの捕捉 | features-plugins |
| タスク | オンデマンドおよびスケジュール(cron)タスク、runTask | features-tasks |
| WebSocket と SSE | defineWebSocketHandler、パブ/サブ、名前空間、イベントストリーム | features-websocket |
| データベース | db0 経由の組み込み SQL レイヤー、useDatabase、コネクター | features-database |
| OpenAPI | defineRouteMeta からの仕様の自動生成、Scalar/Swagger UI | features-openapi |
高度な機能/デプロイ
| トピック | 説明 | リファレンス |
|---|---|---|
| デプロイプリセット | ランタイムとプロバイダー、互換性の日付、プラットフォーム連携 | deploy-presets |
| v2 → v3 の移行 | パッケージ名の変更、nitro/* インポート、H3 v2 API、プリセットの変更 | advanced-migration |