技能介绍

它解决什么问题

临时做一个页面，本不该这么重：打开编辑器、写模板、配本地环境、注册托管账号、提交仓库、绑定平台……还没写一行正文，精力已经耗尽。

这个技能把路径压成一句话：说明需求 → AI 生成静态页 → 人工预览确认 → 推送到 GitHub → 由 Cloudflare Pages 部署上线。页面代码在本地即可预览，确认前不会触碰任何外部写入动作，适合临时性、低频更新的展示需求。

核心能力与流程

双模式：Mode A 从零生成，流程是需求收集、生成自包含 HTML（内联 CSS、响应式、单文件无外部依赖）、预览确认、采集凭证、创建仓库、推送、创建 Pages 项目、验证上线；Mode B 更新已有项目，直接按 projects.json 查到的仓库与分支推送变更并验证，不必重建项目。

凭证只临时使用：GitHub Token（repo 权限）用于推送，Cloudflare API Token 需要 Pages:Edit 与 Account:Read，Account ID 可通过 API 自动发现。凭证不写入 projects.json，避免长期落盘。

产物轻量：单文件 index.html 即可运行，完整站点则逐个推送资源文件，并附带 _headers 做安全与缓存控制。项目状态统一记录在 ~/.workbuddy/skills/static-page-deploy/projects.json，下次更新据此定位。

适用边界与注意点

适合：作品集、产品展示、邀请页、项目落地页等单页或少页场景。

不适合：依赖自然流量的网站，.pages.dev 二级域名在 Google/百度的收录与权重表现有限；需要后端、数据库、交易能力或后台管理的应用；高流量站点要考虑 Cloudflare Pages 免费版的带宽限制。这类需求更适合独立域名配合专业 SSG/CMS 或 Shopify/Supabase 等方案。

部署侧的坑同样要留意：production_branch 必须保持 main，否则可能指向 cloudflare/workers-autoconfig 分支导致内容陈旧或空白；项目名仅允许小写与短横线；首次部署必须由用户在浏览器完成 Cloudflare 对 GitHub 仓库的授权；涉及 Worker 与 Pages 时应使用独立仓库，避免分支冲突。