static-site-generation

本技能为使用现代静态网站生成器 (SSG) 框架构建高性能、以内容为中心的网站提供结构化方法。专为开发人员和技术写作者设计，在选择 Astro、Next.js 和 VitePress 等框架时，有助于进行架构决策。本技能着重于平衡严格的层次结构与灵活的网状内容模式，利用 TypeScript 进行架构验证，并使用 MDX 创建丰富的交互式文档组件。

• 基于 TypeScript 支持、MDX 集成与构建性能指标的框架评估与选择。

• 使用 Zod 模式实现类型安全的内容集合，以便进行结构化数据管理。

• 利用 GitHub Actions 和 GitHub Pages 的标准化部署工作流程，进行自动化且零停机的发布。

• 针对单页应用程序 (SPA) 的基础路径 (base path)、子路径托管与 404 错误处理的配置模式。

• 针对 bundle 大小、代码分割 (code splitting) 与延迟加载 (lazy loading) 的优化策略，以确保快速的页面加载。

• 使用所提供的决策模板来记录选择或迁移 SSG 框架时的架构权衡。

• 在进行 CI/CD 部署之前，遵循构建优化检查清单，确保严格的 TypeScript 相容性与正确的资源路径解析。

• 输入包括 Markdown 或 MDX 来源文件、Zod 模式以及框架特定的配置文件（例如 astro.config.mjs）。

• 输出包括可随时部署的静态资产、经过验证的内容集合与记录完善的项目结构。

• 约束：确保所有资产与路由路径皆针对 GitHub Pages 相容性进行配置，特别是正确处理网站的基础路径。