开源Agent文档维护工具，自动审查项目文档体系并迭代更新，支持Claude Code、Codex、OpenCode、OpenClaw四个平台
开源Agent文档维护工具，自动审查项目文档体系并迭代更新，支持Claude Code、Codex、OpenCode、OpenClaw四个平台
用Claude Code或Codex做项目的开发者，大概率都遇到过这个问题：代码迭代了七八轮，新功能上了无数个，但项目文档还停留在最初的1.0版本。Agent越用越笨，根源不是模型不行，而是上下文已经腐坏了。开源工具"Neat.Skill"（洁癖.Skill）专门解决这个痛点，每次完成任务后跑一遍 /neat，自动审查并更新整个项目的文档体系。
Agent的上下文分三层，每一层出了问题都会导致AI犯错：
典型的问题场景：你把数据库从SQLite换成了PostgreSQL，但忘了改CLAUDE.md。下次开发新功能时，Claude还在用SQLite语法。你以为是模型笨，其实是文档过期了。
一条过期的记忆，比没有记忆更糟糕。没有记忆时，AI至少知道自己不知道。但如果它读到了一条过期的信息，会以为那是对的，然后基于错误的前提做事。
每次运行 /neat 时，它会按顺序做五件事：
把项目里所有md文件全列出来，每一个都读一遍。防止遗漏关键文档。
不只看对话里有什么新事实，还要看新事实会波及哪些文档层级。还有一个关键检查：这次改动是不是跨项目的？如果改了项目A而项目B依赖它，项目B的docs也得跟着改。
先改docs/，再改CLAUDE.md，最后整理记忆。顺序很重要，因为改动本身会产生连锁影响。
检查新增的环境变量是否在runbook和CLAUDE.md都出现了，有没有相对时间遗留等问题。
告诉你这次改了什么、删了什么、合并了什么。
Neat.Skill的设计哲学只有一条：合并优于追加，删除优于保留。
在AI协作场景里，信息多不是优势，信息准才是。过期的就删，重复的就合，模糊的就改。让你的知识库永远只保留此刻最准确的真相。
开源地址： github.com/KKKKhazix/khazix-skills
支持平台：
使用方式：
最简单的方式是在完成任务后输入 /neat，或者用自然语言说"审查一下"、"整理一下"。
建议的使用节奏：
/neat/neat 存档，然后新开窗口继续把 /neat 当作游戏的"存档机制"来用：
开始新对话 -> 完成任务 -> /neat 存档 -> 关闭对话 -> 新开对话继续这样做的好处是：对话可以随时关，但文档永远在。新会话不需要任何预热，Agent就能基于准确的文档上下文直接开始工作。
