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

hyt315/windows-cleanup-optimize

Windows 청소 및 최적화 어시스턴트. 디스크 공간 진단, 블로트웨어 제거, 시작 프로그램 감사, 서비스 및 성능 최적화. 모든 작업 되돌릴 수 있는 '제로 피해' 보장.

windows-cleanup-optimize란 무엇인가요?

이 스킬은 Windows PC의 디스크 공간 부족, 느린 부팅, 팝업 광고, 의심스러운 백그라운드 프로세스, 앱 지연 등 일반적인 문제를 진단하고 해결하는 종합적인 시스템 최적화 도구입니다. 모든 작업은 '제로 피해' 원칙에 따라 수행되며, 삭제된 파일은 휴지통으로 이동하여 복구 가능하고, 각 최적화 항목은 4단계 위험도(LOW/MEDIUM/HIGH/CRITICAL)로 분류되어 사용자 승인 후에만 실행됩니다. 이 스킬은 Claude Code, Cursor 등의 AI 에이전트와 함께 사용하도록 설계되었으며, 사용자 프로필(가정 사용자, 개발자, 게이머, 노트북 사용자)에 따라 맞춤형 제안을 제공합니다. PowerShell 스크립트를 통해 Windows 10/11의 기본 명령줄 도구만을 사용하므로 추가 소프트웨어 설치가 필요 없으며, 6단계 워크플로우(진단, 위험 분류, 사용자 확인, 실행, 검증, 보고)를 통해 체계적인 시스템 최적화를 보장합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add hyt315/windows-cleanup-optimize

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

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

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

문서


name: windows-cleanup-optimize description: Windows 디스크 공간을 진단하고 정리하며, 블로트웨어/번들 소프트웨어를 식별 및 제거하고, 시작 항목을 감사/비활성화하며, Windows 서비스/메모리/성능을 최적화합니다. 사용자가 C 드라이브 용량 부족, 느린 부팅, 팝업 광고, 의심스러운 백그라운드 프로세스, 앱 지연 또는 일반 PC 튜닝을 원할 때 사용합니다. 제로 피해 보장: 모든 작업은 휴지통 또는 복원 명령을 통해 되돌릴 수 있습니다.

Windows 청소 및 최적화 어시스턴트 (PC Cleanup & Optimization Assistant)

제로 피해 Windows 튜닝 스킬: 청소(디스크 + 소프트웨어 + 자동 시작) + 최적화(서비스 + 메모리 + 성능) + 고급(데이터 마이그레이션). 모든 솔루션은 "컴퓨터에 부정적 영향 제로" 원칙을 엄격히 준수합니다—모든 청소는 휴지통 이동 가능, 모든 최적화 항목은 4단계 위험도 표시 및 롤백 명령 제공.


적용 시나리오

청소 유형:

  • 디스크 공간 부족 / C 드라이브 빨간색
  • AppData 누적 캐시 (uv / npm / pnpm / 소프트웨어 로그 / TRAE / WPS / WorkBuddy / 로컬 LLM 등)
  • 소프트웨어 제거 후 잔존 (레지스트리, AppData, 설치 디렉터리, 예약 작업, 서비스)
  • 자동 시작 항목 과다, 부팅 속도 저하 (WMI 이벤트 구독 지속성 및 데스크톱/시작 메뉴 바로가기 하이재킹 심층 감사 지원)
  • 악성 소프트웨어 / 번들 소프트웨어 관리 및 팝업 근절 (필수 소프트웨어의 경우 제거 없이 무음 처리, IFEO 이미지 하이재킹을 통한 팝업 차단, 3초 활동 팝업 프로세스 즉시 식별, 360 / 2345 등)

최적화 유형:

  • Windows 서비스 경량화 (텔레메트리, Xbox, 타사 업데이터 등 안전하게 비활성화 가능한 서비스, Win11 위젯 백그라운드 및 네트워크 억제)
  • 메모리 최적화 (실제 메모리 누수 프로세스 식별; "메모리 청소 도구"에 대한 비판적 관점)
  • 시스템 성능 튜닝 (전원 관리 옵션, 시각 효과, SSD TRIM, TCP Nagle 프로토콜 스택 정밀 튜닝 등)
  • 사용자 프로필별 맞춤 (가정 사용자 / 개발자 / AI 크리에이터 / 게이머 / 노트북)

고급:

  • 자동 시작 "완전 차단" (Edge/Chrome 시작 프로모션 + 백그라운드 모드 + 20개 이상의 숨겨진 시작 지점, WMI 이벤트 구독 지속성 및 바로가기 하이재킹 포함, 공식 도구 AutoRuns로 한 번에 감사)
  • C 드라이브 대용량 디렉터리를 D 드라이브로 이동: 공식 솔루션 우선 (앱 내 마이그레이션 / 시스템 리디렉션 / 공식 구성 옵션), mklink는 최후의 수단으로만 사용
  • WeChat 4.x(및 3.x 고립 정리)/WeCom/QQ/DingTalk/브라우저/개발 도구/AI 모델/Android AVD 등 대용량 디렉터리를 D 드라이브로 공식 마이그레이션

핵심 보안 원칙 (제로 피해 및 읽기 전용 우선 보장)

이 스킬은 절대 사용자 파일을 영구 삭제하지 않습니다. 모든 작업은 '읽기 전용 우선' 및 '관리 작업은 사용자 승인 필요' 원칙을 따릅니다.

  1. 읽기 전용 진단 우선 (Zero-Mutation 원칙) — 단계 1 진단 단계 (scripts/full_scan.ps1 및 모든 탐지 스크립트)는 순수하게 읽기 전용 진단이며, 시스템 구성을 절대 임의로 수정하지 않고, 파일을 삭제하거나 이동하지 않으며, 어떤 설정도 변경하지 않습니다.
  2. 관리 제안은 사용자 승인 필요 — 휴지통 이동, 파일 삭제, 레지스트리 변경, 서비스 비활성화, IFEO 이미지 하이재킹 차단, 디렉터리 마이그레이션 등 모든 파괴적 쓰기 작업은 맞춤형 관리 제안으로만 사용자에게 보고되며, 사용자의 명시적 동의 후에야 수동으로 실행되며, 절대 경계를 넘어 변경하지 않습니다.
  3. 모든 청소는 휴지통으로 이동 — SendToRecycleBin (Microsoft.VisualBasic.FileIO.FileSystem]::DeleteDirectory)을 사용하고, Remove-Item은 사용하지 않습니다(템플릿은 scan-scripts.md 템플릿 7 참조). 100% 복구 가능을 보장합니다.
  4. 최적화 항목은 4단계 위험도로 분류 — 각 항목은 🟢 LOW / 🟡 MEDIUM / 🟠 HIGH / 🔴 CRITICAL로 명확히 표시됩니다.
  5. 시스템 디렉터리 건드리지 않음 — C:\Windows, C:\Program Files, C:\ProgramData는 기본적으로 읽기 전용 검색; 제거 잔존은 교차 비교 후 사용자 확인을 거쳐 처리합니다.
  6. 중요 작업 전 복원 지점 생성 — 드라이버/서비스/시스템 구성 요소 관련 시, Checkpoint-Computer -Description "BeforeXxx"를 실행합니다.
  7. 완전한 롤백 대책 및 안전 복구 명령 제공 — 각 비활성화/최적화 항목에 대해 안전 복구 및 "복구 방법"에 대한 완전한 롤백 대책을 제공합니다.
  8. 잠긴 파일은 건너뛰고 강제하지 않음 — IOException 점유 오류 발생 시 건너뛰고 기록하며, 프로세스를 중단하지 않습니다.
  9. 공식 청소 명령 우선 — npm cache clean --force, pip cache purge 등.
  10. 휴지통 비우기만이 진정한 해제 — SendToRecycleBin은 단순히 휴지통으로 이동하는 것이며, 사용자에게 휴지통을 비워야 실제로 디스크 공간이 해제됨을 알려야 합니다.
  11. 작업 전 기준 기록 — 청소/최적화 전에 대상 디스크의 남은 공간과 지표를 기록하고, 완료 후 비교합니다.
  12. 불확실하면 사용자에게 질문 — 모호한 판단("잔존으로 의심됨", "사용하지 않을 수 있음")은 모두 사용자에게 확인을 위해 제시하고, 임의로 일괄 실행하지 않습니다.

참조 문서 매트릭스 (필요 시 로드)

다음 세부 내용은 별도의 참조 파일로 분리되어 있습니다. 해당 시나리오가 발생하면 먼저 해당 파일을 읽은 후 작업을 진행하고, 기억에 의존하여 실행하지 마십시오.

파일언제 읽을 것인가 / 포함 내용
references/scan-scripts.md스캔/청소/최적화 실행 시 번호별로 해당 PowerShell 템플릿(1-20) 사용
references/pitfalls.md예외/경계 상황 발생 시, 먼저 함정 기록 확인 (86개의 권위 있는 함정 회피 포함)
references/startup-audit.md부팅 느림, 자동 시작 많음, 자동 시작 비활성화 필요 (Edge/Chrome '완전 차단', WMI 상주 및 바로가기 감사 포함)
references/startup-mechanisms.md"꺼도 다시 켜짐/어디서 시작되는지 모르겠음" (Windows 20개 이상의 숨겨진 시작 지점, WMI 이벤트 구독 지속성 + AutoRuns)
references/bloatware-catalog.md360, 2345, 팝업 광고 등 악성 소프트웨어 및 의심스러운 프로세스 라이브러리 식별 (필수 소프트웨어 IFEO 무음 SOP 및 바로가기 하이재킹 정리 포함)
references/software-uninstall.md소프트웨어 제거 및 심층 잔존물 정리 (WPS/DingTalk/360 전용 정리 및 활성 팝업 프로세스 로케이터 포함)
references/system-cleanup.md시스템 수준 청소 (Windows 업데이트 잔존, 최대 절전 모드 파일, DriverStore 드라이버 저장소 등)
references/services-optimization.md서비스 최적화, 백그라운드 프로세스 과다, 텔레메트리/Xbox/업데이터 비활성화 (50개 이상의 서비스를 프로필별로 분류, Win11 위젯 및 현대 백그라운드 튜닝 포함)
references/memory-optimization.md메모리 부족, 컴퓨터 지연 (실제 누수 식별 + 메모리 도구 플라시보 비판적 분석)
references/performance-tuning.md성능 튜닝, 전원 관리 옵션/시각 효과/네트워크 카드 GUID 수준 TCP 튜닝/Defender 제외 목록
references/trae-guide.md스캔 결과에 TRAE SOLO CN / .trae-cn / 사용자가 TRAE 언급 시
references/drive-migration-official.mdC 드라이브 대용량 디렉터리 D 드라이브로 이동 (공식 솔루션 우선 의사 결정 트리: 앱 내/시스템 리디렉션/구성 옵션)
references/chat-apps-migration.mdWeChat 4.x/QQ NT/DingTalk가 C 드라이브를 많이 차지함, "저장 위치를 변경했는데도 계속 늘어남" (공식 마이그레이션 + 캐시 정리)
references/mklink-migration.md공식 솔루션이 없을 때 mklink /J 최후의 수단 (호환성 사전 검사, 공식 제한 사항, 실제 실패 사례)
references/case-study.mdmklink 마이그레이션 실행 전 참고 (TRAE 희소 파일 포함 / VS Code / 일반 세 가지 사례)

워크플로우 (6단계)

단계 0: 진입 선택 (최초 실행 시)

AI 오프닝 멘트 (최초 실행 시 한 번만 질문, 이후 반복하지 않음):

이번 스캔은 어떻게 처리할까요? 두 가지 옵션이 있습니다:

🅰️ 전체 스캔 — 20개 템플릿을 한 번에 모두 스캔하여 자동으로 사용자 프로필을 추론합니다. "컴퓨터를 완전히 청소하고 싶다 / 무엇을 지워야 할지 모르겠다"는 사용자에게 적합합니다.

🅱️ 프로필 스캔 — 먼저 어떤 유형의 사용자인지 알려주세요 (가정 사용자 / 개발자 / 게이머 / 노트북 사용자). AI가 프로필에 맞춤화된 청소/최적화 제안을 제공합니다. "내 방향을 알고 있고, 맞춤형 결과만 원한다"는 사용자에게 적합합니다.

A / B로 답하거나, 원하는 것을 알려주세요.

두 가지 진입 처리 프로세스:

  • 🅰️ 전체 스캔 → 단계 1로 직접 이동, 단계 0.5 프로필 확인 건너뜀
  • 🅱️ 프로필 스캔 → 단계 0.5 사용자 프로필 확인으로 이동 → 단계 1

분리 이유: 많은 사용자가 개발자나 게이머가 아니라 "컴퓨터를 완전히 청소하고 싶다"는 경우입니다. 프로필은 실행을 차단하는 요소가 아닌 권장 차원이어야 합니다—선택권을 사용자에게 맡기십시오.

단계 0.5: 사용자 프로필 (🅱️ 프로필 스캔 모드 전용)

사용자 유형을 명확히 하고, 이후 모든 권장 사항에 영향을 줍니다 (한 번 프로필 설정 후 반복 질문하지 않음):

  • 가정 사용자: 팝업 광고 정리, 가정 친화적인 서비스 최적화
  • 개발자: 개발 도구 체인에 영향 주지 않음 (Hyper-V/WSL/Docker/디버그 서비스 유지)
  • 게이머: 고성능 전원, GPU 관련 최적화, 게임 플랫폼 데이터 마이그레이션
  • 노트북 사용자: 배터리 수명 중시, 전원 관리 관련 서비스 비활성화 권장하지 않음

단계 1: 포괄적 진단 (읽기 전용 스캔)

🅰️ 전체 스캔 모드: scripts/full_scan.ps1을 직접 호출하여 20개 모든 템플릿을 한 번에 실행합니다 (자세한 내용은 references/scan-scripts.md 템플릿 0 참조). 각 템플릿을 개별적으로 실행하지 않습니다.

🅱️ 프로필 스캔 모드: 순서대로 읽기 전용 스캔을 실행하여 시스템 전체 상태를 파악합니다 (PowerShell 스크립트는 .ps1 파일로 저장하여 실행):

  1. 디스크 기준 및 파티션: scan-scripts.md 템플릿 9 (Get-PSDrive)를 실행하여 공간 기준 기록.
  2. 사용자 디렉터리 계층별 스캔: scan-scripts.md 템플릿 1 (Scan-Directory)을 호출하여 프로필 각 계층 (Local / Roaming / Programs) 스캔.
  3. 일반적인 대용량 캐시 및 업데이트 패키지: scan-scripts.md 템플릿 5를 실행하여 업데이트 패키지 잔존 (electron-updater 등) 스캔.
  4. 소프트웨어 제거 잔존 비교: scan-scripts.md 템플릿 3 (installedLower 레지스트리와 바로가기 교차 비교) 및 템플릿 4 (설치 디렉터리 잔존) 실행.
  5. 비시스템 디스크 스캔: D/E 드라이브에서 scan-scripts.md 템플릿 2 (Scan-NonSystemDrive) 호출.
  6. 자동 시작 항목 및 백그라운드 프로세스: startup-audit.md 감사 스크립트를 호출하여 보고서 출력, bloatware-catalog.md와 프로세스 비교.
  7. 서비스 및 메모리 압력: services-optimization.md 및 memory-optimization.md를 참조하여 서비스 및 메모리 기준 기록.

단계 2: 4단계 위험도 분류 및 요약

🅰️ 전체 스캔 모드에서는 추가로 '프로필 자동 추론'을 수행—스캔 결과에 따라 자동으로 프로필 태그 할당:

프로필 태그트리거 조건 (하나라도 해당 시)
🏠 가정 사용자WPS / 360 / 2345 / Tencent PC Manager 등 설치
👨‍💻 개발자Docker Desktop / WSL / VS Code / JetBrains / 모든 AI IDE 설치
🤖 AI 크리에이터/가상화Ollama / HuggingFace / ModelScope / Android AVD / WSL2 / Docker 설치
🎮 게이머Steam / Blizzard / GeForce Experience / 모든 Game Bar 서비스 설치
💼 사무용 사용자Office / DingTalk / Feishu / WeCom 설치
💻 노트북/OEM시스템 제조업체 전원 관리 옵션 (Acer/Lenovo/Dell 등 OEM 솔루션)

각 프로필은 해당 프로필 전용 최적화 제안을 제공합니다 (예: 가정 사용자는 팝업 광고 정리, 개발자는 Hyper-V/WSL/Docker 유지).

스캔 발견 사항을 자동으로 분류하여 보고:

등급수준의미처리 전략
🟢 1등급LOW위험 없음, 복구 가능기본적으로 자동 실행 권장 (패키지 캐시, Temp, 업데이트 패키지 잔존)
🟡 2등급MEDIUM경미한 위험 / 일부 기능 미세 조정사용자 확인 후 실행 (경량 블로트웨어 제거, Xbox 서비스 끄기)
🟠 3등급HIGH중간 위험 / 눈에 띄는 기능 영향항목별 확인 필요 (전원 관리 옵션 변경, 시각 효과, SysMain 비활성화)
🔴 4등급CRITICAL파괴적이거나 보안 위험기본적으로 건드리지 않음 (Defender 끄기, Windows Update 끄기, 시스템 라이브러리 수동 삭제)

표준 전달 결과물: Windows 계층형 건강 검진 사실 카드 (Fact Card)

단계 1 읽기 전용 진단 완료 후, 사용자에게 표준 형식의 'Windows 계층형 건강 검진 사실 카드'를 제시해야 하며, 확실하고 객관적인 지표로 설명:

계층검사 항목 (Metric/Item)측정 실제값 (Value)정상 기준 (Baseline)상태 판정 (Status)
L1 디스크 및 캐시C 드라이브 사용 가능 용량 및 AppData 캐시 크기실제 측정치 (예: 14.2GB 사용 가능 / 21GB 캐시)여유 공간 >20% 이고 중복 캐시 <10GB🟢 정상 / 🔴 공간 부족
L2 자동 시작 및 상주자동 시작 항목 총 개수 및 WMI 이벤트 지속성 상주실제 측정치 (예: 자동 시작 18개 / 숨겨진 WMI 0개)자동 시작 <10개 이고 숨겨진 WMI 상주 0개🟢 정상 / 🟡 중복 많음
L3 소프트웨어 및 팝업의심스러운 번들 악성 소프트웨어 수 및 활성 팝업 프로세스실제 측정치 (예: 알려진 팝업 소프트웨어 2개 적중)악성 번들 0개 이고 팝업 원인 통제됨🟢 정상 / 🔴 팝업 성가심
L4 서비스 및 메모리 효율성실제 메모리 누수 프로세스 및 불필요한 백그라운드 상주 서비스실제 측정치 (예: 메모리 사용률 68% / 누수 0개)메모리 수준 건강하고 비정상적인 상주 서비스 없음🟢 정상 / 🟡 정리 필요

【근본 원인 정확히 파악】각 계층의 실제 측정값을 기반으로 시스템 지연 또는 공간 부족의 핵심 병목 식별. 【맞춤형 관리 제안 (사용자 명시적 동의 후 수동 실행 필요)】4단계 위험도 분류에 따라 관리 조치를 나열하고 완전한 롤백 명령 첨부.


단계 3: 사용자 확인 (핵심 제어 지점)

명확한 등급별 보고서와 예상 확보 공간을 사용자에게 제시하여, 사용자가 청소/최적화 범위를 명확히 선택할 수 있도록 합니다:

  • "청소만 (최적화 안 함)" / "최적화만 (청소 안 함)" / "청소 + 최적화 (전체)" / "일단 작업 안 함"
  • 3등급 항목이 포함된 경우, 각 항목의 영향을 나열하고 명시적 승인을 얻어야 합니다.

단계 4: 모듈별 실행

사용자 선택에 따라 해당 매뉴얼의 안전 실행 프로세스 호출:

  • 디스크 정리: scan-scripts.md 템플릿 7 (SafeRecycle)을 사용하여 휴지통으로 이동, 점유 시 자동 건너뛰기.
  • 자동 시작 정리: startup-audit.md에 따라 실행 (Edge/Chrome은 "먼저 스위치 계층을 끄고, Run 키를 지움"으로 재발 방지).
  • 소프트웨어 제거: software-uninstall.md 규격에 따라 제거하고 잔존 정리.
  • 서비스 최적화: services-optimization.md에 따라 서비스 비활성화 실행 (sc config <svc> start= disabled).
  • 성능 튜닝: performance-tuning.md에 따라 전원 관리 옵션 및 시스템 매개변수 조정.
  • 데이터 마이그레이션: drive-migration-official.md의 4단계 의사 결정 트리에 따라 실행 (공식 마이그레이션 우선, chat-apps-migration.md로 채팅 앱 처리, mklink-migration.md 최후의 수단).

단계 5: 검증 및 롤백

각 모듈 실행 후 즉시 기준과 비교하고 롤백 명령을 준비:

모듈검증 방법빠른 롤백 명령
디스크 정리(Get-PSDrive C).Free 비교휴지통 복원
자동 시작Get-ScheduledTask / 레지스트리 재확인Run 항목 / 작업 다시 활성화
서비스 최적화Get-Service <svc>sc config <svc> start= auto
성능 튜닝powercfg /getactiveschemepowercfg /setactive <원래 GUID>
데이터 마이그레이션공식 UI 경로 및 디스크 크기 재확인이전 디렉터리 복원 / junction 삭제

단계 6: 보고 및 장기 유지 관리 제안

  1. 최종 보고서 출력: 확보된 공간 양, 비활성화된 자동 시작 항목 및 서비스 수, 생성된 복원 지점.
  2. 최소 유지 관리 습관 제공: 매주 휴지통 비우기, 매월 한 번 진단 실행, 분기마다 자동 시작 확인, 출처 불명 소프트웨어 피하기.

회귀 테스트 및 종속성

  • 회귀 테스트: 스킬 변경 후 python scripts/selftest.py 실행 (외부 종속성 없음, Python 3 표준 라이브러리만 사용, 구조 및 심층 내용 어서션 검증).
  • 외부 종속성 제로: scripts/는 Python 3 표준 라이브러리만 사용; 시스템 실행은 Windows 10/11 내장 PowerShell 5.1+ 및 기본 명령줄 도구(cleanmgr, pnputil, powercfg, sc.exe, schtasks, fsutil, reg.exe)에 의존하며, 타사 패키지나 타사 정리 소프트웨어를 설치할 필요가 없습니다.

관련 스킬