ssh-dev-suite 是一个面向 SSH 远程开发的多 profile 技能套件，围绕连接、执行、传输、部署、隧道、调试和长任务管理提供分模块支持。
用途与定位
该套件面向需要在多个远程 Linux 主机或容器环境中开展开发、运维和排障的场景。它通过 profile 方式管理不同连接目标，并使用 ControlMaster 实现会话复用，以减少重复建连开销。套件具备容器感知能力，配置 container 字段后可自动将远程命令包装为 docker 或 kubectl exec 形式，便于直接在容器内执行操作。
主要模块
套件划分为若干子模块，各自配有对应的 SKILL.md 说明文档：
- connect：负责连接、命令执行、文件传输和后台任务管理。
- deploy：负责部署与回滚流程。
- tunnel：负责端口转发与代理配置。
- debug：负责远程问题排查。
- long-task：负责长耗时任务管理，并支持 checkpoint 恢复。
使用方式
配置文件 config.yaml 由 agent 引导生成，可参考 config.example.yaml。密码不直接写入配置，而是通过环境变量设置。认证优先级为：密钥优先，其次是环境变量密码，最后回退到交互式认证。所有子模块遵循统一的 Token 约束原则：远程命令输出优先使用 --tail、--head、--grep 等过滤参数，禁止读取完整的大日志；状态检查先看摘要，再按需深入；对于重复信息不再复述。
运行环境与限制
客户端支持 Windows（Git Bash/MSYS2）、macOS 和 Linux，服务端为 Linux。在 Windows 客户端下存在若干已知差异：ControlMaster 不可用，但脚本已自动跳过；PATH 环境变量展开方式不同；以及换行符处理问题。该套件主要面向 Linux 服务端环境，其他平台的服务端支持情况暂未提供。
适用场景
适合需要频繁连接多台远程主机执行命令、传输文件、进行应用部署与回滚、建立端口转发隧道、排查远程故障或运行长耗时任务并支持中断恢复的开发与运维工作。