joeseesun/qiaomu-website-developGit

乔木网站开发自动化部署

完成代码推送、域名上线与 HTTPS 验证。

使用前，准备这些

输入素材：代码库、技术环境与任务验收条件

在下方原始文档中确认支持的 AI 工具、模型和运行依赖。
打开原仓库，按作者的安装说明完成配置；模型 API 或外部服务可能需要单独开通。
用自己的素材试运行，再检查事实、版式与输出文件。

许可证：MIT

来源快照：2026-09-15。README ↗

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.

可以这样开始

使用这个 Skill 完成「乔木网站开发自动化部署」：完成代码推送、域名上线与 HTTPS 验证。请先确认必要输入，再交付一份可直接使用的结果。

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

已验证样例

项目	结果
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`

前置条件

安装并登录 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 域名不能设置 CNAME	apex 用 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

Vercel CLI deployment docs: https://vercel.com/docs/cli/deploying-from-cli
Vercel CLI git docs: https://vercel.com/docs/cli/git
Vercel project-domain API docs: https://vercel.com/docs/rest-api/reference/endpoints/projects/add-a-domain-to-a-project
Cloudflare API token permissions: https://developers.cloudflare.com/fundamentals/api/reference/permissions/

License

MIT