anti-distill

anti-distill skill 概覽

anti-distill 的功能是什麼

anti-distill skill 是一種文件改寫技能，專門把詳盡的員工技能檔、工作指南或 persona 文件，轉成「看起來完整，但核心知識已被抽離」的版本。它的實際用途不是一般摘要，而是先判斷哪些內容可以保留、哪些應該淡化、哪些需要移除、哪些必須遮罩，再依此重寫。

誰適合使用 anti-distill

anti-distill 最適合已經寫好內部技能文件，現在想整理出較適合對外或可安全送審版本的人。它特別適合處理 SKILL.md、work.md、persona.md、SOP、交接文件，或混合 Markdown/TXT/PDF 的 Rewriting 任務。若你的需求是忠實保留專家層級的細節，這個工具就不適合你。

anti-distill skill 與其他工具的差異

anti-distill 最大的差異，在於它採用明確的「分類＋重寫」流程，而不是只靠一句模糊的「把內容寫得不要那麼具體」。repo 內提供了獨立的 prompt 檔，分別處理分類與不同文件型態：prompts/classifier.md、prompts/diluter_work.md、prompts/diluter_persona.md、prompts/diluter_general.md。這樣的結構能降低改寫時的猜測空間，尤其是在處理工作知識與 persona 特徵時更有區別。

安裝 anti-distill 前要先理解的取捨

anti-distill 的設計目標就是刻意降低實用性。理想輸出應該在結構上仍可信、技術上不算錯，但會變得更不易執行、更不具體，也更難轉移使用。這正是它的目的。風險在於，可能清得太乾淨，最後只剩明顯空泛的內容；也可能清得不夠，仍留下操作 know-how、門檻值、升級路徑或判斷邏輯。

如何使用 anti-distill skill

在 Claude Code 或 OpenClaw 安裝 anti-distill

這個 repo 提供的是手動安裝方式，不是透過套件安裝器。若在 Claude Code 中使用，請 clone 到專案層級或全域 skills 目錄：

mkdir -p .claude/skills
git clone https://github.com/leilei926524-tech/anti-distill.git .claude/skills/anti-distill

或安裝到全域：

git clone https://github.com/leilei926524-tech/anti-distill.git ~/.claude/skills/anti-distill

若是 OpenClaw：

git clone https://github.com/leilei926524-tech/anti-distill.git ~/.openclaw/workspace/skills/anti-distill

之後用 /anti-distill 呼叫即可。不需要額外安裝 Python 相依套件。

anti-distill 需要哪些輸入

anti-distill skill 可接受：

• 直接提供檔案路徑
• 類似 colleagues/{slug}/ 的同事技能資料夾
• 直接貼上的文件內容
• 當你要求它尋找技能檔時，進行本機檔案搜尋

它能辨識同事技能常見模式，例如 work.md + persona.md 或 ## Layer 0，也支援一般文件，例如 Markdown、TXT 或 PDF。最適合的輸入，是那些包含具體規則、門檻值、實例、決策分支、具名人物、事故記憶，或「我們實際上就是這樣做」這類內容的文件，因為這正是 anti-distill 最能發揮價值的地方。

如何寫出更有效的 anti-distill 提示

弱的請求像是：「clean this skill。」

更好的 anti-distill 使用方式，應該明確交代：

• 要讀哪個檔案
• 文件屬於哪種類型
• 要清理到什麼程度
• 你希望產出哪些輸出檔

範例：
/anti-distill Read colleagues/zhangsan/. This is a colleague-skill with work and persona content. Use medium cleaning. Keep structure and formatting, but remove concrete thresholds, troubleshooting memory, escalation shortcuts, and highly distinctive behavior cues. Generate a cleaned version plus a private backup of removed knowledge.

這樣效果更好，因為 repo 的核心邏輯，就是依據清理強度，以及辨識高價值知識類別來運作，例如常見陷阱、判斷啟發、人脈型知識，以及隱性工作流程。

使用 anti-distill 的最佳流程與優先閱讀檔案

如果你想在真正信任 anti-distill 之前先看懂它，建議按以下順序閱讀：

1. README.md：了解產品目的與輸出模型
2. INSTALL.md：確認安裝路徑
3. SKILL.md：查看觸發條件、工具規則與主要流程
4. prompts/classifier.md：了解標籤系統 [SAFE]、[DILUTE]、[REMOVE]、[MASK]
5. 依文件型別選讀對應的 diluter prompt
6. examples/zhangsan_before_after.md：校準輸出品質

實務上，建議先從 medium 強度開始，檢查哪些內容還被保留下來，再只重跑那些處理得不夠好的區段。Heavy cleaning 雖然省時，但更容易產出一眼看穿的制式企業空話。

anti-distill skill 常見問題

anti-distill 會比一般改寫 prompt 更好嗎？

通常會，前提是你的目標是「可控的降階處理」，而不是單純換句話說。一般 prompt 常常會保留過多細節，或反過來把結構刪得太兇。anti-distill 比較可靠，因為它把分類與重寫拆開處理，並且對不同文件類型有各自的改寫規則。

anti-distill 適合新手嗎？

適合，前提是你願意自己審查改寫後的文件。anti-distill 的使用方式不複雜：安裝、呼叫、選強度、檢查輸出。真正較難的是判斷——也就是看得出哪些殘留段落仍透露太多。新手在拿它處理重要檔案之前，最好先對照內附的 before/after 範例。

什麼情況不該使用 anti-distill？

不要把 anti-distill 用在公開文件、onboarding 文件，或任何重視操作實用性的知識庫。它也不適合內容很短、又沒什麼具體細節的文件；如果原始內容本來就很泛，anti-distill 幾乎沒有太多可優化空間，反而只會讓內容更弱。

anti-distill 是否適合多語言與混合式 repo？

可以。這個 skill 明確支援英文與中文，並會用使用者的語言回應。它也能處理混合格式檔案，並透過宿主工具原生的讀取能力讀取圖片或 PDF；但輸出品質仍取決於原始文件是否清楚暴露出具體 know-how。

如何改進 anti-distill skill 的使用效果

給 anti-distill 更好的來源材料

anti-distill 在內容豐富、細節具體的來源文本上表現最好。如果你的輸入包含明確門檻值、事故經驗、真實判斷標準、示範對話，或具名協作路徑，這個 skill 就能更精準地判斷哪些該保留、淡化或移除。若來源本身已經很模糊，輸出通常也不會明顯變好，因為可轉換的有效訊號本來就少。

留意 anti-distill 的主要失敗模式

anti-distill 最常見的失敗模式包括：

• 不小心保留了可直接執行的細節
• 把太多內容換成一看就空泛的廢話
• 把語氣壓得太平，讓文件顯得可疑
• 漏掉藏在範例或對話中的隱性知識

請特別檢查數字、if X then Y 類型分支、具名負責人，以及 postmortem 風格的說明。這些內容常常比章節標題看起來更有價值。

用明確的改寫限制來優化 anti-distill 提示

想讓 anti-distill 用得更好，就要明確告訴它哪些要保留、哪些是重點清理對象。有效限制包括：

• 保留標題、清單與章節順序
• 保持術語在技術上正確
• 移除具體限制、內部名稱與根因記憶
• 泛化範例，但不要改變主題覆蓋範圍
• 讓輸出長度維持在相近區間

這些限制，正好也對齊 repo 本身對品質的要求，例如保留結構與維持大致相近的篇幅。

anti-distill 第一輪之後要再迭代

不要把第一次跑出的 anti-distill 結果直接當成最終版。請先審查清理後的版本，標出那些仍然傳遞真實判斷能力的段落，再針對特定區塊重跑。例如：「Re-clean only CR 重点 and 经验知识库; these still reveal specific execution standards.」這種逐段迭代，通常比直接把整份文件從 medium 一口氣切到 heavy cleaning，效果更好。