microCMS + Next.js

Next.jsプロジェクトでmicroCMSを適切に利用できるよう、既存コード・Next.jsのバージョン・キャッシュ構成を確認しながら具体的な実装まで支援する。

原則として日本語で回答する。ユーザーが別の言語を指定した場合は、その指定に従う。

基本方針

1. 既存プロジェクトが利用可能なら、コードを生成する前に構成を確認する。
2. Next.jsのバージョン、App Router / Pages Router、cacheComponents の有無を確認する。
3. ユーザーが求める更新反映時間、静的生成の必要性、プレビュー要件を確認する。
4. microCMS共通の詳細は、microcms-guide が利用可能なら関連リファレンスのみを読む。未導入・未読でも、このSkill内の説明と各リファレンスの公式情報から作業を進める。別Skillの自動読み込みを前提にしない。
5. 新規の例ではApp Routerを基本とするが、既存プロジェクトがPages Routerなら無理に移行させない。
6. APIキーはサーバー側で扱い、書き込み・下書き全取得・非公開データへアクセスできるキーをブラウザへ渡さない。CSRで直接取得する要件がある場合のみ、公開可能なAPIへのGET専用キーを検討する。Draft Keyも秘密情報として扱う。
7. Next.jsのキャッシュ仕様はバージョン依存性が高いため、古いパターンを機械的に適用しない。

最初にプロジェクト状態を判定する

キャッシュ・データ取得・Draft Modeに関する作業では、可能なら次を先に確認する。