Neat Freak

会话结束时的知识清理与文档同步工具

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:Neat Freak。
它的用途是:会话结束时的知识清理与文档同步工具
完整的 Skill 内容见:https://321skill.com/skills/neat-freak/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'结束当前会话,请运行Neat Freak清理项目知识',它会自动扫描项目目录下的CLAUDE.md、README.md和docs/文件夹,与代码对比,修复不一致的文档,并清理agent记忆中过时的上下文,最后生成审计报告。

介绍

在项目开发过程中,文档、代码与AI助手的记忆容易脱节,导致知识碎片化、信息过时。Neat Freak 专门解决会话结束时的知识清理问题,以OCD级别的严谨性,扫描项目文档(CLAUDE.md、README.md、docs/)和agent记忆,与最新代码进行比对,确保所有知识源保持一致,避免“我说过但没更新”的混乱。

使用方式非常简单:在每次会话结束或需要同步时,执行该Skill即可。它会自动读取项目目录下的核心文档和AI记忆,逐条对比代码中的实际实现,标记不一致之处,并按照预设规则自动修复或提示更新。整个过程无需手动干预,但会生成审计报告供你复核。

适合所有需要长期维护项目文档和AI上下文的开发者,尤其是全栈开发、文档工程师和项目经理。无论是个人项目还是团队协作,都能有效减少因信息不同步而导致的返工和沟通成本。

建议在每次提交代码前或会话结束时运行一次,养成习惯。注意:该工具会强制覆盖不一致内容,如果你希望保留历史版本,请提前做好版本控制(如Git提交)。同时,对于高度依赖人工审核的合规文档,建议先在小范围试用。

核心特点

与同类文档同步工具不同,Neat Freak 不仅对比文档和代码,还会审计 AI agent 的记忆,将所有知识源(文档、代码、记忆)进行三方一致性校验,以OCD级别的规则自动修复,杜绝任何残留的知识差异。

注意事项

不适合需要保留历史版本或手动确认变更的场景,因为工具会强制覆盖不一致内容,且对非标准文档格式(如纯文本笔记)的支持有限。

常见问题

运行后我的文档会被删除吗?

不会删除,只会修改不一致的内容,并在审计报告中列出所有变更。如担心误改,建议先备份或使用Git版本控制。

哪些文档格式会被扫描?

默认支持Markdown文件(如CLAUDE.md、README.md)以及docs/目录下的所有.md文件。其他格式需要通过配置扩展。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/neat-freak/raw/index.md 读取 Neat Freak 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。