scanaislop/aislop

aislop이란 무엇인가요?

aislop는 Claude Code, Cursor, Codex와 같은 AI 코딩 보조 도구가 남기는 지저분한 패턴을 코드에서 스캔하는 명령줄 도구입니다. 프로젝트에 0~100 사이의 품질 점수를 부여하고, 문제 있는 코드를 표시하며, 기계적인 문제를 자동으로 수정할 수 있습니다.

기능

• 스캔: 코드베이스(또는 변경된 파일만)를 10개의 프로그래밍 언어(Typescript, Python, Go, Rust, Ruby, PHP, C#, C/C++ 등)에서 50개 이상의 규칙으로 스캔합니다.
• 점수 매기기: 모든 변경 사항에 대해 0~100 범위의 점수를 매기며, 심각한 문제는 스타일 미세 조정보다 더 큰 영향을 미치도록 가중치를 적용합니다.
• 수정: 사용되지 않는 임포트, 죽은 코드, 형식 지정과 같은 순수 기계적 문제를 자동으로 수정하고, 판단이 필요한 부분은 코딩 에이전트에게 위임합니다.
• 통합: CI/CD, Git 훅, 인기 있는 AI 코딩 도구와 통합되어 편집 또는 풀 리퀘스트마다 검사를 수행합니다.

작동 방식

aislop은 결정론적입니다. 정규 표현식, AST 파싱, 표준 린터/포맷터(Biome, ruff, gofmt, clippy 등)를 사용합니다. LLM이나 API 호출이 없기 때문에 동일한 코드는 항상 동일한 점수를 받습니다. 6개의 병렬 엔진으로 작동합니다:

• 포맷팅 – 표준 도구를 통한 스타일 일관성
• 린팅 – 언어별 문제
• 코드 품질 – 복잡도, 죽은 코드, 사용되지 않는 파일
• AI 슬롭 – AI 에이전트가 남기는 특정 패턴(내러티브 주석, 삼킨 예외, as any 캐스트, 환상적 임포트 등)
• 보안 – 인젝션 위험, 하드코딩된 시크릿, 종속성 감사
• 아키텍처 – 임포트 금지 및 계층 제한과 같은 사용자 정의 규칙(옵션)

주요 기능

• 제로 설정 시작: npx aislop@latest scan은 어떤 리포지토리에서나 작동합니다.
• 자동 수정: aislop fix로 기계적 문제를 정리하고, --safe 모드는 되돌릴 수 있는 변경만 적용합니다.
• 에이전트 통합: aislop agent는 기존 코딩 에이전트(Codex, Claude Code 등)와 로컬에서 수리 세션을 실행하고 결과를 검증합니다.
• 훅: 에이전트가 코드에 반영되기 전에 슬롭을 수정하도록 편집마다 훅을 설치합니다.
• CI 게이트: 점수가 임계값 이하로 떨어지면 aislop ci가 빌드를 실패시킵니다.
• MCP 서버: Claude Desktop, Cursor, Codex 등의 도구로 aislop을 공개합니다.
• 공개 배지: README에 점수를 표시합니다.

왜 사용해야 할까요?

AI가 생성한 코드는 테스트와 린터를 통과하지만, 과도한 주석, 숨겨진 백업 경로, 중복된 헬퍼, 죽은 코드와 같은 미묘한 문제를 포함할 수 있습니다. aislop은 이러한 패턴을 조기에 포착하고, 단일 품질 게이트를 제공하며, AI 도구가 워크플로우에 포함될수록 코드베이스를 깨끗하게 유지하는 데 도움을 줍니다.