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 服务器执行只读查询
• 需要对同一台服务器并行采集多条命令输出
• 需要复用之前保存过的服务器地址、端口、用户名和密码
• 第一次访问某台服务器，或旧记录登录失败后需要重新确认连接信息
• 不适用于批量写操作、重启、删文件、改配置等高风险运维动作

核心流程

1. 通过标准脚本检查 bootstrap 状态（不要直接读取或猜测状态文件路径）：
   • windows-msys：powershell -ExecutionPolicy Bypass -File .\skills\remote\scripts\remote.ps1 -CheckBootstrap
   • 其他环境：bash ./skills/remote/scripts/remote.sh --check-bootstrap 退出码 0 表示环境已就绪；退出码非 0 表示需要 setup。
2. 若退出码非 0，必须读取 references/setup.md，并只通过标准脚本完成环境 setup；不要手工探测认证工具或裸跑 SSH。
3. 再检查 servers.json 是否已有目标服务器记录：用 -Show -Address <目标> 查找特定服务器，或用 -Show（不带地址）列出所有已保存记录。命中记录时直接复用；未命中记录时，立即向用户询问服务器地址、用户名、密码，端口默认 22。
4. 标准入口固定如下：
   • 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
5. 诊断类任务遵循 references/remote-guidelines.md：首轮完整采集、优先并行、不提前过滤、不做破坏性动作。
6. 连接成功后更新 servers.json；连接失败时按”结论 / 证据 / 推断 / 下一步”输出，最多只允许一次基于标准主链的最小重试。
7. 远端返回 Permission denied 时，只能下结论为”密码认证被拒绝”；不能直接解释为密码中的特殊字符或兼容性问题。
8. 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 文件，不能因编码头导致主链中断