badseal/ssh-skill

解决的问题

ssh-skill 为通过 SSH 管理远程服务器提供了一个统一、安全且对 AI 友好的接口。它消除了 Windows、macOS 和 Linux 平台之间的不一致性，提供了一个单一的 Python CLI，使 AI 代理（如 Codex 和 Claude Code）无需处理原始 shell 命令构造或平台特定的怪异行为，即可执行命令、传输文件和管理隧道。

工作原理

该项目实现了一个统一的入口点（scripts/ssh_skill.py），封装了 OpenSSH、Paramiko 和集群执行逻辑。它强制使用严格的基于 JSON 的结果协议（v4），以确保 AI 代理接收到结构化、可预测的数据。为防止 AI 驱动的错误，项目包含安全防护机制，例如集群操作必须启用预览模式，且在生产环境中需要显式确认。此外，它还限制输出大小（256 KiB），以防止 AI 上下文窗口溢出。

适用人群

使用 Codex 和 Claude Code 等工具，需要在不同操作系统间安全、可靠地与远程基础设施交互的 AI 代理和开发者。

主要亮点

• 统一协议： 将 stdout 标准化为单一 JSON 文档，便于 AI 一致解析。
• 跨平台一致性： 确保 Windows、macOS 和 Linux 上的 POSIX 风格远程路径和一致的结果。
• 跨服务器传输： 支持服务器之间的直接文件传输。
• AI 安全防护： 避免对未知结果自动重试，防止副作用重复；生产集群变更需显式使用 --apply 和 --confirm-production。
• 上下文窗口优化： 将大型目录列表截断为 100 个样本，避免填满 AI 的上下文。
• 安全优先： 新配置中拒绝明文密码，且默认禁用代理转发。