cardano-cli-doctor 是一个用于诊断 Cardano 命令行工具环境的技能，适用于在生成 CLI 工作流前确认正确的命令风格、排查 flag 报错或版本不匹配、以及搭建新环境时使用。
主要能力：收集环境事实，包括 CLI 版本、可用的 era 前缀命令（如 conway、latest）、旧式 flag（如 --babbage-era）是否存在；据此判断命令风格——若 cardano-cli conway --help 可用则支持 era 前缀，若帮助中出现 --babbage-era 则支持旧式 flag，两者都存在时优先推荐较新的 era 前缀；在可用 socket 时做网络连通性检查，运行 cardano-cli query tip --mainnet 或 --testnet-magic <N>，检测缺失 socket、magic 错误、同步状态；最终生成 Compat Report，给出 CLI 版本、支持的命令、推荐风格和网络参数。
使用方式：若本地未安装 cardano-cli，可用技能目录中的包装脚本在 Docker 中运行（Cardano 节点容器镜像包含 CLI）： chmod +x {baseDir}/scripts/cardano-cli.sh {baseDir}/scripts/cardano-cli.sh version 包装脚本将当前目录挂载为容器内 /work，使 pparams.json、tx.body、datum.json 等文件可正常使用；若本地有节点 socket，运行前设置 CARDANO_NODE_SOCKET_PATH 以便查询命令工作；可用 CARDANO_DOCKER_IMAGE=ghcr.io/intersectmbo/cardano-node:<tag> 覆盖镜像。
限制与安全规则：不得索取或记录私钥内容；优先使用只读诊断命令（--help、version、query tip）；气隙机器上除非明确要求，避免网络命令；避免会打印或触碰 .skey 文件的命令，真实资金建议 chmod 600 *.skey，主网建议离线生成密钥。具体版本兼容矩阵、费用或平台细节暂未提供。