Appearance
每次在Agent里做完一个功能或解决一个BUG,就调用这个洁癖Skill,它会自动审查整个项目的文档体系和记忆文件,把该改的文档、记忆、CLAUDE.md进行迭代,确保干净后,再给你一份变更摘要。
这个Skill我用了快1个月,迭代了好多版,在公司内部和合作伙伴使用后反馈都不错。
它能做什么
四个平台通用:Claude Code、Codex、OpenCode、OpenClaw都能装。
每次任务完成后,运行一下/neat,它会自动:
- 全面审查项目文档体系和记忆文件
- 根据这次对话内容迭代更新相关文档
- 清理过期的记忆和冗余信息
- 输出一份变更摘要
简单来说:让Agent越用越聪明,符合"洁癖"的定义。
为什么需要它
用Agent开发项目时,你会发现一个常见问题:
初期文档规划得挺好,但每次迭代更新后,文档和记忆都疏于维护。代码可能已经迭代了7、8轮,新功能上了无数个,但文档还是最初1.0版本的初始状态。
更严重的是:过期的记忆比没有记忆更糟糕。
没有记忆时,AI至少知道自己不知道,会主动问你。但如果它读到了一条过期的信息,它会以为那是对的,然后基于错误的前提做事。
OpenClaw越用越笨,往往就是因为记忆系统过于臃肿、文档已经"脑腐"了。
AutoDream的问题
Claude Code有一个功能叫AutoDream,能自动整理记忆。但它只动记忆,不管项目文档。
实际上,一个项目里的知识分三层:
| 层级 | 内容 | 受众 |
|---|---|---|
| 第一层 | Agent记忆系统 | Agent自己 |
| 第二层 | CLAUDE.md | 给AI自己看的约束和约定 |
| 第三层 | docs/目录和README | 给其他人/其他Agent看的文档 |
AutoDream只管了第一层,所以作用有限。
洁癖.Skill的五步流程
- 强制盘点:把项目里所有md文件全列出来,逐个读取,一个不漏
- 识别变更:用变更影响矩阵识别需要改什么,检查是否涉及跨项目依赖
- 按序修改:先改docs/ → 再改CLAUDE.md → 最后整理记忆
- 自检清单:确认新增的环境变量是否在各文档中出现、有无相对时间遗留等
- 变更摘要:输出一份清晰的变更记录
核心理念
合并优于追加,删除优于保留。
这跟大多数人的直觉相反——很多人觉得信息多总比少好,万一以后用得上呢?
但在AI协作场景里,信息准才是优势,一条过期的记忆比没有记忆更糟糕。
怎么使用
bash
# 运行洁癖.Skill
/neat
# 或者直接说中文
"审查一下"
"整理一下"最佳实践:所有任务收尾时必定运行/neat,相当于游戏存档。下次打开新会话,Agent依然精准高效。
项目地址
https://github.com/KKKKhazix/khazix-skills
写在最后
AI时代,断舍离依然有用:
过期的就删,重复的就合,模糊的就改。 让你的知识库,永远只保留此刻最准确的真相。
这大概是AI时代,比学会写Prompt更重要的一件小事。
