content-modeling-best-practices について
ヘッドレス CMS の構造化コンテンツを設計するチーム向けのガイドです。設計原則と判断事項別の資料を備え、Sanity 固有の実装メモも含みます。
主な機能
- 01コンテンツ構造化の指針
- 02単一の信頼できる情報源の原則
- 03複数チャネル向けの設計
- 04編集者を中心としたモデル設計
- 05トピック別の参考資料
活用シーン
- 01新しいコンテンツモデルの設計
- 02構造化コンテンツか自由形式かの選択
- 03参照と埋め込みオブジェクトの判断
- 04既存コンテンツ構造の再設計
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ sanity-io/ agent-toolkit --skill content-modeling-best-practicesインストール後、Claude Code で/content-modeling-best-practicesを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/content-reuse.mdreference-vs-embedding.mdseparation-of-concerns.mdtaxonomy-classification.md詳細
コンテンツモデリングのベストプラクティス
柔軟で再利用可能、かつ保守しやすい構造化コンテンツを設計するための原則です。これらの概念はあらゆるヘッドレス CMS に適用できますが、Sanity 固有の実装上の注意点も含まれています。
適用するタイミング
以下の場合に、これらのガイドラインを参照してください。
- 新しいプロジェクトを開始し、コンテンツモデルを設計するとき
- コンテンツを構造化するか、自由形式にするかを評価するとき
- 参照と埋め込みコンテンツのどちらを使うか決めるとき
- マルチチャネルでのコンテンツ配信を計画するとき
- 既存のコンテンツ構造をリファクタリングするとき
基本原則
- コンテンツはページではなくデータです — 表現方法ではなく意味に基づいてコンテンツを構造化します
- 信頼できる唯一の情報源 — コンテンツの重複を避けます
- 将来に備える — まだ存在しないチャネルも想定して設計します
- 編集者を中心にする — コンテンツを作成する人々にとって使いやすいよう最適化します
参考資料
すべてのトピックを一度に読み込むのではなく、取り組んでいるモデリング上の判断に合った参考資料から始めてください。特定のトピックに関する詳しいガイダンスは references/ を参照してください。
references/separation-of-concerns.md— コンテンツとプレゼンテーションの分離references/reference-vs-embedding.md— 参照と埋め込みオブジェクトを使い分ける方法references/content-reuse.md— コンテンツ再利用のパターンと再利用の段階references/taxonomy-classification.md— フラット、階層型、ファセット型の分類
コメント
Markdown 対応