content-modeling-best-practices

作者： sanity-io

結構化內容建模指南，涵蓋綱要設計、可重用性與多渠道發布。核心原則包括：將內容視為數據而非頁面、維護單一事實來源、為未來渠道設計，以及優化編輯工作流程。提供關於引用與嵌入物件、關注點分離及內容重用模式的決策框架。包含針對扁平、階層與分面分類法的分類學指引。適用於...

npx skills add https://github.com/sanity-io/agent-toolkit --skill content-modeling-best-practices

下載 ZIP GitHub

176

Content Modeling Best Practices

Principles for designing structured content that's flexible, reusable, and maintainable. These concepts apply to any headless CMS but include Sanity-specific implementation notes.

When to Apply

Reference these guidelines when:

Starting a new project and designing the content model
Evaluating whether content should be structured or free-form
Deciding between references and embedded content
Planning for multi-channel content delivery
Refactoring existing content structures

Core Principles

Content is data, not pages — Structure content for meaning, not presentation
Single source of truth — Avoid content duplication
Future-proof — Design for channels that don't exist yet
Editor-centric — Optimize for the people creating content

References

Start with the reference that matches the modeling decision in front of you, instead of loading every topic at once. See references/ for detailed guidance on specific topics:

references/separation-of-concerns.md — Separating content from presentation
references/reference-vs-embedding.md — When to use references vs embedded objects
references/content-reuse.md — Content reuse patterns and the reuse spectrum
references/taxonomy-classification.md — Flat, hierarchical, and faceted classification