badseal/ssh-skill

何を解決するか

ssh-skill は、SSH を通じたリモートサーバー管理のための統一的で安全かつAIフレンドリーなインターフェースを提供します。Windows、macOS、Linux のプラットフォーム間の不整合を解消し、AIエージェント（Codex や Claude Code など）が、生のシェルコマンドの構築やプラットフォーム固有の問題に悩まずに、コマンドの実行、ファイルの転送、トンネルの管理を一貫した Python CLI で行えるようにします。

動作方法

このプロジェクトは、OpenSSH、Paramiko、クラスタ実行ロジックをラップする統一エントリーポイント（scripts/ssh_skill.py）を実装しています。AIエージェントが構造的で予測可能なデータを受け取れるように、厳格な JSON ベースの結果プロトコル（v4）を強制します。AIによる誤操作を防ぐために、クラスタ操作には必須のプレビューモードを導入し、本番環境では明示的な確認を要求します。また、AIのコンテキストウィンドウのオーバーフローを防ぐため、出力サイズを 256 KiB に制限しています。

対象ユーザー

Codex や Claude Code などのツールを使用し、異なるオペレーティングシステム間でリモートインフラに安全かつ安全にアクセスしたいAIエージェントや開発者。

特徴

• 統一プロトコル： 標準化された stdout を単一の JSON ドキュメントとして提供し、AIによる一貫した解析を可能にします。
• クロスプラットフォームの一貫性： Windows、macOS、Linux で POSIX スタイルのリモートパスと一貫した結果を保証します。
• サーバー間転送： サーバー間の直接ファイル転送をサポートします。
• AIセーフティガード： 不明な結果に対する自動再試行を防止し、副作用の重複を回避。本番クラスタ変更には --apply と --confirm-production の明示的指定が必要です。
• コンテキストウィンドウ最適化： 大きなディレクトリ一覧を 100 件に制限して、AIのコンテキストを満たさないようにします。
• セキュリティ最優先： 新しい設定では平文パスワードを拒否し、デフォルトでエージェント転送を無効化します。