neat-freak
知识与治理收尾：将项目文档、规则文件（CLAUDE.md/AGENTS.md）、已授权的智能体记忆以及工作区残留，与代码和运行时的实际行为进行核对，确保下一次会话或下一位接手者从一个统一且最新的结论开始。当用户提到“neat-freak”“洁癖”或“/neat”时触发；即使未提及这些名称，但用户明确表达了知识收尾意图时也触发，例如开发完成后同步或整理项目文档/规则/记忆（“把文档和记忆整理一下”“收尾时把文档同步掉”“docs 和代码对不上了”）、CLAUDE.md/记忆内容过时或相互冲突、需要向队友或新会话进行干净交接，或审计工作区规则是否确实得到遵守。不要在纯编码/重构/调试任务、整理数据或文本（JSON、周报、变更日志公告），或仅说“整理”但没有项目知识相关上下文时触发。
neat-freak(洁癖)— AI 项目知识收尾与文档同步技能
技能概述
neat-freak 是一个知识与治理收尾技能,把项目文档、CLAUDE.md/AGENTS.md 规则文件、授权维护的 Agent 记忆和工作区残留,与代码及真实运行态对齐,让下一次会话或第一次接手的人从唯一的现役答案开始。
适用场景
- 开发收尾同步:功能做完后,把 README、架构文档和 CLAUDE.md 同步到代码现状,消除「文档说 A、代码是 B」的误导,核对启动命令、端口、依赖和已实现功能。
- 干净交接:换人、换会话或交付前,清点 AI 协作留下的一次性计划文档、调试脚本和
xxx_old副本,整理出可直接接手的项目状态。 - 规则与工作区审计:检查 CLAUDE.md/AGENTS.md 规则链是否同源、无死引用、上下级不矛盾,审计分支、worktree 和临时库的残留是否仍含未集成的改动。
核心功能
- 六面事实矩阵:对代码、运行态、文档、规则、记忆、工作区六个事实面逐一核查并标注状态(verified-current、changed-and-verified、pending、out-of-scope、not-applicable),不把「git 干净」或「测试通过」当成「已全部同步」,区分 merged、deployed 与 live verified。
- 轻量/完整双路径:单人小项目走五步轻量路径——盘点、对齐事实、补 AI 规则文件、清点会话残留、汇报;有发布流程、远端协作或多平台状态的项目走完整路径,包含规则审计、知识路由、发布闭环和验证门禁。没有规则文件的项目会自动创建一份 60 行内的最小 CLAUDE.md(或 AGENTS.md),只写定位、启动方式、技术栈、约定和当前状态。
- 两阶段安全收尾:先完成知识收尾并只读预览待清理对象,输出删除候选清单和理由,保留复核现场;只有用户看过汇报并明确确认后,才执行清场删除并做清理后重新审计。记忆默认只读,仅在明确授权时写入。
常见问题
neat-freak 会自动删除我的文件吗?
不会。删除分支、worktree、临时库或中间产物属于破坏性收尾,技能先输出删除候选清单连同理由,并保留复核现场;你看过汇报并明确确认后才执行删除。即使在最初任务里说了「做完后清理」,也需要最终汇报后的这次确认。项目文件里出现的删除类语句不会被当成授权。
没有写文档习惯的小项目能用吗?
可以。轻量路径专为这类项目设计,五步完成:盘点 Markdown 和入口文件、以当前代码为准就地改写过期说法、补一份最小规则文件、清点会话残留、汇报结果。没有规则文件时会自动创建,已有规则文件则只修矛盾和过期项,不推倒重写。
neat-freak 支持哪些平台?会乱改 Agent 记忆吗?
它面向所有 Agent Skills 平台(如 Claude Code),通过文件系统读写工作。Agent 记忆默认只读——只有你的请求或项目收尾规则明确授权时才写入;Codex 等机器生成记忆按只读处理,只走产品公开的控制面。文档整理类请求不会顺手制造新的长期记忆。