content-modeling-best-practices

content-modeling-best-practices 技能總覽

這個技能的用途

content-modeling-best-practices 技能能幫你設計結構化內容，讓內容可重複使用、方便編輯，而且不會被綁死在單一頁面版型上。當你在決定欄位形狀、判斷哪些內容應該用引用、哪些應該直接嵌入，或是在重構一個已經過度受版面驅動的 schema 時，這個技能特別有用。

適合誰使用

如果你在 Sanity 或其他 headless CMS 中工作，並且需要一份實用的 content-modeling-best-practices guide，給內容架構師、schema 作者，以及負責內容模型的開發者使用，就很適合用這個 content-modeling-best-practices skill。對於正在建立 Design Systems、而且內容必須能承受改版並跨通路運作的團隊，尤其相關。

為什麼重要

這個技能的核心任務，是在建模錯誤擴散之前先把它們降到最低：重複內容、脆弱的頁面專用欄位、以及無法擴充的分類法。當決策重點是結構，而不是文案時，這個技能最能發揮作用。

最適合與不適合的情境

它很適合用在新 schema、遷移、可重用元件，以及全通路內容規劃上。相對地，它不太適合純視覺 UI prompt 工作、一次性的頁面文案，或是內容結構已經固定、只需要改字的情境。

如何使用 content-modeling-best-practices 技能

安裝並觸發它

如果要執行 content-modeling-best-practices install，先透過 repo 的 skill loader 加入這個技能，然後在包含你要解決的 schema 問題的工作流程中呼叫它：npx skills add sanity-io/agent-toolkit --skill content-modeling-best-practices。這個技能最適合在你要的是一個建模決策，而不是泛泛的「幫我改善 CMS」時使用。

提供正確的輸入

好的 content-modeling-best-practices usage 會從一個具體情境開始：你在建模什麼內容型別、誰來編輯、會出現在哪裡，以及是否必須重複使用。例如，「替 landing pages 和 case studies 設計一套 testimonial 系統，包含共享的作者資料與頁面專屬的顯示選項」就比「設計 testimonials」好得多。

先讀對的檔案

先從 SKILL.md 看起，再打開最相關的參考資料，不要一開始就把所有內容都掃過一遍。最有用的路徑是 references/reference-vs-embedding.md、references/content-reuse.md、references/separation-of-concerns.md 和 references/taxonomy-classification.md。這些檔案直接對應到這個技能最想改善的主要決策。

使用以決策為核心的工作流程

把粗略想法轉成一個明確點出取捨的 prompt，例如：「這個應該是 reference 還是 embedded object？」或「這個 taxonomy 應該是 flat 還是 hierarchical？」同時加入限制條件，例如編輯流程、內容擁有權、在地化，以及 API 形狀。這樣才能提供足夠脈絡，讓技能產出可執行的模型，而不是抽象建議。

content-modeling-best-practices 技能 FAQ

這個技能只適用於 Sanity 嗎？

不是。這套指引是 CMS 無關的，但範例和實作說明是以 Sanity 為主。如果你用的是其他 headless CMS，同樣的建模原則仍然適用，只是欄位語法會不同。

這跟一般 prompt 有什麼不同？

一般 prompt 可能只會給你泛用的 schema 建議。content-modeling-best-practices skill 更偏向決策層面：它聚焦在內容重用、內容與呈現的分離，以及 reference 與 embedding 的取捨，而這些通常正是決定模型能不能長期維護的關鍵。

什麼時候不該用它？

當問題純粹是視覺版面、短篇行銷文案，或前端元件樣式時，就不需要優先用它。如果內容結構已經存在，你只需要改文案，這個技能帶來的價值通常會比一般編輯型 prompt 少。

對 Design Systems 工作有幫助嗎？

有，特別是 content-modeling-best-practices for Design Systems 這種情境：內容區塊、共享欄位集合，以及可重用定義都必須和 component library 對齊。它能幫你把 system tokens、編輯內容和 schema 邊界清楚分開。

如何改進 content-modeling-best-practices 技能

明確說出要做的建模決策

提升結果最快的方法，就是直接請技能解決某個特定決策：要用 reference 還是 embed、分類法要 flat 還是 hierarchical、要做可重用區塊還是頁面限定欄位。決策越明確，輸出越不容易跑到空泛理論。

加入會改變答案的限制條件

請說明內容是否需要在地化、是否會跨頁重用、是否由非開發者編輯、以及是否預期要獨立變動。這些限制往往正是決定正確模型的關鍵，尤其是在多通路系統中的 content-modeling-best-practices。

提供一份有問題的草稿，不要只給目標

如果你已經有 schema，就直接貼出目前的欄位名稱，並說明你覺得哪裡不對。這樣技能就能診斷出像是頁面式命名、資料重複、或權責不清等問題，而不是從零憑空設計一個模型。

透過測試模型來反覆修正

第一次得到答案後，可以再問：如果網站改版、增加第二個通路，或共享內容需要一次更新，哪裡會壞掉？這些測試能及早暴露脆弱假設，通常也比只跑一次，更容易得到更好的 content-modeling-best-practices guide 輸出。