Skip to content

开源「洁癖.Skill」:让AI Agent越用越聪明的文档整理神器

2026年4月30日

每次在Agent里做完一个功能或解决一个BUG,就调用这个洁癖Skill,它会自动审查整个项目的文档体系和记忆文件,把该改的文档、记忆、CLAUDE.md进行迭代,确保干净后,再给你一份变更摘要。

这个Skill我用了快1个月,迭代了好多版,在公司内部和合作伙伴使用后反馈都不错。

它能做什么

四个平台通用:Claude Code、Codex、OpenCode、OpenClaw都能装。

每次任务完成后,运行一下/neat,它会自动:

  1. 全面审查项目文档体系和记忆文件
  2. 根据这次对话内容迭代更新相关文档
  3. 清理过期的记忆和冗余信息
  4. 输出一份变更摘要

简单来说:让Agent越用越聪明,符合"洁癖"的定义。

为什么需要它

用Agent开发项目时,你会发现一个常见问题:

初期文档规划得挺好,但每次迭代更新后,文档和记忆都疏于维护。代码可能已经迭代了7、8轮,新功能上了无数个,但文档还是最初1.0版本的初始状态。

更严重的是:过期的记忆比没有记忆更糟糕。

没有记忆时,AI至少知道自己不知道,会主动问你。但如果它读到了一条过期的信息,它会以为那是对的,然后基于错误的前提做事。

OpenClaw越用越笨,往往就是因为记忆系统过于臃肿、文档已经"脑腐"了。

AutoDream的问题

Claude Code有一个功能叫AutoDream,能自动整理记忆。但它只动记忆,不管项目文档。

实际上,一个项目里的知识分三层:

层级内容受众
第一层Agent记忆系统Agent自己
第二层CLAUDE.md给AI自己看的约束和约定
第三层docs/目录和README给其他人/其他Agent看的文档

AutoDream只管了第一层,所以作用有限。

洁癖.Skill的五步流程

  1. 强制盘点:把项目里所有md文件全列出来,逐个读取,一个不漏
  2. 识别变更:用变更影响矩阵识别需要改什么,检查是否涉及跨项目依赖
  3. 按序修改:先改docs/ → 再改CLAUDE.md → 最后整理记忆
  4. 自检清单:确认新增的环境变量是否在各文档中出现、有无相对时间遗留等
  5. 变更摘要:输出一份清晰的变更记录

核心理念

合并优于追加,删除优于保留。

这跟大多数人的直觉相反——很多人觉得信息多总比少好,万一以后用得上呢?

但在AI协作场景里,信息准才是优势,一条过期的记忆比没有记忆更糟糕。

怎么使用

bash
# 运行洁癖.Skill
/neat

# 或者直接说中文
"审查一下"
"整理一下"

最佳实践:所有任务收尾时必定运行/neat,相当于游戏存档。下次打开新会话,Agent依然精准高效。

项目地址

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

写在最后

AI时代,断舍离依然有用:

过期的就删,重复的就合,模糊的就改。 让你的知识库,永远只保留此刻最准确的真相。

这大概是AI时代,比学会写Prompt更重要的一件小事。

不要孤军奋战啦!

加入微信群一起学习交流 AI

与大神一起使用 OpenClaw、Hermes、Claude Code、Seedance 2.0、GPT-Image-2 等

微信公众号

扫码关注微信公众号
私信 "加群",将自动获取微信群二维码

探索 AI 世界,掌握智能未来