spaceship-cloudflare-domain-dns-skill

Spaceship → Cloudflare DNS Skill

一个给中文新手使用的 Codex Skill：让 AI 按照安全流程，把在 Spaceship 购买的域名接入 Cloudflare DNS。

它不保存你的账号、密码或 API Token，也不会把某个域名的 Cloudflare nameserver 套到其他域名上。

[!WARNING] 修改 nameserver 会改变整个域名的 DNS 管理方。遗漏网站、邮箱或验证记录，可能导致网站打不开或邮件收不到。本 Skill 会在切换前要求核对关键记录，但你仍应确认域名和记录属于自己。

它能做什么

• 检查 Cloudflare 中是否已有对应域名；
• 添加 Cloudflare Zone，并读取该域名专属的两个 nameserver；
• 切换前核对网站和邮箱需要的 A、CNAME、MX、TXT 等记录；
• 在 Spaceship Domain Manager 中修改 registrar nameserver；
• 区分“Spaceship 已保存”“Cloudflare 已激活”和“公网 DNS 已传播”三种状态；
• 在域名、记录或授权不明确时停止操作，避免误改。

使用前准备

你需要：

1. 已安装支持 SKILL.md 的 Codex；
2. 能让 Codex 操作浏览器，或自己按它给出的步骤点击；
3. 自己的 Spaceship 和 Cloudflare 账号；
4. 对目标域名有管理权限。

建议先在浏览器中登录 Spaceship 和 Cloudflare。不要把密码、Cookie、API Token 或验证码粘贴到聊天里。

一键安装（macOS / Linux）

git clone https://github.com/linyangqing99/spaceship-cloudflare-domain-dns-skill.git
cd spaceship-cloudflare-domain-dns-skill
bash install.sh

安装脚本只会把 Skill 复制到 Codex 的 Skills 目录；如果发现同名 Skill，它会停止，不会覆盖原文件。安装后重新打开 Codex，或开始一个新任务。

手动安装

把下面这个完整文件夹复制到 Codex 的 Skills 目录：

skill/spaceship-cloudflare-domain-dns/

macOS / Linux 默认目标位置：

~/.codex/skills/spaceship-cloudflare-domain-dns/

Windows PowerShell 示例：

$CodexHome = if ($env:CODEX_HOME) { $env:CODEX_HOME } else { Join-Path $HOME ".codex" }
New-Item -ItemType Directory -Force -Path (Join-Path $CodexHome "skills") | Out-Null
Copy-Item -Recurse ".\skill\spaceship-cloudflare-domain-dns" (Join-Path $CodexHome "skills")

如果你设置过 CODEX_HOME，请使用 $CODEX_HOME/skills/，不要使用默认目录。

怎么使用

在 Codex 中直接点名 Skill，并给出一个准确域名：

用 $spaceship-cloudflare-domain-dns 帮我把 example.com 从 Spaceship 接入 Cloudflare。先检查现有网站和邮箱 DNS 记录，确认安全后再修改 nameserver，并告诉我每一步的验证状态。

只想查看步骤、不想真的修改：

用 $spaceship-cloudflare-domain-dns 检查 example.com 的接入条件，只做检查和操作指引，不要保存任何修改。

已经在 Cloudflare 看到两个 nameserver：

用 $spaceship-cloudflare-domain-dns 检查并配置 example.com。Cloudflare 分配的是 alice.ns.cloudflare.com 和 bob.ns.cloudflare.com；保存前先核对它们确实属于 example.com。

上面的 nameserver 只是格式示例，不要照抄。每个 Cloudflare Zone 的分配结果可能不同，必须以目标域名的 Cloudflare 页面为准。

新手最容易踩的坑

1. 在 Spaceship 的 Advanced DNS 里改错位置

本任务要改的是：

Domain Manager → 域名行 → Nameservers & DNS → Change → Custom nameservers

Advanced DNS 用于管理 DNS 记录和 DNSSEC，不是切换域名 DNS 托管方的入口。

2. 直接照抄别人的 Cloudflare nameserver

Cloudflare 会为 Zone 指定 nameserver。必须从你自己的目标域名页面读取，不能复制教程、截图或另一个域名的值。

3. 忘了邮箱记录

有企业邮箱或域名邮箱时，切换前至少核对 MX、SPF、DKIM、DMARC 和相关邮件主机记录。只检查网站 A/CNAME 记录并不够。

4. 把“已保存”误当成“已生效”

Spaceship 已保存、Cloudflare 已检测到、公网 DNS 已传播，是三个不同状态。传播可能需要时间，短暂显示旧 nameserver 不一定是失败。

5. Cloudflare 提示缺少 www

www 是网站 DNS 记录问题，不等于 nameserver 激活失败。是否添加以及指向哪里，应由你的网站部署方式决定。

更新与卸载

更新前先备份或移走旧目录，再重新运行安装脚本；脚本不会自动覆盖：

mv ~/.codex/skills/spaceship-cloudflare-domain-dns ~/.codex/skills/spaceship-cloudflare-domain-dns.backup
bash install.sh

确认新版本正常后，再删除 .backup 目录。卸载时删除安装目标中的 spaceship-cloudflare-domain-dns 文件夹即可。

仓库结构

.
├── README.md
├── LICENSE
├── install.sh
└── skill/
    └── spaceship-cloudflare-domain-dns/
        ├── SKILL.md
        └── agents/
            └── openai.yaml

安全与免责声明

• 本项目不会绕过登录、MFA 或账号权限；
• 不要在 Issue、截图或聊天记录中公开 Token、Cookie、密码和验证码；
• 域名正在承载网站或邮箱时，建议先导出或截图保存旧 DNS 记录；
• Spaceship 或 Cloudflare 的界面可能更新，按钮文字与位置应以当前官方页面为准；
• 本项目是社区工具，与 Spaceship、Cloudflare 没有官方隶属或背书关系。

许可证

MIT License。欢迎在保留许可证的前提下使用、修改和分享。