joeseesun/qiaomu-website-develop
GitHub: joeseesun/qiaomu-website-develop
该项目是一个 AI Agent 部署技能,将网站发布到 Vercel 或 Cloudflare 并绑定自定义域名的整套运维流程自动化和标准化。
Stars: 6 | Forks: 5
# qiaomu-website-develop
```
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
### 它的作用
这个 skill 将网站发布转化为一个可重复的运维工作流:本地验证、GitHub 推送、Vercel 部署、Vercel 与 GitHub 的连接、Cloudflare DNS 更新、Vercel 域名验证以及最终的 HTTPS 检查。
当你希望 Agent 处理以下请求时使用它:
```
Deploy this site to Vercel and bind style.qiaomu.ai.
```
### 安装
```
npx skills add joeseesun/qiaomu-website-develop
```
### 前置条件
- [ ] GitHub CLI 已通过 `gh auth status` 认证
- [ ] Vercel CLI 已通过 `vercel whoami` 认证
- [ ] Wrangler 已通过 `wrangler whoami` 认证
- [ ] 用于 Cloudflare DNS 写入的 `CLOUDFLARE_API_TOKEN` 或 `CF_API_TOKEN`
### 参考
- Vercel CLI 部署文档: https://vercel.com/docs/cli/deploying-from-cli
- Vercel CLI Git 文档: https://vercel.com/docs/cli/git
- Vercel 项目域名 API 文档: https://vercel.com/docs/rest-api/reference/endpoints/projects/add-a-domain-to-a-project
- Cloudflare API token 权限说明: https://developers.cloudflare.com/fundamentals/api/reference/permissions/
## License
MIT
标签:AI插件, Cloudflare, MITRE ATT&CK, OSV, Syscall, Vercel, Web开发, 域名配置, 特权提升, 自动化部署, 逆向工具, 高对比度