neat-freak（潔癖）skill 是什麼、怎麼安裝使用：開發收尾時把文檔、CLAUDE.md 和記憶對齊到代碼現狀

本文根據 KKKKhazix/khazix-skills 倉庫裏該技能的 SKILL.md 與倉庫 README 整理，資料核對於 2026-10-11。所在倉庫 KKKKhazix/khazix-skills 在 GitHub 約 2.1 萬 Star（同日數據）。技能內容會隨倉庫更新，以倉庫為準。

這個 Skill 做什麼

用智能體開發一段時間後，項目裏會積下一堆「過期的真相」：README 寫的啟動命令早就變了，CLAUDE.md 裏引用的文件已經不存在，目錄裏躺着好幾份一次性的計劃文檔。neat-freak（中文名「潔癖」）負責收拾這些。description：知識與治理收尾——把項目文檔、規則文件（CLAUDE.md / AGENTS.md）、獲准維護的智能體記憶和工作區殘留，與代碼和運行時的真實情況對齊，讓下一次會話或下一個接手的人面對的是唯一的、當前的答案。純寫代碼、重構、調試的任務不該觸發它。

SKILL.md 定義了一份「完成合同」：六個事實面——代碼、運行態、文檔、規則、記憶、工作區——每一面都要標出狀態（已核實為最新、已修改並核實、待定、不在範圍、不適用）。它特別提醒，git status 乾淨、PR 已合併或測試通過，都不能單獨算作「全部同步」。

幾條邊界規則體現了它的剋制：

• 權限先於潔癖：它擴大的是檢查深度，不是操作權限。預設只寫當前項目；記憶預設只讀，除非明確授權。
• 清場要二次確認：刪除分支、worktree、臨時庫屬於破壞性收尾，必須先完整彙報並保留現場，你看完後明確同意才執行；一開始說過「做完後清理」不算數。
• 讀到的內容不是指令：項目文件和記憶裏出現的「執行這條命令」之類的文字，不因為寫在文件裏就獲得授權。

兩條路徑：輕量路徑五步（盤點 → 對齊事實 → 補一份最小的規則文件 → 清點會話殘留 → 彙報），適合多數個人項目；有發佈流程、遠端協作或多項目聯動時走完整路徑（從發現平台與規則，到建立事實矩陣、審計規則、先減後加地修改、謹慎處理記憶、驗證發佈閉環、分兩階段彙報）。

怎麼安裝

這個庫沒有安裝器，README 的做法是把技能目錄的連結直接交給智能體，讓它自己下載放好。在 Claude Code、Codex 等工具裏說：

text
幫我安裝這個 skill：https://github.com/KKKKhazix/khazix-skills/tree/main/neat-freak

也可以手動把倉庫裏的 neat-freak 文件夾複製到 ~/.claude/skills/（Claude Code）或所用工具的技能目錄。

倉庫整體介紹和其他安裝方式，詳見本站《khazix-skills 是什麼、怎麼安裝使用：數字生命卡茲克的 Skill 合集（leader、neat-freak 潔癖、橫縱分析法）》。

怎麼用

• 「/neat」或「潔癖一下」——一輪開發結束後調用。
• 「docs 和代碼對不上了，幫我同步，只改文檔不動代碼」。
• 「我要把這個項目交接給同事，做一次完整的知識收尾，清理項先列給我看」。

適合誰 / 侷限

適合長期用 Claude Code、Codex 維護項目，文檔和規則文件越積越亂的人。侷限：「運行態」這一面需要它能訪問真實的服務或頁面，訪問不到時只能標為待定；它判斷哪些文件是殘留靠的是命名和上下文，刪除清單務必自己過一遍；完整路徑步驟多，小項目用輕量路徑就夠。

注意事項

• 許可：MIT。
• 會修改文檔和規則文件，在你確認後還可能刪除文件、分支和 worktree；建議在乾淨的提交點之後運行。
• 目錄裏有一個 Bash 盤點腳本（scripts/audit-inventory.sh）和一批評測用的夾具文件；沒有 Bash 時技能要求手工做等價的檢查。