Remote 技能
概述
用于远程访问 Linux 服务器，并在本地状态目录维护 setup 状态与服务器信息。remote 只识别执行环境，不识别 code agent；执行环境统一按 references/setup.md 判定为 windows-msys、linux-wsl、linux-native、macos-native。
密码传递机制：
- Windows（
windows-msys）：使用SSH_ASKPASS环境变量机制（OpenSSH 原生支持，无需额外安装） - Linux/macOS/WSL：使用
sshpass
何时使用
- 需要连接 Linux 服务器执行只读查询
- 需要对同一台服务器并行整理多条命令输出
- 需要复用之前保存过的服务器地址、端口、用户名和密码
- 第一次访问某台服务器，或旧记录登录失败后需要重新确认连接信息
- 不适用于批量写操作、重启、删文件、改配置等高风险运维动作
核心流程
- 通过标准脚本检查 bootstrap 状态（不要直接读取或猜测状态文件路径）：
- windows-msys：powershell -ExecutionPolicy Bypass -File.\skills\remote\scripts\remote.ps1 -CheckBootstrap - 其他环境：bash./skills/remote/scripts/remote.sh --check-bootstrap 退出码 0 表示环境已就绪；退出码非 0 表示需要 setup。
- 若退出码非 0，必须读取
references/setup.md，并只通过标准脚本完成环境 setup；不要手工探测认证工具或裸跑 SSH。 - 再检查
servers.json是否已有目标服务器记录：用-Show -Address <目标>查找特定服务器，或用-Show（不带地址）列出所有已保存记录。命中记录时直接复用；未命中记录时，立即向用户询问服务器地址、用户名、密码，端口默认22。 - 标准入口固定如下：
- windows-msys：通过 scripts/remote.ps1 与 scripts/setup.ps1 - linux-wsl、linux-native、macos-native：通过 scripts/remote.sh 与 scripts/setup.sh - Windows 推荐优先使用 remote.ps1 的 PowerShell 命名参数：-Address、-Port、-Username、-Password、-Command、-Commands、-Save、-Show、-Parallel
- 诊断类任务遵循
references/remote-guidelines.md：首轮完整整理、优先并行、不提前过滤、不做破坏性动作。 - 连接成功后更新
servers.json；连接失败时按”结论 / 证据 / 推断 / 下一步”输出，最多只允许一次基于标准主链的最小重试。 - 远端返回
Permission denied时，只能下结论为”密码认证被拒绝”；不能直接解释为密码中的特殊字符或兼容性问题。 windows-msys下使用SSH_ASKPASS机制自动提供密码，保持纯非交互；若凭据错误，应直接失败。
按需继续加载
出现以下场景时再读对应文档：
- 需要安装、修复或验证环境：
references/setup.md - 需要确认
bootstrap-state.json或servers.json的结构（如调试状态不一致）：references/state.md - 需要执行诊断整理、并行命令或高风险判断边界：
references/remote-guidelines.md
输出要求
- 先说明使用的是本地已保存记录，还是本轮新录入的信息
- 连接失败时明确指出是地址、端口、用户名、密码还是环境问题待确认
- 诊断类回答按”结论 / 证据 / 推断 / 下一步”输出
- 不要在失败后依次试错不同的密码传递参数（仅适用于 Linux/macOS 下的 sshpass）
- 不默认执行高风险命令；涉及写操作、重启、删除、停止服务时必须先征求用户确认
- 本地状态文件统一按无 BOM UTF-8 写入；读取时兼容历史 BOM 文件，不能因编码头导致主链中断