디스크 정리 (Dọn rác ổ đĩa)
짧게 베트남어로 말합니다. K = ~/.claude/skills/don-rac-o-dia. Windows, python (3.9+).
하드 규칙
- 읽기 전용:
K/scripts안의 스크립트만 실행합니다. 파일 내용을 열지 않고, 삭제하지 않으며, 정리 스크립트를 실행하지 않습니다. - OneDrive / WPS Cloud / Dropbox / Pictures(사진 라이브러리), 외장 드라이브, junction/symlink, 권한이 거부된 폴더는 건너뜁니다.
- 사용자가 명시적으로 "실행해"라고 말할 때만 정리 스크립트를 실행합니다. "확인 필요" 항목은 실행 전에 각 항목을 다시 물어봐야 합니다.
- 아티팩트 페이지에는 머신 경로(사용자 이름, 프로젝트 이름)가 포함됩니다. 개인 정보를 보호하고, 스스로 공유하지 않습니다.
절차
- 스캔 (1–3분; 제한시간 600000):
현재 작업 디렉터리가 홈 외부(예:python "K/scripts/scan_disk_usage.py" --html-out "<scratchpad>/disk-map.html" [--root <홈 외부 프로젝트 폴더>]C:\code또는D:\Projects)에 있으면--root에 해당 최상위 폴더를 추가합니다. 스크립트는 이전~/disk-report/sizes.csv를 읽어(sizes-previous.csv로 복사) 비교하고, 새 파일을 기록하며 각 항목의 ID와 함께 요약을 출력합니다. - 아티팩트 게시
<scratchpad>/disk-map.html파일 (K/assets의 템플릿에서 자동 생성, 스캔 데이터 포함):~/disk-report/artifact-url.txt가 있으면 → 해당 URL의Artifact read를 수행한 후url과 함께 게시하여 이전 링크를 유지합니다.- 없으면 → 새로 게시합니다(
icon: "storage"). URL을~/disk-report/artifact-url.txt에 기록합니다.
- 사용자에게 알림 (≤ 8줄): 남은 공간; "안전" 항목 합계 + 가장 큰 3개 항목; "확인 필요" 항목 합계; 이전보다 증가한 항목(있는 경우); 아티팩트 링크. 안내: 페이지에서 항목을 선택 → 스크립트 복사 → PowerShell에 붙여넣기, 또는 항목 이름을 말하면 제가 파일을 생성합니다.
- 사용자가 채팅에서 항목을 선택하면:
python "K/scripts/make_cleanup_script.py" <id> <id> ...→~/disk-report/cleanup-*.ps1경로와 각 명령 블록 요약을 제공합니다. 실행하지 않습니다. - 사용자가 정리를 완료한 후: 스킬을 다시 호출하여 재스캔합니다. 페이지에 변경된 용량이 표시됩니다.
파일
| 파일 | 역할 |
|---|---|
scripts/cleanup_rules.py | 알려진 정리 대상 위치 목록 + 프로젝트 폴더 패턴(node_modules, .next, venv 등), 정리 명령어, 설명. 새 규칙은 여기에 추가합니다. |
scripts/scan_disk_usage.py | 읽기 전용 스캔, sizes.csv 비교, scan.json 기록, HTML 빌드 호출 |
scripts/build_disk_map_html.py | assets/ + 데이터를 결합하여 페이지 생성. 인터페이스 수정 후 scan.json에서 다시 빌드하기 위해 별도 실행 |
scripts/make_cleanup_script.py | 선택한 ID에 대해 .ps1 파일(UTF-8 BOM) 생성 |
assets/disk-map-*.{html,css,js} | 인터페이스: 트리맵, 체크박스가 있는 제안 목록, 스크립트 복사 버튼 |
출력 위치는 ~/disk-report/: scan.json, sizes.csv, sizes-previous.csv, disk-map.html, cleanup-*.ps1, artifact-url.txt.
규칙 추가
RULES (cleanup_rules.py) 내의 딕셔너리: id, label, kind (cache | build | agent | docker | ai | files), cat
(SAFE = 도구가 자동으로 다시 다운로드/빌드 가능; REVIEW = 기록, 모델, 데이터 손실), paths (glob), why (삭제 시 손실되는 항목), 그리고 다음 중 하나:
tool + cmd (공식 정리 명령어), cmd에 {p} 포함 (경로별로 실행), manual (지침만 출력), 또는 비워둠 (디렉터리 비우기). 수동 삭제보다 도구의 공식 명령어를 우선시합니다.