duriantaco/skylos

해결하는 문제

Skylos는 소프트웨어 프로젝트의 품질 및 보안 게이트 역할을 하며, AI 코딩 에이전트(Claude Code, Cursor, Codex 등)나 인간 개발자가 도입한 오류를 포착하도록 특별히 설계되었습니다. 코드베이스에 병합되기 전에 데드 코드, 보안 취약점, 하드코딩된 비밀 정보, 그리고 AI가 생성한 일반적인 실수(환각으로 인한 패키지 임포트나 누락된 코드 가드 등)를 식별합니다.

작동 방식

Skylos는 프로젝트 파일에 대해 정적 분석을 수행하는 CLI 도구입니다. 로컬에서 실행하거나 CI/CD 파이프라인에 통합하여 풀 리퀘스트를 제어할 수 있습니다. 코드 품질 검증, 데드 코드 확인, 테스트 실행 및 브랜치와 메인 코드베이스 비교를 통해 AI 에이전트가 작업을 실제로 완료했는지 확인하는 특정 명령어를 제공합니다. 또한 인기 있는 AI 코딩 도구를 위한 선택적 훅을 제공하여 개발 루프 중에 실시간 피드백을 제공합니다.

대상 사용자

AI 코딩 에이전트를 사용하면서 높은 코드 표준을 유지하고자 하는 소프트웨어 엔지니어링 팀을 위해 구축되었습니다. 또한 클라우드 계정 없이도 보안 결함과 기술 부채를 감지할 수 있는 프레임워크 인식 정적 분석 도구를 찾는 Python 메인테이너에게도 적합합니다.

주요 특징

• AI 에이전트 가드레일: 환각으로 인한 패키지 버전, 출력 검증 누락, 안전하지 않은 도구 사용 등 일반적인 AI 실수를 구체적으로 플래그 지정합니다.
• 풀 리퀘스트 게이팅: 보안, 품질 또는 테스트 완료 검사를 통과하지 못하면 자동으로 병합을 방지합니다.
• 로컬 우선: 계정이나 API 키 없이 머신이나 CI 환경에서 로컬로 실행됩니다.
• 다국어 지원: Python에 대한 심층 분석을 제공하며, TypeScript/JavaScript, Go, Java, Rust 등을 추가로 지원합니다.
• 에이전트 통합: Cursor나 Claude Code와 같은 도구에 훅을 설치하여 편집 내용과 패키지 설치를 실시간으로 확인할 수 있습니다.