技能介绍
qiaomu-website-develop 是一个网站开发与自动化部署技能，作者是乔木（joeseesun，产品经理，拥有 180+ repos 的高产创作者）。
它的用法很直接：你说「用这个域名部署一下」，Agent 就按固定流程完成 GitHub、Vercel、Cloudflare DNS 和 HTTPS 验证——一键走完从代码推送到域名上线及 HTTPS 验证的全流程。
适用场景
- 网站发布时，需要自动化部署到 Vercel 并绑定自定义域名。
- 需要确保 GitHub、Vercel、Cloudflare DNS 和 HTTPS 验证的完整流程无误。
- 域名已经在 Cloudflare 托管，想让 Agent 直接用 CLI 设置到 Vercel 项目上。
- 想换发布通道（例如以后用 Cloudflare Pages 发布，域名换成另一个子域）。
核心能力
- 检查 CLI 登录状态。
- 本地构建项目。
- 推送代码到 GitHub。
- 在 Vercel 中 link、deploy、连接 Git 仓库。
- 添加自定义域名到 Vercel。
- 在 Cloudflare 中写入 TXT、CNAME、A 记录。
- 执行 Vercel 域名验证。
- 通过 curl 验证 HTTPS 访问是否正常。
常见问题处理
↔ 左右滑动查看完整表格
| 问题 | 处理 |
|---|---|
| wrangler whoami 正常但 DNS 写入失败 | Wrangler OAuth 不等于脚本可写 DNS。设置 Cloudflare API token，并给目标 zone 的 zone read 和 DNS edit/write 权限。 |
| Vercel 显示 domain verification required | 让脚本写入 Vercel 返回的 TXT 记录，然后重新调用 verify。 |
| Vercel 显示 DNS misconfigured | 检查同名 A/AAAA/CNAME 冲突；Vercel 子域名 CNAME 默认应关闭 Cloudflare proxy。 |
| apex 域名不能设置 CNAME | apex 用 Vercel 推荐的 A 记录；子域名才用 CNAME。 |
安全提醒
不要把 API token 写入仓库、README、脚本或聊天总结。如果 token 曾经被贴出来，用完后建议到 Cloudflare 里轮换。
效果预览
已验证样例：
↔ 左右滑动查看完整表格
| 项目 | 结果 |
|---|---|
| GitHub | https://github.com/joeseesun/qiaomu-artist-style |
| Vercel project | qiaomu-artist-style |
| Vercel URL | https://qiaomu-artist-style.vercel.app |
| Custom domain | https://style.qiaomu.ai |
| Cloudflare DNS | TXT 验证 + 非代理 CNAME |
| 最终验证 | curl -I https://style.qiaomu.ai 返回 HTTP/2 200 |
工作方式
- 用户用自然语言提出部署请求，例如：「把这个网站发布到 Vercel，并绑定 style.qiaomu.ai」。
- Agent 按照固定流程依次执行：检查 CLI 登录 → 本地构建 → GitHub 推送 → Vercel link/deploy/git connect → Vercel 添加域名 → Cloudflare 写 DNS 记录 → Vercel verify → curl 验证 HTTPS。
- 最终输出部署成功的 URL 和验证结果。
技能内置自动化脚本，支持先 dry-run 再执行。
你需要提供
- 安装并登录 GitHub CLI：
brew install gh && gh auth login。 - 安装并登录 Vercel CLI：
npm i -g vercel && vercel login。 - 安装并登录 Wrangler：
npm i -g wrangler && wrangler login。 - Cloudflare DNS 写入时，设置
CLOUDFLARE_API_TOKEN或CF_API_TOKEN。 - Cloudflare API token 至少具备目标 zone 的 zone read 和 DNS edit/write 权限。
你会获得
- 部署后的 Vercel 项目。
- 自定义域名绑定成功。
- HTTPS 验证通过，可通过
curl -I获得HTTP/2 200响应。
使用示例
可以直接这样下达指令：
把这个项目部署到 Vercel，绑定 style.qiaomu.ai，并关联 GitHub。以后这个 Web 项目用 Cloudflare Pages 发布，域名用 demo.qiaomu.ai。这个域名在 Cloudflare 托管，你直接用 CLI 帮我设置到 Vercel 项目上。内置自动化脚本，先 dry-run：
python3 ~/.agents/skills/qiaomu-website-develop/scripts/qiaomu_site_deploy.py \
vercel-cloudflare \
--project-dir . \
--domain style.qiaomu.ai \
--dry-run执行 Vercel + Cloudflare 绑定：
export CLOUDFLARE_API_TOKEN="..."
python3 ~/.agents/skills/qiaomu-website-develop/scripts/qiaomu_site_deploy.py \
vercel-cloudflare \
--project-dir . \
--domain style.qiaomu.ai \
--ensure-link \
--connect-git \
--deploy \
--wait \
--check-http
