neat-freak（洁癖）— 知识与治理收尾
干完活跑一下，自动对齐项目文档、规则文件与Agent记忆，审计规则是否真正被执行。
该技能明确要求仅在用户授权和现有规则允许时写入，破坏性操作需先汇报并等待确认，删除仅作为候选列表，不自动执行。它尊重用户确认和权限边界。但权限细节依赖外部代理和平台规则，且未验证该技能的落实，故扣分至18。
技能描述了清晰的执行流程，包括轻量路径和完整路径，并有自检清单。依赖Git和rg等工具，但指示了替代方案。提供了eval测试但未执行验证。所有代码路径未实际测试，故上限设为10。
技能的使用场景和触发条件清晰，明确列出正反例，适合中文用户。主要依赖本地文件，无跨境服务。但可能未能覆盖所有环境差异，且未实际测试，故扣至12。
文档结构良好，有版本号、分类、参考文件链接，包含eval和LICENSE。但关于维护责任和更新路径的信息有限，版本历史未展示，可能缺乏清晰的变更日志。故扣至11。
技能旨在实现文档、规则和记忆的一致性收尾，其方法和自检清单似乎合理。但静态审查无法确认实际完成任务的效率，且eval未执行，故按静态审查上限设为7。
提供了eval和自检清单，但未执行测试，且没有第三方执行证据。因此按照静态审查上限设为5。
- 该技能涉及文件写入和删除，必须在用户明确授权下执行，并确保删除前有确认流程。
- 依赖外部工具（如git, rg）和平台规则，确保这些可用且在目标环境中正确配置。
- 静态审查未执行，实际效果需通过运行验证。
这个 Skill 能做什么，适合哪些场景？
neat-freak（洁癖）是一个知识治理类 Skill，专门做开发后的「知识收尾」：把代码和运行态的真实情况，与 README/docs、CLAUDE.md/AGENTS.md 规则文件、Agent 记忆和工作区残留对齐，确保下一次会话或接手的人拿到唯一准确的现役答案。它支持轻量路径（个人小项目）和完整路径（有发布流程和远程协作的项目），默认只读、不擅自删除，所有删除操作都需用户确认。触发方式包括直接输入「/neat」「洁癖」或表达整理文档/收尾的意图。
读取项目根目录和所有 Markdown 文件（跳过依赖与构建目录），运行 scripts/audit-inventory.sh 做只读盘点（无 Bash 时手动等价检查）。对照代码与运行态核对文档、规则文件中的命令、端口、依赖、功能描述，修正过期或错误信息。对 CLAUDE.md/AGENTS.md 等规则文件进行审计，检查引用路径是否真实、上下级规则是否矛盾、必备文件是否缺失。列出会话残留文件（PLAN.md、调试脚本、xxx_old 副本等）作为删除候选，等待用户确认。最后产出一份分阶段汇报，标明每个事实面的状态（verified-current、changed-and-verified、pending 等）和遗留矛盾。
- 个人开发者：刚完成一个功能迭代，代码和 README 对不上，跑 /neat 让文档对齐代码现状。
- 团队协作：要交接给同事，先跑一次 neat-freak 确保 CLAUDE.md 接口列表和实际路由一致，避免新人被误导。
- 项目收尾：准备发布新版本，用完整路径核对本地、远端和生产状态，清理已合并分支和临时文件。
- 审计规则执行：怀疑项目里规则文件没有被遵守，用它检查必备文件是否缺失、命令是否存在。
- 接手陌生项目：新人接手时，用轻量路径快速生成最小 AGENTS.md/CLAUDE.md，帮自己恢复上下文。
这个 Skill 有哪些优点和局限？
- 自动对齐文档、规则、记忆与代码现状，减少信息脑腐。
- 轻量和完整两套路径，小项目和复杂项目都适用。
- 默认只读，删除操作必须用户确认，安全性高。
- 内置最终自检清单，确保每个事实面都有明确状态。
- 依赖 shell 和 rg，无 Bash 环境会手动替代，效率降低。
- 机器生成的记忆（如 Codex）无法直接修改，需走官方控制面。
- 尚未有公开发布的测试套件，实际效果依赖使用场景。
- 触发条件较严格，纯代码任务或整理数据/周报不会触发。
如何安装这个 Skill？
在支持 Agent Skills 的工具（如 Claude Code、Codex）中，直接说：「帮我安装这个 skill：https://github.com/KKKKhazix/khazix-skills/tree/main/neat-freak」。Agent 会自动 clone 到对应目录。若工具不支持 Skill，可下载 neat-freak/SKILL.md 全文作为项目规则文件，或直接贴进对话使用。
如何使用这个 Skill？
安装后，在会话中触发：输入「/neat」或「洁癖」，或表达“把文档和记忆整理一下”“sync docs”等收尾意图。它会自动运行，完成后输出一份汇报：改动/新建的文件、待确认删除清单、遗留矛盾。注意：对于机器生成的记忆（如 Codex），默认只读；删除操作需在汇报后明确确认才会执行。