Blog

搭建博客

帮用户快速生成一个可以直接使用的个人博客网站。

步骤

1. 了解需求

依次提问（每次一个）：

问题 1：博客用途 > 这个博客是做什么的？比如技术分享、个人日记、作品集。

问题 2：技术偏好 > 你想用什么方案？从简单到复杂排列： > - 纯 Markdown + GitHub Pages — 零配置，写完 push 就上线，适合只想写文章不想折腾的人 > - Hugo — Go 编写的静态站点生成器，构建极快（毫秒级），不需要 Node.js 环境 > - 11ty (Eleventy) — 轻量 Node.js 静态生成器，模板灵活，零客户端 JS > - Astro — 支持 Markdown + 组件混写，内置代码高亮和 RSS，适合技术博客 > - Next.js — 适合需要动态功能（评论、搜索、用户系统）的博客 > - 纯静态 HTML — 完全手写，适合想学前端基础的新手 > 不确定的话我根据你的用途帮你选。

问题 3：风格偏好 > 喜欢什么风格？ > - 简约 — 大量留白，黑白灰主色，内容为中心（类似 Medium） > - 技术感 — 深色主题，等宽字体，终端风格配色 > - 文艺 — 衬线字体，暖色调，杂志排版感 > - 文档风 — 侧边栏导航，适合系列教程或知识库 > 没想法我来选。

2. 生成博客

根据选择生成完整的博客项目：

• 首页 — 文章列表，按时间倒序
• 文章页 — 支持 Markdown 渲染，代码高亮
• 关于页 — 个人介绍
• 示例文章 — 2-3 篇示例文章，展示 Markdown 用法
• SEO — meta 标签、Open Graph、sitemap

技术要求：

• 响应式布局，移动端友好
• 配色和谐，排版专业
• 纯 Markdown/GitHub Pages 方案：只需一个仓库，README 或 index.md 即可
• Hugo/11ty 方案：提供本地预览命令和构建命令
• 如果是纯静态 HTML 方案，单文件夹即可运行

3. 验证和调整

> 博客已生成，用浏览器打开预览。 > 想调整什么？比如换颜色、改布局、加功能。

迭代修改直到满意。完成后提示： > 用 /deploy 可以把博客部署上线。

遇到问题

• 构建失败 — 先检查 Node.js / Hugo / Ruby 版本是否匹配项目要求；删除 node_modules 和 lock 文件后重新安装
• GitHub Pages 部署后页面空白 — 检查仓库 Settings > Pages 中 Source 分支和目录是否正确；确认 baseURL 配置与实际域名一致
• Markdown 渲染异常（图片不显示、代码块错乱） — 检查图片路径是否用相对路径；代码块确认用三个反引号且语言标识正确
• 样式在本地正常但部署后丢失 — 检查 CSS/资源路径是否用了绝对路径 / 开头，GitHub Pages 子目录部署需要加 baseURL 前缀
• RSS 订阅不工作 — 确认生成了 feed.xml 或 rss.xml，且 head 中有对应的 link 标签

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: lightpointventures
• Source: lightpointventures/claude-code-starter
• License: MIT
• Homepage: https://github.com/lighthouse-strategy/claude-code-starter

Install and usage instructions live in the source repository linked above.