用途:该技能面向单页静态网站,提供从项目初始化到 GitHub Pages 自动部署的完整流程,适合作品集、CV 页面、落地页等场景。
主要能力:
- 项目初始化:执行 bash scripts/init_project.sh <project-name>,生成包含 index.html、styles.css、script.js、README.md 及 .github/workflows/deploy.yml 的结构。
- 开发规范:单页优先,生成完整可用的生产级代码;使用现代 CSS(flexbox、grid)、响应式设计、CSS 变量主题、过渡动画,支持暗色模式;优先原生 HTML/CSS/JS,需要框架时使用 CDN 链接。
- 模板:assets/templates/ 提供 base-html(最小 HTML5 样板)、portfolio(含分区的作品集/CV 模板)、landing(含 hero 与 CTA 的落地页模板)。
- 仓库与部署:执行 bash scripts/deploy_github_pages.sh <project-name> <github-username>,脚本初始化 git 仓库、通过 GitHub CLI 创建仓库、配置 GitHub Pages、推送初始提交并触发首次部署。GitHub Actions 在推送到 main 分支后自动部署到 gh-pages 分支,站点地址为 https://<username>.github.io/<project-name>/。
使用方式:先运行初始化脚本创建结构,基于模板开发页面,再运行部署脚本传入项目名与 GitHub 用户名。需确保 gh CLI 已认证,可用 gh auth status 检查。
限制与排查:部署未生效时检查仓库 Settings → Pages 的 Source 是否设为 gh-pages 分支、Actions 工作流是否成功、DNS 传播可能需 5-10 分钟;构建失败需查看 Actions 日志并核对 deploy.yml 语法与文件路径。其他功能、收费与平台信息暂未提供。