joeseesun/qiaomu-website-developGit

Qiaomu website deployment

Work through code delivery, domain setup and HTTPS verification.

Before you start

Inputs: Codebase, technical environment and acceptance criteria

  1. Check the original documentation for supported AI tools, models and runtime dependencies.
  2. Open the repository and follow the author’s installation instructions. Model APIs or external services may require separate accounts.
  3. Try your own material, then review the facts, layout and output files.
Read the original installation guide ↗

License: MIT

Source snapshot: 2026-09-15. README ↗

Original license & copyright
MIT License

Copyright (c) 2026 joeseesun

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Try a task like this

Use Qiaomu website deployment with my own source material. Confirm the required inputs and available tools, then produce an editable result.

qiaomu-website-develop

你说“用这个域名部署一下”，Agent 就按固定流程完成 GitHub、Vercel、Cloudflare DNS 和 HTTPS 验证。 When you ask for a website deployment with a domain, the agent follows a repeatable GitHub, Vercel, Cloudflare DNS, and HTTPS verification workflow.

npx skills add joeseesun/qiaomu-website-develop

中文

它解决什么

网站发布最容易漏的是这些小动作：Vercel 项目没连 GitHub、自定义域名加了但 TXT 没验证、Cloudflare CNAME 开了代理、DNS 改完没有重新让 Vercel verify。

这个 skill 把这套流程固定下来。以后你只要说：

把这个网站发布到 Vercel，并绑定 style.qiaomu.ai

Agent 会按同一条路径做：

检查 CLI 登录 -> 本地构建 -> GitHub 推送 -> Vercel link/deploy/git connect
-> Vercel 添加域名 -> Cloudflare 写 TXT/CNAME/A -> Vercel verify
-> curl 验证 HTTPS

已验证样例

项目结果
GitHubhttps://github.com/joeseesun/qiaomu-artist-style
Vercel projectqiaomu-artist-style
Vercel URLhttps://qiaomu-artist-style.vercel.app
Custom domainhttps://style.qiaomu.ai
Cloudflare DNSTXT 验证 + 非代理 CNAME
最终验证curl -I https://style.qiaomu.ai 返回 HTTP/2 200

前置条件

  • 安装并登录 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 权限

不要把 API token 写入仓库、README、脚本或聊天总结。如果 token 曾经被贴出来，用完后建议到 Cloudflare 里轮换。

自然语言触发示例

把这个项目部署到 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

常见问题

问题处理
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 域名不能设置 CNAMEapex 用 Vercel 推荐的 A 记录；子域名才用 CNAME。

English

What It Does

This skill turns website delivery into a repeatable operational workflow: local verification, GitHub push, Vercel deploy, Vercel-GitHub connection, Cloudflare DNS updates, Vercel domain verification, and final HTTPS checks.

Use it when you want an agent to handle requests such as:

Deploy this site to Vercel and bind style.qiaomu.ai.

Install

npx skills add joeseesun/qiaomu-website-develop

Requirements

  • GitHub CLI authenticated with gh auth status
  • Vercel CLI authenticated with vercel whoami
  • Wrangler authenticated with wrangler whoami
  • CLOUDFLARE_API_TOKEN or CF_API_TOKEN for Cloudflare DNS writes

References

License

MIT

Explore related skills

Rootloom engineering workflows ↗Matt Pocock coding skills ↗Addy Osmani engineering skills ↗