背景

原有个人网站采用纯 HTML 手工维护,37 个页面的更新成本越来越高。希望迁移到静态网站生成器,同时建立一套可持续的内容管理流程。

挑战

  1. 原有内容格式混乱,缺乏统一规范
  2. 需要在保留内容的同时完成技术栈迁移
  3. 希望引入 AI 辅助内容整理,但需保证质量可控
  4. 视觉设计需要从零开始

方案

选择 Jekyll + GitHub Pages 作为技术栈,原因:

  • GitHub Pages 原生支持,无需额外服务器
  • Markdown 写作友好,降低维护门槛
  • 社区成熟,主题和插件丰富

引入三层内容管道:

drafts/ → AI 整理 → content/ → Jekyll 构建 → 发布

实施过程

第一阶段:架构设计

  • 设计目录结构与 Jekyll 配置
  • 创建 STYLE-GUIDE.md 作为通用转换规范
  • 编写 CLAUDE.md 作为 Claude Code 项目规则

第二阶段:视觉开发

  • 设计深空暗紫主题(SCSS 模块化架构)
  • 实现磨砂玻璃卡片、渐变文字等视觉效果
  • 完成响应式布局适配

第三阶段:内容迁移

  • 使用 AI 工具批量转换旧页面为 Markdown
  • 人工审核每篇转换结果
  • 建立模板与提示词系统

成果

  • 从 37 个 HTML 页面迁移到 Jekyll 站点
  • 建立了 6 个内容分类的知识库结构
  • 内容更新效率提升:从手动编辑 HTML 到 Markdown 写作
  • AI 辅助整理的内容质量通过人工审核把关

经验总结

  1. AI 是加速器,不是替代品:所有 AI 输出都需要人工审核
  2. 规范先行:STYLE-GUIDE.md 让多个 AI 工具都能产出一致的结果
  3. 渐进迁移:分阶段实施降低了风险
  4. 模板化:内容模板和转换提示词大幅减少重复劳动