Communitygithub.com

6mb-Systems/sg-website

使用 Sanity CMS 与 Next.js App Router 实现博客,支持增量静态再生(ISR)和可选的预览功能。

sg-website 是什么?

该技能指导开发者如何利用 Sanity CMS 作为内容源,结合 Next.js App Router 构建一个完整的企业级博客系统。技能详细说明了如何定义 Sanity 的 `post` schema(包括标题、摘要、发布时间、主图、正文、作者、分类和 SEO 字段),并强调了生产环境下的最佳实践:区分草稿和已发布内容,优先使用基于时间的 ISR 实现页面静态化与自动更新,严格避免向客户端暴露写令牌,仅使用只读令牌获取前端数据。它还涵盖了如何实现基于 GROQ 查询的数据获取,以及可选的可预览编辑功能,确保内容管理既安全又高效。适合需要快速搭建或扩展 Sanity 驱动博客的开发者,支持语言环境为简体中文。

兼容平台~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 博客

关于构建和维护与 Next.js 集成的 Sanity 驱动博客的指南。

何时使用

  • 实现 /blog 或 /blog/[slug] 路由
  • 设置或修改 Sanity 的 schema
  • 使用 GROQ 从 Sanity 获取内容
  • 添加重新验证或预览功能

说明

  • 将 Sanity 作为博客内容的事实来源。
  • 定义一个 post schema,包含以下字段:
    • title, slug, excerpt
    • publishedAt
    • mainImage(含替代文本)
    • body(可移植文本)
    • 可选:author, categories/tags
    • SEO 字段(meta title, description, OG image)
  • 对于公开页面,过滤掉草稿,除非处于预览模式。
  • 以静态优先的方式渲染博客页面,并启用重新验证。
  • 除非需要精确的 webhook 重新验证,否则优先使用基于时间的 ISR。
  • 绝不将 Sanity 的写令牌暴露给客户端。
  • 使用只读令牌进行前端数据获取。
  • 仅在要求时实现预览/可视化编辑。
  • 如果预览、定时发布或重新验证行为不明确,请提出澄清性问题。

Individual skills in this repo

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

相关技能