Communitygithub.com

zijieguo2003/博客搭建技能

从零开始快速搭建个人博客的指南。涵盖框架选择(Hugo、Hexo、Astro、Next.js)、主题配置、带 Frontmatter 的博客文章模板生成、部署到 GitHub Pages / Vercel / Cloudflare Pages,以及完整的 SEO 设置(站点地图、robots.txt、Open Graph、规范化 URL)。

博客搭建技能 是什么?

该技能帮助用户从零开始启动个人博客,覆盖全流程:框架选择、主题配置、博客文章模板生成、部署到主流平台以及全面的 SEO 设置。它适用于 Hugo、Hexo、Astro 和 Next.js 等流行框架,并能根据用户的技术背景和需求推荐最合适的方案。技能提供可直接使用的文件内容(YAML、TOML、GitHub Actions 配置),避免繁琐描述,并指出常见陷阱(如 Hugo 的 baseURL 和 Astro 的 site 字段)。支持的部署平台包括 GitHub Pages、Vercel 和 Cloudflare Pages,并提供完整的 CI/CD 工作流文件。最终目标是让用户获得一个具有正确规范化 URL、站点地图、robots.txt 和 Open Graph 标签的、可直接发布的生产级博客。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add zijieguo2003/blog-builder-skill

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

博客搭建器

帮助用户启动个人博客 —— 从框架选择到上线部署,并包含完整的 SEO。全流程:框架选择 -> 主题 -> 文章模板 -> 部署 -> SEO。

工作流程

第 1 步 —— 了解用户背景

询问(或从上下文推断):

  • 技术背景?(非技术人员 / JS 开发者 / Python 开发者 / 等等)
  • 从零开始还是已有现有站点?
  • 偏好的部署目标:GitHub Pages、Vercel、Cloudflare Pages?
  • 内容重点:写作、作品集、教程博客、文档?

第 2 步 —— 推荐框架

情况推荐
非技术人员,只想写作Hugo —— 零 JS,速度快,主题库庞大
已经会写 JS/TS,想要组件控制Astro —— 岛屿架构,开发体验极佳
喜爱主题生态,熟悉 NodeHexo —— 成熟的插件生态
React 开发者,想要完全控制Next.js —— App Router + MDX

给出推荐及简短理由。确认后再继续。

第 3 步 —— 框架设置

阅读相应的参考文件,引导用户完成安装和入门主题:

框架参考文件
Hugoreferences/hugo.md
Hexoreferences/hexo.md
Astroreferences/astro.md
Next.jsreferences/nextjs.md

第 4 步 —— 生成文章模板

生成一个可直接使用的文章模板文件,包含完整的 Frontmatter。 assets/post-templates/ 中的资源模板是起点 —— 复制并根据用户选择的主题和偏好进行调整。

第 5 步 —— 部署

阅读 references/deployment.md 了解相应的 CI/CD 工作流。提供完整的 GitHub Actions YAML,可直接提交。

关键提示:

  • GitHub Pages:推送到 .github/workflows/deploy.yml;在仓库设置中启用 Pages
  • Vercel:在控制台中连接仓库;设置框架预设和输出目录
  • Cloudflare Pages:构建命令 = npm run build,输出目录 = dist(Astro/Hexo/Next.js)或 public(Hugo)

第 6 步 —— SEO 配置

每个博客都需要:

  1. sitemap.xml —— 框架特定;见 references/.md
  2. robots.txt —— 提供实际文件内容,而不仅仅是描述
  3. Open Graph 标签 —— og:title、og:description、og:image、og:url 作为实际标记
  4. 规范化 URL —— 在配置中设置 baseURL / site,以便站点地图和 OG 标签正确工作

始终注意:站点 URL 必须在框架配置中设置,站点地图才能生成正确的绝对 URL。

指导原则

  • 提供实际文件内容(代码、YAML、TOML),而不仅仅是描述
  • 只包含关键的字段 —— 避免冗余样板
  • 指出一两个容易出错的地方(例如,Hugo 的 baseURL、Astro 的 site 字段)
  • 优先提供可直接复制粘贴的示例

相关技能