contentful-guide

Contentful ガイド

Contentful のタスクにおけるルーティングと語彙のレイヤーとして、このスキルを使用します。

Contentful はヘッドレスで API ファーストの CMS（コンポーザブルコンテンツプラットフォーム）です。チームはコンテンツを一度モデル化し、さまざまなチャネルに配信できます。

このスキルの役割

1. 基本用語（スペース、環境、環境エイリアス、コンテンツモデル、コンテンツタイプ、エントリー、アセット、ロケール）を明確にします。
2. ユーザーの意図を適切な API（CDA、CPA、CMA、GraphQL、Images API）に対応付けます。
3. 実装の依頼を適切なスキルとドキュメントに振り分けます。
4. 依頼がこのスキルの対象範囲外であることを特定し、不適切な設定を防ぎます。

ルーティングルール

• ユーザーから Next.js プロジェクトへの Contentful の追加を求められた場合は、contentful-nextjs スキルを使用します。
• 最適化、パーソナライズ、分析の設定やデバッグについて尋ねられた場合は、contentful-personalization スキルに振り分けます。
• コンテンツタイプのマイグレーションやスキーマの変更を求められた場合は、contentful-migration スキルに振り分けます。
• 具体的な REST／GraphQL リクエスト（curl の例、ヘッダー、クエリパラメーター、CMA／CDA／CPA／Images／GraphQL のペイロード形式）を求められた場合は、contentful-api スキルに振り分けます。
• 概念的なガイダンス、アーキテクチャ上のトレードオフ、または参照すべきドキュメントについて尋ねられた場合は、このスキルを使用します。
• 環境エイリアスやデプロイのワークフローについて尋ねられた場合は、フレームワークの実装も求められていない限り、このスキルを使用します。

API の選び方

• ウェブサイトやアプリで公開済みコンテンツを配信するには、CDA を使用します。
• 未公開コンテンツをプレビューするには、CPA を使用します。
• 書き込み操作（コンテンツやモデルの作成、更新、管理）には、CMA を使用します。
• REST のペイロードよりクエリ形式の制御を優先する場合は、GraphQL Content API を使用します。
• 画像の変換には、Images API を使用します。

Contentful MCP に関する注意

• エージェントが Contentful を操作できるようにするには、Contentful MCP サーバーが最も簡単な方法であることがよくあります。
• SDK コードを最初に組み込むことなく、スペース、エントリー、コンテンツモデルのコンテキストに会話形式でアクセスしたい場合に使用します。
• 公式ドキュメント：https://www.contentful.com/developers/docs/tools/mcp-server/

運用パターン

このスキルを使って回答する場合：

1. references/lexicon.md の共通語彙を使って用語を定義します。
2. references/docs-map.md から適切なドキュメントへのパスを選びます。
3. 実装を求められた場合は、references/skill-routing.md を使って引き継ぎます。
4. 回答は簡潔にまとめ、公式ドキュメントへのパスを示します。

ガードレール

• 製品の機能、API の動作、制限事項を創作しないでください。
• 専門の実装スキルに振り分ける場合を除き、フレームワークのコードを提示しないでください。
• バージョンによって詳細が変わる可能性がある場合は、記憶よりも公式ドキュメントを優先してください。

参考資料

• 用語集
• ドキュメントマップ
• スキルのルーティング