badseal/ssh-skill

解決的問題

ssh-skill 提供了一個統一、安全且對 AI 友好的介面，用於透過 SSH 管理遠端伺服器。它消除了 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 的上下文。
• 安全優先： 新設定中拒絕明文密碼，且預設停用代理轉發。