GitHub Pages 静态站自动部署
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-web-deploy-github。
技能介绍
要解决什么问题
很多人把静态站放在 GitHub Pages,但手搓目录、gh-pages 分支和 Actions 工作流时,容易漏掉 Pages 源分支配置、首次推送或 workflow 语法错误。作品集、落地页往往是单页 HTML/CSS/JS,却还要单独维护一套「能上线」的发布流程。
技能如何工作
本技能按 初始化 → 开发 → 建仓 → 自动发布 走完整链路。init_project.sh 搭好项目骨架;开发侧强调 单页优先、尽量无构建依赖,并可用 assets/templates/ 下的 base-html/、portfolio/、landing/ 作为起点,生成可上线的完整页面而非占位符。
GitHub 侧由 deploy_github_pages.sh 完成:git init、通过 GitHub CLI 创建仓库、配置 Pages、首次提交推送并触发部署。推送 main 后,.github/workflows/deploy.yml 模板驱动 Actions:检出代码、部署到 gh-pages,站点最终以 https://<username>.github.io/<repo>/ 形式可访问。架构上覆盖语义化 HTML、SEO meta、移动优先布局、可选暗色主题,以及以原生 JS 为主的渐进增强。
适用边界与注意点
适合 单页应用、作品集/CV、产品落地页 等静态场景;多页站点仅在需求明确时再扩展。需要本机已安装并登录 gh(gh auth status),且对目标仓库有创建与 Pages 权限。若 Pages 未更新,应核对 Settings → Pages 源是否为 gh-pages、Actions 是否成功,DNS 生效有时需数分钟。
使用场景
- 接到法语/英语口头需求「帮我做一份在线 CV 作品集」,需要从零生成完整区块并推到个人 GitHub Pages
- 为新应用做单页落地页(Hero、功能、定价、CTA),要求响应式样式且 push 后自动上线
- Hackathon 或侧项目需要最快路径:初始化目录、用 landing 模板改文案,并完成首次 gh-pages 部署
- 本地已有单页 HTML,但团队没有统一流程,需要按脚本创建仓库并挂上标准 deploy workflow
适合人员
- 独立开发者:想用 GitHub Pages 托管个人简历站,又不想手写 Actions 与 Pages 分支配置
- 前端/全栈工程师:接落地页或营销单页需求,希望 Agent 按模板产出完整代码并走 gh CLI 发布
- 开源贡献者:为 demo 或文档站快速建仓,需要与 `references/workflow.md` 一致的固定发布步骤
- 不熟悉 GitHub 发布链路的初学者:已会用 HTML/CSS,需要可复现的 init 与 deploy 脚本降低首次上线失败率