name: docusaurus-deployer version: 1.2 description: 这个技能应该在部署Docusaurus站点到GitHub Pages时使用。它自动化了配置、构建和部署流程，处理GitHub Pages设置、环境配置和CI/CD自动化。包括在CI/CD触发前进行本地验证。 constitution_alignment: v4.0.1

Docusaurus GitHub Pages Deployer

自动化构建和部署Docusaurus文档站点到GitHub Pages，并在CI/CD触发前进行本地验证。

宪法对齐：这个技能实现了宪法v4.0.1（第I节第9节：通用云原生部署）中定义的生产部署标准。所有部署必须在发布前满足项目质量门。

当：

遵循本地验证然后发布工作流程：

收集GitHub组织/用户名，仓库名称，部署目标（用户/项目页面），以及自定义域名（可选）。

检查Docusaurus项目：

ls -la path_to_docusaurus_project/
cat path_to_docusaurus_project/docusaurus.config.ts
cat path_to_docusaurus_project/sidebars.ts

验证docusaurus.config.ts，sidebars.js/ts，package.json引擎字段，以及依赖项是否存在。

有关详细配置指导，请参阅references/configuration-guide.md。

更新docusaurus.config.ts为GitHub Pages设置。根据部署目标（用户vs.项目页面），请参阅references/configuration-guide.md中的完整配置示例和指南。

安装依赖项，运行类型检查，构建站点，验证输出，本地测试，并验证内容质量。

执行：

npm ci
npm run typecheck
npm run build
npm run serve

有关详细验证程序，请参阅references/local-validation-guide.md。

在本地验证成功后：

git add .
git commit -m "Update documentation: [description]"
git push origin main

这将触发GitHub Actions工作流。

使用references/deploy-workflow.yml中的模板创建.github/workflows/deploy.yml。

有关详细工作流配置和故障排除，请参阅references/github-actions-guide.md。

检查GitHub Actions工作流状态在Actions标签页，验证站点在配置的URL加载，并确认所有导航工作正常。

有关常见问题和解决方案，请参阅references/troubleshooting.md，涵盖：

在生产部署前，验证：

参考：有关完整的生产部署标准，请参阅.specify/memory/constitution.md中的部署标准部分。