Community연구 & 데이터 분석github.com

Windows 디스크 클리너

Windows 애플리케이션 및 개발 캐시를 안전하게 스캔, 정리 및 마이그레이션합니다. 데스크톱 프로그램과 Codex Skill을 포함합니다.

Windows 디스크 클리너란 무엇인가요?

이 스킬은 Windows 시스템에서 개발 및 애플리케이션 캐시를 안전하게 분석, 정리 및 마이그레이션하는 도구입니다. 사용자에게 명시적인 요청이 있을 때만 실제 삭제를 수행하고, 그렇지 않으면 읽기 전용 분석으로 제한합니다. Cursor, Codex, Claude Code 등 다양한 AI 에이전트 플랫폼과 호환되며, PowerShell 스크립트를 통해 자체 포함 GUI 클리너를 실행합니다. 또한 Unity, Gradle, npm 등 개발 도구의 캐시 디렉토리를 마이그레이션하는 기능을 제공하여 디스크 공간을 효율적으로 관리할 수 있습니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add 1751569571/windows-disk-cleaner

Installed? Explore more 연구 & 데이터 분석 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Windows 디스크 캐시 정리

삭제 작업을 수행할 때는 내장 클리너를 사용합니다. 사용자가 명시적으로 정리를 요청하기 전까지는 읽기 전용 분석만 수행합니다.

작업 흐름

  1. 현재 시스템이 Windows인지 확인하고 사용자가 지정한 디스크를 식별합니다.
  2. 수정 전 디스크 여유 공간을 기록합니다.
  3. 사용자가 분석만 요청한 경우, 디스크 용량과 알려진 캐시 디렉토리만 읽고 파일을 삭제하지 않습니다.
  4. 사용자가 정리를 요청한 경우:
    • 이 Skill이 대화형 클리너를 열 것임을 사용자에게 알립니다.
    • 그래픽 인터페이스를 열거나 소프트웨어를 닫기 전에 먼저 허가를 받습니다.
    • scripts/launch-cleaner.ps1 -Action Verify를 실행합니다.
    • scripts/launch-cleaner.ps1 -Action Run을 실행하여 클리너를 엽니다.
    • 사용자가 인터페이스에서 경로와 선택 항목을 확인한 후 정리를 승인하도록 합니다.
  5. 정리 후 여유 공간을 다시 읽고, 확보된 용량, 건너뛴 항목 및 여전히 종료된 상태로 유지된 소프트웨어를 보고합니다.

다음 명령을 사용하여 스크립트를 실행합니다:

powershell.exe -NoProfile -ExecutionPolicy Bypass -File "<skill-dir>\scripts\launch-cleaner.ps1" -Action Verify
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "<skill-dir>\scripts\launch-cleaner.ps1" -Action Run

그래픽 프로그램은 자체 포함 버전이므로 별도의 .NET 설치가 필요하지 않습니다.

보안 규칙

  • 내장 클리너 화이트리스트에서 생성된 후보만 처리합니다.
  • 전체 AppData, 사용자 디렉토리, 디스크 루트, Windows, Program Files 또는 프로젝트 디렉토리를 삭제하지 마십시오.
  • pagefile.sys, 구성 요소 저장소, 드라이버 저장소, 브라우저 자격 증명, 채팅 기록, 데스크톱 파일, 다운로드 디렉토리 또는 휴지통을 처리하지 마십시오.
  • 디렉토리 접합 또는 심볼릭 링크를 따라가지 마십시오.
  • 사용자가 명시적으로 승인하지 않는 한 소프트웨어를 강제로 종료하지 마십시오. 정상 종료를 우선시합니다.
  • 일반 사용자 캐시를 정리할 때 관리자 권한을 요청하지 마십시오.
  • 스크린샷은 초기 판단 용도로만 사용합니다. 결과를 보고하기 전에 현재 파일 시스템 상태를 확인해야 합니다.
  • 프로그램 해시 검증에 실패하면 즉시 중지합니다.

캐시 마이그레이션

디렉토리 접합 대신 소프트웨어 공식 지원 환경 변수를 우선 사용합니다:

  • Unity Package Manager: UPM_CACHE_ROOT
  • Gradle: GRADLE_USER_HOME
  • npm: npm_config_cache

변수를 설정하기 전에:

  1. 프로세스, 사용자 및 시스템 수준의 기존 값을 확인합니다.
  2. Unity 오버라이드 변수(UPM_NPM_CACHE_PATH, UPM_CACHE_PATH, UPM_GIT_LFS_CACHE_PATH)를 확인합니다.
  3. 대상 디스크가 정상적인 NTFS 파티션이고 충분한 공간이 있는지 확인합니다.
  4. D:\DevCaches와 같은 짧은 경로를 사용합니다.
  5. 사용자 허가를 받은 후에만 디렉토리를 만들고 사용자 수준 변수를 씁니다.
  6. 지속된 변수와 npm이 실제로 사용하는 캐시 위치를 확인합니다.
  7. 새로 시작된 소프트웨어만 새 변수를 읽으며, 기존 프로세스는 다시 시작해야 함을 설명합니다.

전체 AppData, 브라우저 구성, 인스턴트 메신저 데이터 또는 Windows 임시 디렉토리를 마이그레이션하지 마십시오.

내장 리소스

  • assets/disk-cleaner.exe: SHA-256으로 검증된 Windows x64 자체 포함 그래픽 프로그램.
  • scripts/launch-cleaner.ps1: 내장 프로그램을 찾고 검증하며 시작합니다.

관련 스킬