開源「潔癖.skill」，讓你的Agent越用越聰明。

今天沒選題了，所以想開源一個我自己做的，已經(jīng)用了快1個多月，迭代了好多版的一個我覺得很有用的Skill。

我把它稱為，潔癖.Skill。

名字可能聽著還挺呆逼的，但是我覺得它能干的事，雖然看著非常的簡單，但是卻又很實用，在公司內(nèi)部同事和一些我們的合作伙伴使用后，還都反饋挺不錯的。

做的事大概就是，每次你在Agent里，做完一個功能或者又解決了一個BUG，就調(diào)用這個潔癖Skill，然后說一聲幫我全面審查一下或者直接就/Neat一下，它就會自動審查你整個項目的文檔體系和記憶文件，然后根據(jù)這次對話，把該改的文檔、記憶、CLAUMD.md進行迭代，確保非常干凈之后，最后，再給你一份變更摘要，讓你知道改了啥東西。

四個平臺通用，Claude Code、Codex、OpenCode、OpenClaw都能裝。

大概就是這么個東西。

相信我，這玩意會讓你的Agent越來越聰明，也非常符合潔癖的定義。

它就是我自己現(xiàn)在每天用得最多的技能，沒有之一。

每次一個任務(wù)做完，要退出這個窗口的時候，如果不跑一遍/neat，我就渾身難受，如坐針氈如芒刺背如鯁在喉。

如果你看過我之前寫的那篇，你大概能理解這種感覺。

做這個Skill的契機，其實特別簡單。

大家現(xiàn)在也都知道，在很多時候，你的Agent之所以越用越笨，其實是因為，你的上下文過于混亂。

上下文不止是你跟你的Agent在單次對話中的聊天記錄，也包括你這個項目里面的，各種文檔，還有約束，還有記憶。

但是其實很多的小伙伴，在用Agent的時候，比如CC和Codex去做一個項目，初期的文檔規(guī)范倒是規(guī)劃的挺好，但是每次迭代，每次更新，其實你會發(fā)現(xiàn)，這些文檔和記憶，都是疏于維護，你可能代碼都迭代了7、8輪了，新功能都上了無數(shù)了，但是你的文檔，還是最開始的1.0.0版本的初始文檔。

其實不止Agent，很多公司內(nèi)部項目的文檔也都這樣，前期雄心壯志，文檔規(guī)范賊清晰，過兩個月之后，規(guī)范？文檔？你在說什么，我聽不懂。

我自己的項目里其實就出過這種事，就比如我做的AIHOT AI熱點監(jiān)控系統(tǒng)（PS：這個我最近會再打磨打磨降降成本，然后會免費向所有人開放，到時候也會發(fā)文章介紹，希望對大家有用。）

現(xiàn)在里面各種功能其實已經(jīng)膨脹的比較狠了。

光精選策略相關(guān)的功能就有亂七八糟的5、6個，一個信息抓到系統(tǒng)里，會需要十幾個步驟進行數(shù)據(jù)清洗、加工、好幾層評估等等，然后才會落庫。

現(xiàn)在每天處理的量級，在我嚴(yán)格挑選和管控信源的前提下，還是會有500多條信源產(chǎn)出的數(shù)據(jù)。

然后我當(dāng)時剛開始做的時候，其實想把整個項目后續(xù)封裝成CLI，允許所有人的Agent都可以來瀏覽這上面的數(shù)據(jù)，能讓大家用起來更方便，所以呢，我就把數(shù)據(jù)庫從SQLite換成了PostgreSQL。

但是這個切換其實工作量還是有點大的，當(dāng)時用的還是Opus 4.6，時間一長的，真的就是顧頭不顧尾，然后，搞完以后，文檔啥的我忘記改了。

結(jié)果后來我繼續(xù)開發(fā)新功能的時候，Claude還在調(diào)用SQLite的語法，我當(dāng)時還以為是模型啥的原因，搞了半天，發(fā)現(xiàn)是文檔沒改，包括我的CLAUDE.md里面，還赫然寫著大概項目使用SQLite數(shù)據(jù)庫這個意思。

當(dāng)時搞得還挺惡心的。

這種只是一個小摩擦，當(dāng)你如果經(jīng)歷多了之后，你會發(fā)現(xiàn)，Agent很多時候犯的大多數(shù)莫名其妙的錯誤，根源其實都不是模型笨，是文檔和記憶已經(jīng)都腦腐了，都出現(xiàn)明顯的混亂了。

很多朋友可能會說，這不是專業(yè)開發(fā)者才需要關(guān)心的事嗎？

但是我想說，恰恰相反，很多我的專業(yè)開發(fā)者朋友都有自己的一套工程化習(xí)慣，git commit message寫得規(guī)規(guī)矩矩，README隨手就更新。

真正被這個問題折磨最深的，反而是我們這些借助Agent來vibe coding的人，比如設(shè)計師、產(chǎn)品經(jīng)理、內(nèi)容創(chuàng)作者，當(dāng)然也包括我自己。

vibe coding前期特別爽，跟AI聊兩句代碼就出來了，功能也就跑起來了。但項目一旦做大，文檔就不可避免地開始混亂，而且很多人也完全沒有維護的概念，到最后就越來越混亂，你就會感覺到，我靠我的Agent怎么越來越笨。

而這個維護，就是今天這個潔癖.skill，它要做的事情。

之前Claude Code有一個功能叫AutoDream，也就是做夢，我也寫過文章：，我當(dāng)時挺興奮的，因為這玩意感覺就是我想要的東西？

但實際用了以后我發(fā)現(xiàn)一個很致命的問題。

AutoDream只動記憶，不動項目文檔，這就尷尬的一比了。

如果你用Agent開發(fā)過任何東西，你就知道，一個項目里的知識其實分三層，每一層服務(wù)的人不太一樣。

第一層是Agent自己的記憶系統(tǒng)，過去的聊天記錄、項目的隱性知識。

第二層是項目根目錄的CLAUDE.md，給AI自己看的，項目約定、結(jié)構(gòu)、紅線、路由清單等等。

第三層是docs/目錄和README，給其他人看的，比如Agent、同事、下游開發(fā)者等等，比如接入指南、架構(gòu)說明、運維手冊等等。

這三層受眾不同，職責(zé)不重疊。

比如CLAUDE.md里寫新增了五個路由不等于docs/integration-guide.md里寫下游怎么接這五個路由。

前者是提醒自己，后者是教別人，兩份作用是完全不同的，都得寫。

AutoDream的問題就在于，它只管了第一層，記憶文件確實變干凈了，但是另外兩個，它確實是不管，所以也就導(dǎo)致，我用下來，確實作用不大。

所以，這才有了我的潔癖.skill。

目前老規(guī)矩，已經(jīng)在我自己的Skills倉庫里面開源，所有人都可以隨意使用：

https://github.com/KKKKhazix/khazix-skills

里面最核心的原則，其實就是合并優(yōu)于追加，刪除優(yōu)于保留。

這個跟大多數(shù)人的直覺是反的，因為很多時候，大家會覺得，信息多總比信息少好吧？萬一以后用得上呢？

但其實在AI協(xié)作的場景里，信息多不是優(yōu)勢，信息準(zhǔn)才是，坦率的講，一條過期的記憶，比沒有記憶更糟糕，因為沒有記憶的時候，AI至少知道自己不知道，它會問你。

但如果它讀到了一條過期的信息，它會以為那是對的，然后基于錯誤的前提做事。

OpenClaw越用越笨，就是它的記憶系統(tǒng)實在是過于臃腫了。

而當(dāng)你安裝了潔癖.skill，每次跑潔癖.skill的時候，它會按順序做五件事。

第一步，就是先強制機械式盤點。把項目里所有的md文件全列出來，每一個都讀一遍，都不要漏掉，因為之前遇到過好幾次，你看著是給你改了，結(jié)果哎就給你漏了那么一個文檔，關(guān)鍵還是賊關(guān)鍵的。

第二步，用我的變更影響矩陣文檔去識別一下需要改什么。不只看對話里有什么新事實，也要去看新事實會波及哪些文檔層級。

然后這一步還有一個關(guān)鍵檢查，這次對話是不是跨項目的？如果改了項目A而項目B依賴它，那項目B的docs也得跟著改，這個其實是歷次同步最常翻的車。

第三步，直接改，這里有一個順序步驟，先改docs/，再改CLAUDE.md，最后整理記憶。

第四步，自檢清單，基本是我的skill里面的老演員了，必然都會有自檢清單，就比如新增的環(huán)境變量，在runbook和CLAUDE.md都出現(xiàn)了嗎？有沒有相對時間遺留等等之類的東西，確認(rèn)一遍。

第五步，輸出一份變更摘要，就是這樣的東西。

這五步看著麻煩，其實就是skill自己的過程，你根本不用管，你要做的，就是運行一下這個skill。

最簡單的方式，就是直接輸入：/neat。

就可以了。

或者你說中文“審查一下”、“整理一下”啥的都行。

我自己一般在所有任務(wù)的收尾，都必定會運行一下/neat。

我把潔癖.skill一般當(dāng)類似于游戲的存檔機制用，這次要結(jié)束了，要存檔了，就運行一下/neat，然后，下次打開一個新的會話，還可以接著來。

說實話，潔癖這個東西看起來只是在整理文檔，但它真正解決的問題我覺得比整理文檔有用的多。

它會讓你的知識體系從依賴對話上下文變成了依賴持久化文檔，也就是說，對話可以隨時關(guān)，但文檔，永遠在。

因為上下文腐敗問題，所以其實大家都懂，一個對話里，信息越多模型能力越差，然后再Claude里，雖然Opus 4.7說有1M上下文，但是我測試的時候，經(jīng)常到了500K左右就有點不對勁了，所以我現(xiàn)在幾乎是選擇在400K左右進行一次整理并存檔，然后新開窗口了。

新開窗口以后，因為文檔和記憶管理的足夠好，所以你幾乎不需要給任何提示，有任何問題直接說就行，Agent都能非常精準(zhǔn)的給你解決，解決完了你繼續(xù)/neat進行存檔，你會發(fā)現(xiàn)，真的就是，越用越聰明。

這個skill最近讓公司同事和幾個合作企業(yè)的朋友試了一下，大家居然意外的說挺好用的。

所以，這次也開源出來，希望對大家，也都有用。

我們在生活中，經(jīng)常需要斷舍離一下。

那我覺得，放在AI時代，也依然有用。

過期的就刪，重復(fù)的就合，模糊的就改。

讓你的知識庫，永遠只保留此刻最準(zhǔn)確的真相。

這大概是AI時代。

我覺得比學(xué)會寫Prompt更重要的一件小事。

以上，既然看到這里了，如果覺得不錯，隨手點個贊、在看、轉(zhuǎn)發(fā)三連吧，如果想第一時間收到推送，也可以給我個星標(biāo)?～謝謝你看我的文章，我們，下次再見。

>/ 作者：卡茲克

>/ 投稿或爆料，請聯(lián)系郵箱：wzglyay@virxact.com