背景
原有个人网站采用纯 HTML 手工维护,37 个页面的更新成本越来越高。希望迁移到静态网站生成器,同时建立一套可持续的内容管理流程。
挑战
- 原有内容格式混乱,缺乏统一规范
- 需要在保留内容的同时完成技术栈迁移
- 希望引入 AI 辅助内容整理,但需保证质量可控
- 视觉设计需要从零开始
方案
选择 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 辅助整理的内容质量通过人工审核把关
经验总结
- AI 是加速器,不是替代品:所有 AI 输出都需要人工审核
- 规范先行:STYLE-GUIDE.md 让多个 AI 工具都能产出一致的结果
- 渐进迁移:分阶段实施降低了风险
- 模板化:内容模板和转换提示词大幅减少重复劳动