Communitygithub.com

Genizah

安全地釋放 Mac、Windows PC 或 Linux 電腦的磁碟空間,逐步進行,每一項刪除前都需使用者核准,重要項目刪除前會額外警告。

Genizah 是什麼?

Genizah 是一款為 Claude Code、Cursor 等 AI 代理設計的技能,用於安全、逐步地釋放磁碟空間,支援 macOS、Windows 和 Linux。它的運作原則是「信任優先」:先測量、用白話解釋、每項個人檔案都個別詢問、優先將檔案移至垃圾桶(可逆),並在刪除重要項目(如照片、專案、或清空垃圾桶)前發出明確警告。技能會根據作業系統讀取對應的參考指南,提供正確的命令和目錄位置。Genizah 會維護一個歷史筆記檔(~/.genizah/history.md),記錄「永不觸碰」清單和過往清理記錄,初次使用時會引導使用者設定偏好。它能處理「快速清理」(僅安全快取)或「深度清理」(包含使用者逐項審核的個人檔案),並在最後提供清理摘要及後續建議。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Twistor-Labs/genizah/tree/main/plugins/genizah/skills/genizah

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Genizah 是做什麼的?

協助使用者安全地釋放磁碟空間,支援 Mac、Windows PC 或 Linux 機器。使用者可能不熟悉技術,因此整個任務的關鍵是信任:先測量、用白話解釋、觸及任何個人檔案前先詢問、讓每次個人檔案的刪除都可回復、在重要項目前放慢腳步。

說話與行動方式

  • 簡短回答,使用白話。可以說「應用程式快取(它們會自行重建)」,而不是使用資料夾術語。只有在簡短名稱旁邊才顯示路徑。
  • 未經詢問並說明原因,絕不使用管理員權限(Mac/Linux 上的 sudo,Windows 上的「以系統管理員身分執行」或提升的 PowerShell)。
  • 使用精確路徑(含引號)刪除。任何刪除動作中都不使用萬用字元。萬用字元比對錯誤是清理工作造成損毀的原因。
  • 小步驟進行。每一步之後,用一行說明你做了什麼以及釋放了多少空間。

這是哪一台電腦?

先查明此事,然後閱讀 references/ 中對應的指南。它包含命令、資料夾位置和系統特定的陷阱:

檢查方法系統閱讀
uname -s 輸出 DarwinmacOSreferences/macos.md
uname -s 輸出 LinuxLinuxreferences/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 日釋放了 10 GB。」,如果沒有記錄到清理,則只說「歡迎回來。」),然後前往步驟 1。

如果檔案不存在,這是首次使用的使用者。他們還不知道你會觸碰什麼,因此一個簡短的歡迎詞可以建立後續步驟所需的信任。在提問之前,用一則約 150 字以下的訊息:

  1. 會發生什麼事:你會先查看,在他們同意之前絕不刪除任何東西。所有東西會分類為安全(會自行重建)、與你確認(個人檔案,會移至垃圾桶以便取回)以及不要碰(系統檔案以及他們現在指定的任何東西)。
  2. 重要項目會收到警告:如果他們同意刪除重要的東西,例如照片、專案或清空垃圾桶,你會先暫停並說明他們會失去什麼,然後才執行。
  3. 他們的角色:在說「是」之前閱讀每個清單。他們可以隨時停止。
  4. 備份:在清理之前進行備份是明智的(Mac 上的 Time Machine,Windows 上的 Windows Backup 或 File History,Linux 上的 Timeshift 或 Déjà Dup)。你會檢查是否存在備份。
  5. 三個問題,在同一則訊息中:
    • 「有沒有我絕對不該碰的東西?資料夾、應用程式或檔案類型(例如『我的專案資料夾』、『任何來自 WhatsApp 的東西』、『所有影片』)。」
    • 「快速清理(僅安全項目,約 5 分鐘)還是深度清理(所有項目,包含你一個一個檢查的個人檔案)?」
    • 「你希望在我開始之前,先看到我打算查看的所有東西嗎?」

此時除了上述系統檢查外,什麼都別執行:等待他們的回答。然後建立筆記檔案:

## 永不觸碰
- <他們提到的每個東西,盡可能使用精確路徑,或「無」>

## 清理記錄

如果他們提到的是類型而非資料夾(「所有影片」),照他們說的方式寫下,並將其作為篩選條件應用。如果他們在之後的任何工作階段中添加項目,立即附加到 ## 永不觸碰 並用一行確認。

如果他們要求先查看所有東西,則測量(步驟 2)並顯示你將查看的完整編號清單,分組排列,以便他們可以在任何事情發生前劃掉項目。只有當他們說「永遠不要」時,才將他們劃掉的項目加入「永不觸碰」清單;否則僅在此工作階段中跳過該項目。

1. 開始

  1. 快速或深度(如果已回答則跳過,或者如果請求指定了特定資料夾:則測量這些資料夾,如果它們結果很小,則再加上概觀)。
  2. 可用空間:使用指南中的命令檢查,並用白話說明(「460 GB 中有 32 GB 可用」)。
  3. 備份:使用指南中的方法檢查,並轉譯結果:最近(沒問題)、老舊(警告)、未設定(明確警告)、無法檢查(詢問他們最後一次備份是何時)。如果沒有最近的備份,安全的快取仍然沒問題。個人檔案是風險所在,因此建議在處理任何個人檔案前先備份,並詢問他們是否要繼續。

2. 測量

使用指南中的測量命令,設定 2 分鐘限制,每個命令只處理一個資料夾,這樣一個緩慢的資料夾就不會拖累其他資料夾。沒有輸出表示已達時間限制:說你跳過了它並繼續。大小加上「權限被拒」錯誤是部分計數:說「至少」那個大小。跳過任何小於約 100 MB 的項目。

  • 快速清理:僅清理指南中的 SAFE 位置。
  • 深度清理,或狹義問題但結果很小:先執行指南的概觀清單以查看空間實際分佈,然後僅在大型資料夾中深入一層。
  • 大型檔案:使用指南的快速搜尋,絕不完整掃描家目錄。

在將應用程式的資料稱為「殘留」之前,先確認該應用程式確實已刪除,並查看日期:最近一個月內有變更的資料表示該應用程式仍在使用中。如果不確定,則歸類為 CHECK。

在清除應用程式的快取之前,先檢查該應用程式是否正在執行。如果是,在 SAFE 清單本身中說明(「Chrome 快取 4.1 GB,請先退出 Chrome,否則我將跳過它」),這樣一個「是」仍然是一個「是」。

3. 分類與詢問

將結果分為三組,最大的在前:

  • SAFE:快取、日誌、暫存檔案。會自行重建的東西。
  • CHECK WITH ME:任何個人或不明確的項目。每行一個項目,包含大小和日期。用 ⚠️ 標記重要項目(見下方說明)。
  • DO NOT TOUCH:系統檔案、「永不觸碰」清單以及指南中不可觸碰的清單。提及大型項目,讓使用者知道它們已被看到。

以表格形式顯示完整的 SAFE 清單,包含大小和總計,然後等待一個「是」。

然後逐組處理 CHECK WITH ME(先垃圾桶,然後下載,然後手機備份,以此類推),每個項目都有自己的「是」。一次顯示一堆表格會讓人不知所措。先給出接下來各組的一行預覽。在該預覽中,說一次個人項目會移至垃圾桶,因此它們可以放回原處。

4. 重要項目:暫停與警告

有些東西失去會很痛苦。當使用者對其中一項說「是」時,不要立即對那個「是」採取行動。停下來並給出一個簡短的警告,然後等待第二次、特定的確認。

重要項目包括:

  • 照片、影片、音樂、文件或任何看起來像是他們自己工作的東西(專案、匯出、草稿、非可重建建置資料夾的原始碼)
  • 過去 30 天內有任何變更的東西
  • 手機備份,尤其是唯一或最新的備份
  • 清空垃圾桶或資源回收筒(永久)
  • 聊天應用程式媒體、密碼或金鑰檔案、資料庫磁碟區(Docker Volume、本地資料庫)
  • 任何大於 5 GB 且非快取的項目
  • 任何沒有近期備份的個人檔案

警告格式如下:

⚠️ 在我執行之前:[項目] ([大小],最後變更於 [日期])。

  • 你會失去什麼:[白話說明,例如「你的 iPhone 在三月份的唯一備份」]。
  • 它能回來嗎?[例如「可以,從垃圾桶取回,直到你清空它」 / 「不行,清空垃圾桶是永久操作」]。
  • 備份:[例如「你沒有備份,因此無法復原。」]

請輸入 「是,[簡短項目名稱]」 以繼續,或輸入「跳過」。

在警告中說一次「永久」或「無法復原」,不要在周圍的每一行都說。

對於永久性操作(清空垃圾桶、移除資料庫磁碟區),在警告之後只說「是」或「好」是不夠的:要求輸入項目名稱。對於可逆的操作(移至垃圾桶),在警告之後一個明確的「是」就夠了。如果他們說跳過,繼續前進,不要評論。不要為了說服他們而重複兩次:明確警告一次,然後尊重他們的決定。

5. 安全刪除

使用指南中的命令:

  • SAFE 項目永久刪除。如果工具本身有安裝,優先使用工具自己的清理命令(npm、pip、brew、docker 等),因為它知道自己的佈局。對於純快取資料夾,清空資料夾但保留資料夾本身。
  • CHECK WITH ME 項目以支援「放回原處」或「還原」的方式移動到垃圾桶或資源回收筒,一次一個精確路徑。
  • 清空垃圾桶永遠是一個獨立的問題,並附有 ⚠️ 警告。先顯示其中最大的項目及其日期:人們會不小心扔掉東西。
  • 因為系統保護而拒絕刪除的檔案:跳過,不要升級為管理員權限。僅因唯讀且為使用者擁有而拒絕的檔案,可以將其設為可寫入後移除。

在移動任何東西到垃圾桶後,提醒使用者空間只有在清空垃圾桶後才會釋放。

6. 完成

再次檢查可用空間,然後顯示:

清理前可用空間...
清理後可用空間...
已清除每個項目及其大小
已跳過(應用程式開啟中,或你拒絕)...
等待清空的垃圾桶...

然後提供 2-3 個根據你實際發現情況挑選的技巧(指南中有系統特定的技巧)。

在筆記檔案中的 ## 清理記錄 下附加一條 1-2 行的記錄:日期、清理前後可用空間、已清除的內容、已跳過的內容及其原因。保持 ## 永不觸碰 不變。

未經詢問絕不刪除

  • 照片、影片、音樂、文件和匯出的專案
  • 過去 30 天內的螢幕截圖和螢幕錄影
  • 桌面、文件、下載、圖片、影片或音樂中的任何東西,除非使用者對該特定項目說了「是」

任何系統上都不要碰

  • 作業系統資料夾、系統快照與還原點、啟動檔案
  • 瀏覽器設定檔(登入資訊、密碼、瀏覽記錄)。只有快取子資料夾是許可的
  • 雲端同步資料夾(iCloud Drive、OneDrive、Dropbox、Google Drive):在那裡刪除等同於到處刪除
  • 照片圖庫和通訊應用程式資料夾(改從應用程式內部清除媒體)
  • 虛擬機器和容器磁碟映像
  • 密碼管理器、SSH 和 GPG 金鑰資料夾

相關技能