用途：管理 OpenDeploy 服务的自动子域名与自定义域名，包括子域名重命名、DNS 检查、CNAME 配置和域名验证。
主要能力：
- 列出域名：opendeploy domains list --service <service-id> --json
- 检查子域名可用性：opendeploy domains check-subdomain <prefix> --json
- 重命名自动子域名：opendeploy domains update-subdomain <domain-id> --subdomain <prefix> --json
- 创建自定义域名：opendeploy domains create --service <service-id> --domain app.example.com --type custom --confirm-custom-domain --json
- DNS 检查：opendeploy dns check app.example.com --json
自动子域名：重命名指更新服务唯一一条 *.opendeploy.site 自动域名记录；一个服务只能有一个自动域名，旧服务的 *.opendeploy.run 也视为 OpenDeploy 自动域名。不要对 .opendeploy.site、.dev.opendeploy.site、旧 *.opendeploy.run 或 type=auto 调用 domains create，否则会产生第二条记录或失败残留。若服务没有自动域名记录，应视为平台状态问题，运行 opendeploy deploy report <deployment-id> --json 与 domains list 复查，而非新建。
重命名流程：先 domains list --type auto，选非失败的自动记录（多个时优先 active，再 verified，再 pending）；check-subdomain 通过后 update-subdomain，最后用 domains get 和 domains list 回读确认只剩一条。若因已失败的自动域名占用前缀导致不可用，不要先让用户手动删除，应重试 update-subdomain；若后端仍冲突，说明需平台侧清理并提供 project/service/domain ID。
自定义域名流程：不要一开始就调用 domains create。先确认用户拥有主机名、可编辑 DNS、凭证为账号绑定，并说明 DNS 变更与 SSL 签发可能需要数分钟。自定义主机名须是子域名如 app.example.com；若用户要根域名 example.com，需提醒多数 DNS 提供商不支持根域 CNAME，询问是否改用 www/其他子域名，或提供商是否支持 ALIAS/ANAME。DNS 记录通常为：Type CNAME，Name/Host 为 app（或全名），Target 为 create 响应返回的 cname_target（切勿硬编码），TTL Auto 或 300。若使用 Cloudflare 代理开关，验证与 SSL 激活前应设为 DNS-only。检查前移除同主机名冲突的 A/AAAA/CNAME 记录。仅在用户确认后才运行 create，随后 dns check、domains get、domains list 验证；若未传播或解析到 Cloudflare anycast IP（104.、172.64.-172.71.、188.114.），让用户把该 CNAME 由代理改为 DNS-only 后重试，不要新建域名记录。凭证非账号绑定时须在 create 前停止。本技能不负责删除域名记录，删除应通过仪表板。
限制：自定义域名需账号绑定凭证、DNS 所有权与明确同意；DNS 与 SSL 生效需时间；具体提供商步骤、Cloudflare 代理处理与验证失败解读需参考 ../opendeploy/references/domain.md。