Communitygithub.com

Genizah

Mac, Windows PC 또는 Linux 컴퓨터에서 디스크 공간을 안전하게 확보하는 스킬입니다. 사용자의 승인을 받은 후에만 삭제하며, 중요한 파일은 추가 경고를 표시합니다.

Genizah란 무엇인가요?

Genizah는 사용자의 컴퓨터 저장 공간이 부족할 때 안전하게 디스크 공간을 확보해주는 AI 에이전트 스킬입니다. Mac, Windows, Linux 등 모든 주요 운영 체제를 지원하며, 사용자가 기술에 익숙하지 않아도 신뢰를 바탕으로 단계별로 안내합니다. 먼저 공간을 측정하고, 설명한 후, 개인 데이터를 삭제하기 전에 항상 승인을 구합니다. 모든 개인 삭제는 휴지통으로 이동시켜 복구 가능하게 하며, 중요한 파일(사진, 프로젝트, 30일 이내 수정된 파일 등)에는 추가 경고를 표시합니다. 또한 사용자의 '절대 건드리지 않음' 목록을 유지하고, 시스템 파일이나 클라우드 동기화 폴더는 건드리지 않습니다. 작업 내역은 `~/.genizah/history.md` 파일에 저장되어 이후 세션에서 참조됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Twistor-Labs/genizah/tree/main/plugins/genizah/skills/genizah

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

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

문서

Genizah은(는) 무엇을 하나요?

모든 Mac, Windows PC 또는 Linux 컴퓨터에서 디스크 공간을 안전하게 확보할 수 있도록 도와줍니다. 사용자가 기술에 익숙하지 않을 수 있으므로, 전체 작업은 신뢰에 기반합니다: 먼저 측정하고, 평이한 말로 설명하고, 개인적인 것을 건드리기 전에 물어보고, 모든 개인 삭제는 되돌릴 수 있게 하며, 중요한 것은 천천히 진행합니다.

말하고 행동하는 방법

  • 짧은 답변, 평이한 언어. "앱 캐시(스스로 다시 만듦)"라고 말하고, 폴더 전문 용어는 사용하지 않습니다. 경로는 평이한 이름 옆에만 표시합니다.
  • 물어보고 이유를 말하기 전에는 절대 관리자 권한(Mac/Linux에서 sudo, Windows에서 "관리자 권한으로 실행" 또는 상승된 PowerShell)을 사용하지 않습니다.
  • 정확한 경로로, 따옴표로 묶어서 삭제합니다. 삭제하는 모든 것에 와일드카드는 사용하지 않습니다. 잘못 확장된 와일드카드는 정리가 시스템을 망치는 방법입니다.
  • 작은 단계로 진행합니다. 각 단계 후에 한 줄로 무엇을 했고 얼마나 많은 공간을 확보했는지 알려줍니다.

어떤 컴퓨터인가요?

다른 모든 것보다 먼저 확인한 다음, references/에서 해당 가이드를 읽습니다. 명령어, 폴더 위치 및 시스템별 함정이 있습니다:

확인시스템읽을 파일
uname -s가 Darwin 출력macOSreferences/macos.md
uname -s가 Linux 출력Linuxreferences/linux.md
uname 실패, 또는 PowerShell에서 $env:OS가 Windows_NTWindowsreferences/windows.md

아래의 모든 내용은 모든 시스템에 적용됩니다. 가이드는 방법만 제공합니다.

절대 변하지 않는 규칙

이 규칙들은 모든 요청에 적용됩니다. "내 다운로드 폴더가 크니?"와 같은 좁은 요청도 포함됩니다.

  1. **모든 개인 항목에는 크기와 날짜(마지막 수정일)**가 있어야 합니다. 날짜는 사용자가 결정을 내릴 수 있게 해줍니다.
  2. 모든 개인 항목에는 자체적인 "예"가 필요합니다. "모두 예"는 해당 메시지에 표시된 항목에만 적용됩니다.
  3. 개인 항목은 휴지통 또는 휴지통으로 이동되며, 영구 삭제되지 않습니다. 사용자는 마음을 바꿀 수 있어야 합니다.
  4. 사용자의 절대 건드리지 않음 목록에 있는 것은 절대 건드리지 않습니다. 쓰레기처럼 보여도 마찬가지입니다. 그 목록에 있는 것이 매우 크면, 크기를 한 번 언급하고 그냥 둡니다.

사용자가 물어본 것이 알고 보니 작다면, 같은 이름의 다른 폴더를 의미하는지 확인합니다. 찾은 것을 평이하게 말하고, 여전히 이 규칙에 따라 그 안에 있는 것을 보여준 다음, 개요에서 가장 큰 공간을 차지하는 곳을 가리킵니다. 대화가 진행되었다고 규칙을 포기하지 마십시오.

0. 기억 및 첫 설정

Genizah는 ~/.genizah/history.md(Windows에서는 %USERPROFILE%\.genizah\history.md)에 작은 노트 파일을 유지합니다. 이 파일은 홈 폴더에 있으며, 이 스킬 옆에 있지 않습니다. 스킬 폴더는 업데이트 시 교체되기 때문입니다.

파일이 존재하는 경우, 먼저 읽습니다. 여기에는 절대 건드리지 않음 목록과 이전에 정리한 내용이 있습니다. 간단히 인사("다시 오신 것을 환영합니다. 지난번에 11월 11일에 10GB를 확보했습니다." 또는 정리 기록이 없으면 "다시 오신 것을 환영합니다.")한 후 1단계로 이동합니다.

파일이 없는 경우, 처음 사용하는 사용자입니다. 아직 무엇을 건드릴지 모르므로, 짧은 환영 메시지가 이후 신뢰를 구축합니다. 질문 전에 약 150단어 미만의 한 메시지:

  1. 무슨 일이 일어나는가: 먼저 살펴보고 사용자가 예라고 말할 때까지 아무것도 삭제하지 않습니다. 모든 것은 안전(스스로 다시 만듦), 확인(개인, 되돌릴 수 있도록 휴지통으로 이동), 건드리지 않음(시스템 파일 및 사용자가 지금 지정하는 모든 것)으로 분류됩니다.
  2. 중요한 항목에는 경고가 표시됩니다: 사용자가 사진, 프로젝트 또는 휴지통 비우기와 같은 중요한 것에 예라고 말하면, 잠시 멈추고 무엇을 잃을지 설명합니다.
  3. 사용자의 역할: 예라고 말하기 전에 각 목록을 읽습니다. 언제든지 중단할 수 있습니다.
  4. 백업: 정리 전 백업은 현명합니다(Mac의 Time Machine, Windows의 Windows 백업 또는 파일 기록, Linux의 Timeshift 또는 Déjà Dup). 백업이 있는지 확인합니다.
  5. 세 가지 질문, 같은 메시지:
    • "절대 건드리지 말아야 할 것이 있나요? 폴더, 앱 또는 파일 유형(예: '내 프로젝트 폴더', 'WhatsApp의 모든 것', '모든 비디오')."
    • "빠른 정리(안전한 항목만, 약 5분) 또는 심층 정리(모든 항목, 하나씩 확인하는 개인 파일 포함)?"
    • "시작하기 전에 제가 살펴볼 모든 것을 보고 싶으신가요?"

아직 위의 시스템 확인 외에는 아무것도 실행하지 마십시오. 답변을 기다립니다. 그런 다음 노트 파일을 만듭니다:

## 절대 건드리지 않음
- <사용자가 지정한 각 항목, 가능한 경우 정확한 경로, 또는 "없음">

## 정리 기록

폴더 대신 유형을 지정한 경우("모든 비디오"), 그대로 기록하고 필터로 적용합니다. 나중에 세션에서 추가하는 경우, 즉시 ## 절대 건드리지 않음에 추가하고 한 줄로 확인합니다.

사용자가 모든 것을 먼저 보기를 요청한 경우, 측정(2단계)하고 살펴볼 항목의 전체 번호 목록을 그룹화하여 보여줍니다. 사용자가 항목을 삭제할 수 있도록 합니다. 사용자가 삭제한 항목은 "절대 건드리지 않음"이라고 말한 경우에만 목록에 추가하고, 그렇지 않으면 이 세션에서만 건너뜁니다.

1. 시작

  1. 빠른 정리 또는 심층 정리(이미 답변한 경우, 또는 요청이 특정 폴더를 지정한 경우 건너뜁니다. 그런 경우 해당 폴더를 측정하고, 작다면 개요도 측정).
  2. 여유 공간: 가이드의 명령어로 확인하고 평이한 말로 알려줍니다("460GB 중 32GB 여유").
  3. 백업: 가이드의 방법으로 확인하고 결과를 번역합니다: 최근(좋음), 오래됨(경고), 설정되지 않음(명확히 경고), 확인 불가(마지막 백업 시기 질문). 최근 백업이 없어도 안전한 캐시는 괜찮습니다. 개인 항목이 위험이므로, 그런 항목 전에 백업을 제안하고 계속할지 묻습니다.

2. 측정

가이드의 측정 명령어를 2분 제한과 함께 사용하여, 폴더당 하나의 명령어로 느린 폴더가 나머지를 지연시키지 않도록 합니다. 출력이 없으면 제한에 도달한 것입니다: 건너뛰었다고 말하고 넘어갑니다. 크기와 함께 "권한 거부" 오류가 있으면 부분적인 개수입니다: "최소한" 그 크기라고 말합니다. 약 100MB 미만은 건너뜁니다.

  • 빠른 정리: 가이드의 SAFE 위치만.
  • 심층 정리, 또는 좁은 질문이 작은 것으로 판명된 경우: 먼저 가이드의 개요 목록을 실행하여 공간이 실제로 어디에 있는지 확인한 다음, 큰 폴더에서만 한 단계 더 깊이 들어갑니다.
  • 큰 파일: 가이드의 빠른 검색을 사용하고, 홈 폴더의 전체 크롤링은 절대 하지 않습니다.

앱의 데이터를 "남겨진 것"이라고 부르기 전에, 앱이 실제로 제거되었는지 확인하고 날짜를 확인합니다: 지난 달에 변경된 데이터는 앱이 여전히 사용 중임을 의미합니다. 확실하지 않으면 CHECK입니다.

앱 캐시를 지우기 전에, 앱이 실행 중인지 확인합니다. 실행 중이면 SAFE 목록 자체에 알립니다("Chrome 캐시 4.1GB, Chrome을 먼저 종료하거나 건너뜁니다"). 하나의 "예"는 하나의 예로 유지됩니다.

3. 분류 및 질문

결과를 세 그룹으로 분류하고, 가장 큰 것부터 정렬합니다:

  • SAFE(안전): 캐시, 로그, 임시 파일. 스스로 다시 만들어지는 것들.
  • CHECK WITH ME(확인 필요): 개인적이거나 불분명한 모든 것. 항목당 한 행에 크기와 날짜. 중요한 것은 ⚠️로 표시(아래 참조).
  • DO NOT TOUCH(건드리지 않음): 시스템 파일, 절대 건드리지 않음 목록, 가이드의 건드리지 않음 목록. 큰 것은 표시하여 사용자가 확인했음을 알게 합니다.

전체 SAFE 목록을 크기와 합계가 포함된 표로 보여주고, 하나의 "예"를 기다립니다.

그런 다음 CHECK WITH ME를 한 번에 한 그룹씩(휴지통, 다운로드, 전화 백업 등) 진행하며, 각 항목마다 자체적인 "예"가 필요합니다. 한 번에 많은 표는 사용자를 압도합니다. 앞으로 올 그룹을 한 줄로 미리 보여줍니다. 그 미리보기에서 개인 항목은 휴지통으로 이동하여 되돌릴 수 있다고 한 번 말합니다.

4. 중요한 항목: 일시 중지 및 경고

잃으면 아픈 것들이 있습니다. 사용자가 이 중 하나에 예라고 말하면, 그 첫 번째 예에 따라 행동하지 마십시오. 멈추고 짧은 주의를 준 다음, 두 번째 구체적인 확인을 기다립니다.

중요한 것은 다음 중 하나를 의미합니다:

  • 사진, 비디오, 음악, 문서 또는 사용자 자신의 작업처럼 보이는 모든 것(프로젝트, 내보내기, 초안, 재구축 가능한 빌드 폴더가 아닌 소스 코드)
  • 지난 30일 이내에 변경된 모든 것
  • 전화 백업, 특히 유일하거나 가장 최근 것
  • 휴지통 또는 휴지통 비우기(영구적)
  • 채팅 앱 미디어, 비밀번호 또는 키 파일, 데이터베이스 볼륨(Docker 볼륨, 로컬 데이터베이스)
  • 캐시가 아닌 5GB 이상의 모든 것
  • 최근 백업이 없을 때의 모든 개인 항목

주의 사항 형식:

⚠️ 이 작업을 수행하기 전에: [항목] ([크기], 마지막 변경 [날짜]).

  • 잃게 될 것: [평이한 말, 예: "3월부터의 iPhone 유일한 백업"].
  • 되돌릴 수 있나요? [예: "네, 휴지통에서 비울 때까지 가능" / "아니요, 휴지통 비우기는 영구적입니다."]
  • 백업: [예: "백업이 없으므로 복구할 수 없습니다."]

계속하려면 **"예, [짧은 항목 이름]"**을 입력하거나 "건너뛰기"를 입력하세요.

주의 사항에서 "영구적" 또는 "되돌릴 수 없음"을 한 번 말하고, 주변 줄마다 반복하지 마십시오.

주의 사항 후 단순한 "예" 또는 "확인"은 영구적 작업(휴지통 비우기, 데이터베이스 볼륨 제거)에 충분하지 않습니다: 항목 이름을 요청하십시오. 되돌릴 수 있는 작업(휴지통으로 이동)의 경우 주의 사항 후 명확한 "예"면 괜찮습니다. 건너뛰기라고 말하면, 논평 없이 넘어갑니다. 두 번 이상 논쟁하지 마십시오: 한 번 명확히 주의를 주고, 그들의 결정을 존중합니다.

5. 안전하게 삭제

가이드의 명령어를 사용합니다:

  • SAFE 항목은 영구 삭제됩니다. 도구(npm, pip, brew, docker 등)가 설치된 경우 도구 자체의 정리 명령어를 선호합니다. 도구가 자체 레이아웃을 알기 때문입니다. 일반 캐시 폴더의 경우 폴더는 비우되 폴더 자체는 유지합니다.
  • CHECK WITH ME 항목은 "Put Back" 또는 "Restore"를 지원하는 방식으로 휴지통 또는 휴지통으로 이동되며, 한 번에 하나의 정확한 경로로 이동합니다.
  • 휴지통 비우기는 항상 자체 질문이며, ⚠️ 주의 사항이 있습니다. 먼저 내부의 가장 큰 항목을 날짜와 함께 표시합니다: 사람들은 실수로 물건을 버립니다.
  • 시스템이 보호하여 삭제를 거부하는 파일은 건너뛰고, 관리자 권한으로 escalate하지 않습니다. 사용자가 소유하고 읽기 전용이기 때문에만 거부하는 파일은 쓰기 가능하게 만들고 제거할 수 있습니다.

휴지통으로 이동한 후에는 공간이 휴지통을 비운 후에만 돌아온다는 것을 사용자에게 상기시킵니다.

6. 종료

다시 여유 공간을 확인한 다음, 표시합니다:

이전 여유 공간...
이후 여유 공간...
확보됨각 항목 및 크기
건너뜀(앱 열림, 또는 사용자가 거부)...
휴지통에서 대기 중...

그런 다음 실제로 찾은 내용에 맞춰 2-3개의 팁을 제공합니다(가이드에는 시스템별 팁이 있습니다).

노트 파일의 ## 정리 기록 아래에 1-2줄 항목을 추가합니다: 날짜, 이전 및 이후 여유 공간, 확보된 항목, 건너뛴 항목 및 이유. ## 절대 건드리지 않음은 그대로 둡니다.

묻지 않고 절대 삭제하지 않음

  • 사진, 비디오, 음악, 문서 및 내보낸 프로젝트
  • 지난 30일 이내의 스크린샷 및 화면 녹화
  • 사용자가 해당 항목에 대해 예라고 말하지 않는 한, 바탕화면, 문서, 다운로드, 사진, 동영상/비디오 또는 음악에 있는 모든 것

모든 시스템에서 절대 건드리지 않음

  • 운영 체제 폴더, 시스템 스냅샷 및 복원 지점, 부트 파일
  • 브라우저 프로필(로그인, 비밀번호, 기록). 캐시 하위 폴더만 대상
  • 클라우드 동기화 폴더(iCloud Drive, OneDrive, Dropbox, Google Drive): 거기서 삭제하면 모든 곳에서 삭제됩니다.
  • 사진 라이브러리 및 메시징 앱 폴더(대신 앱 내에서 미디어 정리)
  • 가상 머신 및 컨테이너 디스크 이미지
  • 비밀번호 관리자, SSH 및 GPG 키 폴더

관련 스킬