Communitygithub.com

6mb-Systems/sg-website

使用 Sanity CMS 搭配 Next.js App Router、ISR 及選用預覽功能,實作部落格。

sg-website 是什麼?

此技能提供使用 Sanity CMS 與 Next.js App Router 建置部落格的完整指引。它涵蓋從定義 Sanity 內容模型(如 post schema)到透過 GROQ 查詢語法擷取資料的整個流程。此技能的重點在於以靜態為基礎搭配增量靜態再生(ISR)的呈現策略,同時支援選用的預覽模式,讓內容編輯者可以在發布前預覽草稿。它強烈建議區分讀取權杖與寫入權杖,以確保前端資料擷取的安全,避免將寫入權杖暴露給客戶端。此技能適用於 Claude Code、Cursor 或 Codex 等 AI 代理工具,幫助開發者快速建立具備即時預覽與排程發布功能的部落格平台。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/6mb-Systems/sg-website/tree/HEAD/.cursor/skills/sanity-blog

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Sanity 部落格

使用 Sanity 驅動、與 Next.js 整合的部落格建置與維護指引。

使用時機

  • 實作 /blog 或 /blog/[slug] 路由
  • 設定或修改 Sanity 內容結構 (schema)
  • 使用 GROQ 從 Sanity 擷取內容
  • 加入重新驗證 (revalidation) 或預覽 (preview) 功能

指示

  • 使用 Sanity 作為部落格內容的單一事實來源。
  • 定義 post 內容結構 (schema),包含:
    • title, slug, excerpt
    • publishedAt
    • mainImage(附替代文字)
    • body(可攜式文字)
    • 選用的 author, categories/tags
    • SEO 欄位(meta 標題、描述、OG 圖片)
  • 除非啟用預覽模式,否則公開頁面應過濾掉草稿。
  • 部落格頁面以靜態優先搭配重新驗證來呈現。
  • 除非需要精確的 webhook 重新驗證,否則優先採用基於時間的 ISR。
  • 絕不將 Sanity 寫入權杖暴露給客戶端。
  • 前端資料擷取使用唯讀權杖。
  • 僅在要求時實作預覽/可視化編輯功能。
  • 若預覽、排程或重新驗證的行為不明確,請提出釐清問題。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

相關技能