用途:为文档站点检查并配置 GitHub Pages 部署。适用于设置 Pages、为已有文档生成器添加 Pages 部署、创建或更新 GitHub Actions 工作流、将 peaceiris/actions-gh-pages 迁移到官方 actions/deploy-pages,以及审计工作流中过期的 action 版本或缺失的权限。不适用于配置文档标准或生成器(用 /configure:docs)、调试失败的工作流(用 /configure:workflows)、编辑文档内容、通过 DNS 设置自定义域名,或与文档无关的 CI/CD。
主要能力:检测文档生成器(TypeDoc、MkDocs、Sphinx、Docusaurus、rustdoc 或静态 HTML)及输出目录;分析已有 Pages 工作流;按标准校验 action 版本(deploy-pages v5+、configure-pages v6+、upload-pages-artifact v5+)、权限(pages: write、id-token: write,缺失记为 FAIL)、环境(github-pages)与并发;生成合规报告;创建或更新 .github/workflows/docs.yml;更新 .project-standards.yaml;输出部署后说明与站点 URL。
使用方式:执行 /configure:github-pages,可用参数 --check-only(仅报告,不修改,适合 CI/CD)、--fix(自动修复不提示)、--source <docs|site|custom>(覆盖源目录检测)。常用命令包括 /configure:github-pages --check-only 与 --fix;检查工作流可用 find .github/workflows -name 'pages' -o -name 'doc' 2>/dev/null;查看 Pages 状态用 gh api repos/{owner}/{repo}/pages --jq '.status',部署状态用 gh api repos/{owner}/{repo}/pages/builds --jq '.[0].status'。
限制:仅覆盖配置与审计流程;工作流模板细节需参见资料中的 REFERENCE.md,本次资料未提供其内容。自定义域名、环境防护规则等需在仓库设置中手动完成。其余具体行为暂未提供。