用途:指导在 GitHub 上创建、发布与维护 GitHub Pages 静态站点,并处理自定义域名与构建流程。
主要能力:区分用户/组织站点(仓库名须为 <username>.github.io,每账号仅一个)与项目站点(任意仓库,URL 为 https://<username>.github.io/<repo>);支持两种发布源:从分支部署(适合 Jekyll 与简单静态站点,可选 / 或 /docs 目录)与 GitHub Actions 工作流部署(适合 Hugo、Gatsby、Next.js 等自定义构建)。内置 Jekyll 支持,自动启用 jekyll-coffeescript、jekyll-paginate、jekyll-github-metadata 等插件,并列出无需额外配置的主题(如 Minima、Cayman、Architect 等),可用 remote_theme 引用远程主题。提供自定义域名指引:顶级域用 A/AAAA(185.199.108.153 等四组 A 记录与 2606:50c0:8000::153 等四组 AAAA),子域用 CNAME 指向 username.github.io,并提供 dig 验证命令。
使用方式:包含 QuickStart、CustomDomain、JekyllSetup、ActionsWorkflow、Troubleshoot、Deploy 等工作流,按用户意图路由;执行工作流时输出“Running the WorkflowName workflow from the GithubPages skill...”提示。_config.yml 中可设置 theme、title、description。附带 scripts/verify-dns.sh 与 scripts/check-site-status.sh 脚本及 DNS、Jekyll、Actions、故障排查等参考文件。
适用场景:静态站点托管、博客、项目文档页、自定义域绑定与非 Jekyll 生成器的自定义构建部署。
限制:公开仓库在 GitHub Free 可用,私有仓库需 Pro、Team 或 Enterprise;不支持服务端语言(PHP、Python、Ruby);禁止商业交易与电商;建议仓库与发布站点均不超过 1 GB,带宽约 100 GB/月、分支构建约 10 次/小时、部署超时 10 分钟。安全建议包括验证自定义域名以防接管、避免通配符 DNS、启用 HTTPS 强制、勿泄露密钥、停用站点后及时处理 DNS。具体价格与更多细节暂未提供。