Qiaomu Website Develop

Use this skill when a request includes website delivery, deployment, GitHub linkage, Vercel production deploys, Cloudflare Pages/Workers deploys, or custom domain binding.

Boundary

This skill owns the operational path from a local web project to a public URL:

• inspect and prepare the web project
• ensure GitHub remote and pushed source when requested
• deploy with Vercel CLI or Wrangler
• connect Vercel projects to GitHub
• bind custom domains through Vercel and Cloudflare DNS
• verify HTTPS reachability

Do not use it for one-off DNS explanations, backend-only infrastructure unrelated to website delivery, or content-only edits that do not require publishing.

Execution Skeleton

1. Confirm the target project directory, desired public domain, hosting target, and whether GitHub/Vercel/Cloudflare should all be updated.
2. Run local readiness checks:
   • git status --short
   • gh auth status
   • vercel whoami
   • wrangler whoami
   • check CLOUDFLARE_API_TOKEN or CF_API_TOKEN only if Cloudflare DNS writes are required
3. Build and verify the project using the repository's existing package scripts before deployment.
4. If publishing source, create or confirm the GitHub repository, commit relevant changes, pull/rebase if needed, and push.
5. For Vercel:
   • run vercel link --yes or vercel link --yes --project <name>
   • run vercel git connect --yes after the GitHub remote exists
   • run vercel deploy --prod --yes
   • use scripts/qiaomu_site_deploy.py vercel-cloudflare for custom domain binding
6. For Cloudflare Pages or Workers, follow references/website-deploy-workflow.md and prefer wrangler pages deploy or wrangler deploy with explicit project names/domains.
7. Verify the final URL with curl -I -L https://<domain> and report the deployment URL, domain, DNS records changed, and any follow-up risks.

Domain Binding Script

Use the included script for the repeated Vercel + Cloudflare custom-domain workflow:

export CLOUDFLARE_API_TOKEN="..."
python3 /Users/joe/.agents/skills/qiaomu-website-develop/scripts/qiaomu_site_deploy.py \
  vercel-cloudflare \
  --project-dir /path/to/site \
  --domain style.qiaomu.ai \
  --connect-git \
  --deploy \
  --wait

Start with --dry-run when changing a new zone or production domain:

python3 /Users/joe/.agents/skills/qiaomu-website-develop/scripts/qiaomu_site_deploy.py \
  vercel-cloudflare \
  --project-dir . \
  --domain sub.example.com \
  --dry-run

Never write API tokens into repository files, READMEs, shell scripts, or skill files. If a token was pasted into chat, avoid echoing it and recommend rotating it after use.

References

• Deployment workflow: references/website-deploy-workflow.md
• Automation script: scripts/qiaomu_site_deploy.py