improve: 비싼 모델로 계획, 싼 모델로 실행하는 코드 감사 스킬

shadcn/improve는 가장 강력한 LLM을 활용해 코드베이스를 분석하고 실행 가능한 구현 계획을 작성하는 에이전트 스킬입니다. 이 도구는 코드 수정을 직접 수행하지 않으며, 분석과 사양 정의라는 지능이 집중되는 단계만 담당합니다. 최종 산출물은 다른 에이전트나 개발자가 바로 실행할 수 있는 마크다운 파일 형태의 계획서입니다.

정확성, 보안, 성능, 테스트 커버리지 등 9개 카테고리를 병렬 서브에이전트로 점검합니다. 각 발견 사항은 파일 경로와 라인 번호, 영향도, 노력량, 신뢰도를 함께 제시하며 레버리지 기준으로 우선순위를 정렬합니다. ADR이나 PRD 같은 문서가 존재하면 이를 참조하여 이미 결정된 트레이드오프를 중복 보고하지 않도록 필터링합니다.

작성된 계획서는 컨텍스트가 완전히 내장된 자기 완결적 구조를 지닙니다. 현재 코드 스니펫, 검증 명령어, 그리고 실패 시 중단 조건까지 명시하여 작은 모델도 오해 없이 작업을 수행할 수 있게 합니다. /improve execute 명령은 격리된 워크트리에서 저렴한 모델을 실행시키고, 결과물을 기술 리드처럼 검토한 후 승인 또는 반려 여부를 판단합니다.

소스 코드 변경 없이 계획 파일만 생성한다는 점이 핵심 원칙입니다. 읽기 전용 분석만 수행하며, 실제 코드 수정은 사용자가 승인한 후 격리된 환경에서 이루어집니다. 복잡한 코드베이스를 체계적으로 개선하고 싶지만, 비싼 모델을 모든 라인에 투입하는 비용이 부담스러운 개발자에게 적합합니다.