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 에이전트 및 개발자.

주요 특징

• 통합 프로토콜: AI 분석을 일관되게 하기 위해 stdout을 단일 JSON 문서로 표준화합니다.
• 크로스플랫폼 일관성: Windows, macOS, Linux에서 POSIX 스타일의 원격 경로와 일관된 결과를 보장합니다.
• 서버 간 전송: 서버 간 직접 파일 전송을 지원합니다.
• AI 안전 보호 기능: 알 수 없는 결과에 대해 자동 재시도를 방지하여 부작용 중복을 막고, 프로덕션 클러스터 변경에는 --apply 및 --confirm-production 명시적 지정이 필요합니다.
• 컨텍스트 창 최적화: AI 컨텍스트를 가득 채우지 않도록 큰 디렉터리 목록을 100개 샘플로 제한합니다.
• 보안 우선: 새 구성에서는 평문 비밀번호를 거부하고, 기본적으로 에이전트 포워딩을 비활성화합니다.