用途:用于所有经 SSH 完成的工作,包括远程主机命令与巡检、上传下载及服务器间传输、SSH 别名/密钥/代理/跳板机/ProxyJump/隧道与端口转发、远程部署、经隧道的远程数据库访问与集群作业。不适用于本地命令、localhost、本机服务或本地 Docker,也不适用于不经过 SSH 的浏览器/HTTP 下载、Git 远端操作和无需隧道的直连数据库。
主要能力:统一 CLI 覆盖 exec、upload、download、transfer、cluster、config、tunnel、daemon、doctor 等操作;由 Python 脚本负责传输、重试、输出限制、主机密钥策略与兼容行为。命令形如:<PYTHON> "<SSH_SKILL_ROOT>/scripts/ssh_skill.py" <operation> <arguments>。远程路径使用 POSIX 形式,整条远程命令作为单个参数传入。stdout 只输出一个版本化 JSON(schema_version/success/operation/data/error/meta),顶层上限 256 KiB;启用 --progress 时进度以 JSONL 写到 stderr。
使用方式:先解析 SKILL.md 所在根目录并称其为 <SSH_SKILL_ROOT>,不要假设 .agents、.codex、.claude 或用户主目录路径;仅在根目录不明确、依赖缺失或存在多份副本时运行 doctor --json。不要自行拼装原始 ssh、scp、sftp、rsync 命令,不要套本地 shell 包装。先分类为 exec、transfer、cluster、config、tunnel 或 doctor;别名未知时用 config list-servers 或 config find 查询,不得凭 IP 或相似名称猜测。多主机、生产、删除或覆盖操作需先预览,cluster 不加 --apply 只预览目标,生产目标需 --confirm-production。需要语法时按平台读取对应 references 指南。
限制与安全:出现 outcome_unknown 视为停止条件,保留 request ID 且不自动重放;认证失败、破坏性命令、多主机部分完成的操作在无新证据和用户意图时不得重试。禁止暴露密码、私钥内容、令牌或 askpass 数据;主机密钥默认 accept-new,已知密钥变更会被拒绝,日常使用不得关闭校验或丢弃 known_hosts。服务器到服务器直连可能向源主机暴露 SSH agent,除非显式 --allow-agent-forwarding,否则不做 agent 转发。配置删除不加 --apply 仅为预览,实际删除会先创建带时间戳备份。进行凭据变更、生产操作、agent 转发、配置删除或结果不确定时,先阅读 references/safety.md。
兼容性:Codex 与 Claude Code 共用本文件与同一 Python CLI,三平台核心行为一致,仅本地调用与依赖修复方式不同;v4 迁移期间保留旧脚本文件名作为兼容入口。
资料未提供具体的版本号、价格、收费与性能指标等信息。