Skill/开发测试/Neat Freak
开发测试 · 卡兹克 21.8k 仓库 Star

Neat Freak

让下次接手看到当前事实

项目知识收尾是整理文档与规则的 Skill。它把当前代码、运行状态、文档和获准维护的记录放在一起核对,找出过期说法、矛盾约束和会话残留。小项目可走简化流程,复杂项目分别标记各部分状态,帮助下一位接手者找到现行依据。

你需要准备:当前项目、这次改动、现有文档和项目规则

一桉AI 整理 · 2026.10.31 更新 · 查看 GitHub 来源

粘贴到 Codex,它会先检查安装条件,再引导你使用。

Neat Freak 能帮你做什么?

  • 核对现行项目事实

    从代码、配置、测试和可访问页面核对项目真正做到了什么,不只依据旧文档或干净的 Git 状态。

  • 对齐文档与规则

    在获准范围更新 README、使用说明和 Agent 规则,修复失效引用与过时约定,保留权威信息入口。

  • 整理交接与残留

    列明已核对部分、未验证事项和可清理候选,先保留复核现场,再按授权安排后续处理。

什么时候适合用?

下面是用法示例,可换成你的材料和目标。

  • 数据库方案已经变更

    例如代码改用新数据库后,检查部署、开发说明和 Agent 规则中是否还残留旧连接方式。

  • 阶段工作准备移交

    例如核对功能状态、文档入口和临时脚本,给新同事一份当前可依赖的信息与待处理清单。

怎么开始使用?

从材料到结果流程示意,非实测结果

项目改动、文档与规则

准备这些材料项目文档与规则收尾

当前项目、这次改动、现有文档和项目规则

项目知识收尾流程

  1. 01

    盘点代码文档和规则

  2. 02

    核对并修正过期信息

  3. 03

    汇报变更与交接事项

准备什么,会得到什么?

准备的材料
当前项目、这次改动、现有文档和项目规则
交付的结果
  • 与实际项目核对过的文档、规则更新及变更说明。
  • 尚未验证的信息、残留候选和下一步交接事项清单。

使用前要知道

需要项目访问和完整参考、脚本;Bash 脚本不可用时应做等价盘点。仅处理获准范围,Codex 机器生成记忆不能当普通文件手改,删除候选需先列明。

常见问题

它可以帮我清理电脑缓存吗?

这项主要处理项目文档、规则和知识收尾。磁盘占用扫描与应用缓存清理属于其他工具,不能因为名称是“洁癖”就扩大操作范围。

能直接改 Codex 自动生成的记忆吗?

需要按宿主允许的入口处理。机器生成记录通常只读,应优先更新项目文档或提交获准的纠正信息,避免制造另一份冲突记录。

GitHub 与官方参考

依据项目说明与参考文档整理。页面中的任务与流程示例用于说明用法。

  • neat-freak · SKILL.md ↗2026-10-31 核对
  • Khazix Skills · 项目说明 ↗2026-10-31 核对
来源与使用条件
原始项目
KKKKhazix/khazix-skills ↗
作者/维护者
数字生命卡兹克
介绍出处
查看作者介绍 ↗
Skill 名称
neat-freak
Skill 目录
neat-freak
仓库 Star
21,767 · 2026-10-31 核对,仅代表仓库关注度。
许可说明
MIT
使用条件
完整保留 neat-freak 的 scripts、references 与配套资源。需要项目文件访问,Git 和 rg 用于核对;audit-inventory.sh 需要 Bash,Windows 可用 Git Bash,缺少 Bash 时按源文执行等价盘点。需要验证运行态时,还须有对应服务或页面访问能力。
注意事项
作者讲解有 AIHOT 数据库迁移后文档过期的具体案例。此项是项目知识收尾,不是磁盘清理。仅在获准范围更新项目文档和规则,Codex 机器生成记忆不得当作普通文件手改;删除候选先列清单。来源与条件已核,本站未运行实测。
查看安装与使用提示词
请帮我准备并使用 Neat Freak Skill,完成下面的任务。请实际执行当前环境允许的安装与检查,不要只返回一份安装教程。

【来源与目标】
原始仓库:https://github.com/KKKKhazix/khazix-skills
所选目录:neat-freak
参考分支:main
原始目录 frontmatter name:neat-freak
安装后的目标调用名:neat-freak
来源页面:https://github.com/KKKKhazix/khazix-skills/tree/main/neat-freak
安装路线核对日期:2026-11-01
neat-freak:当前源 SKILL.md:https://github.com/KKKKhazix/khazix-skills/blob/main/neat-freak/SKILL.md
KKKKhazix/khazix-skills:当前安装说明:https://github.com/KKKKhazix/khazix-skills/blob/main/README.md
OpenAI:Build skills(Skill目录、发现和插件):https://learn.chatgpt.com/docs/build-skills

【先检查环境,再安装】
先识别操作系统、当前 shell、工作目录、同名 Skill 和已有工具;命令须适配实际平台并正确处理带空格的路径。默认安装到当前项目的 .agents/skills;如果没有可用项目目录,再使用用户目录的 .agents/skills。遵循当前 Codex 实际支持的位置;上游 CLI 或插件有专用目录时使用其正式方案。检查现有安装来源与完整性,能复用就复用,不重复注册相同来源、不覆盖用户修改。系统内置与所选第三方来源同名时保留系统版,明确区分来源和实际目录,不能只凭名称认定装过或选对了。
下文 ~/.agents/skills 是用户级路径示例;已选项目范围时,使用项目的 .agents/skills 并保持相同子目录层级。<SKILL_DIR>、<项目根目录> 等占位符须先换成核对过的真实路径再执行。依赖仓库的存放目录与 Codex 发现入口分别处理,不把缓存目录当作已注册入口。
这是完整目录安装路线。优先使用当前 Codex 自带的 $skill-installer,明确传入仓库 KKKKhazix/khazix-skills、目录 neat-freak、分支 main、安装名 neat-freak,并把 --dest 设为已解析的目标 .agents/skills 绝对路径。目录为“.”时表示仓库根目录,仍要传入安装名。不要猜测安装器在本机的固定路径。如果没有内置安装器,按下列项目说明从原仓库获取完整目录,保留全部配套文件。

所选 Skill 的具体安装步骤:
1. 先定位用户要使用的项目根目录,并检查项目与用户目录中是否已有同名 Skill;发现已有版本先比较来源和内容,不覆盖,也不删除系统或插件缓存。
2. 调用系统 skill-installer 的 scripts/install-skill-from-github.py,参数明确为 --repo KKKKhazix/khazix-skills --path neat-freak --ref main --name neat-freak --dest <项目根目录>/.agents/skills。--dest 是所有 Skill 的父目录,不是 SKILL.md 文件路径。
3. 安装整个所选目录,保留以下 resources 列出的脚本、参考资料和资产;检查相对路径引用,不只下载一份 SKILL.md。
4. 在该项目中查看 Skill 列表,并用 $neat-freak 显式选择;Codex 会自动检测目录变化,尚未出现时再开新聊天或重新加载。

必须保留的资源:
- neat-freak/SKILL.md
- neat-freak/references/(至少 agent-paths.md、verification.md、governance.md、sync-matrix.md)
- neat-freak/scripts/(含 audit-inventory.sh)与 evals/

已知依赖:完整保留 neat-freak 的 scripts、references 与配套资源。需要项目文件访问,Git 和 rg 用于核对;audit-inventory.sh 需要 Bash,Windows 可用 Git Bash,缺少 Bash 时按源文执行等价盘点。需要验证运行态时,还须有对应服务或页面访问能力。
原项目许可:MIT
特别条件:作者讲解有 AIHOT 数据库迁移后文档过期的具体案例。此项是项目知识收尾,不是磁盘清理。仅在获准范围更新项目文档和规则,Codex 机器生成记忆不得当作普通文件手改;删除候选先列清单。来源与条件已核,本站未运行实测。
需要账号、密钥或服务时先检查现有可用连接;让用户在官方授权或本地配置入口完成,不要求把密钥粘贴到聊天。缺少付费服务或不支持的客户端能力时,明确剩余条件与可完成的范围。

【安装后验收】
读取实际安装位置的 SKILL.md,核对真实 name,并检查它引用的脚本、模板、共享文件与工具是否存在。若上游已迁移路径或更名,先核对正式说明再调整;找不到则报告实际错误,不猜路径或宣称成功。
1. 核对 references/agent-paths.md、verification.md、governance.md、sync-matrix.md 与 scripts/audit-inventory.sh 存在。
2. 检查当前项目根目录、Git/rg 与 Bash 是否已有;只读列举目标规则/文档,不删除文件、不重写配置、不触碰用户全盘。
Codex 通常自动发现变更;只有未出现时才引导新建聊天或重载。若本轮尚未出现在可用列表,可在允许的范围内读取已安装的完整文件继续准备任务,同时说明自动识别尚待确认。插件依赖的工具未连接时,不能用读取文件代替连接成功。
分别报告“文件已安装”“Codex 已识别”“任务所需能力已就绪”的实际状态和证据;失败时给出卡住的步骤、错误与下一步,不反复执行相同的失败命令。

【接着引导我使用】
请使用实际可用的 $neat-freak;若实际名称发生变化,以刚核对的本地 name 为准。存在不同来源同名项时,明确选择所选来源与实际文件路径,避免调用成系统版或另一版本。对于必须由用户显式调用的 Skill,直接给我下一条可复制的调用语句。
- 明确这次只整理哪个项目、哪些规则/文档/已授权记忆,并先选择轻量盘点或完整整理模式。
- 先产出重复、过时和冲突清单,再在授权范围修改并核对链接与规则;Codex 自动生成的记忆只读,不把本项用成磁盘垃圾清理器。

我想完成的任务:
为当前项目做文档和规则收尾。核对本次改动、现有代码和实际可验证状态,找出 README、项目文档及 AGENTS.md 等规则中的过期或矛盾信息;在授权范围修正,并保留事实来源。平台生成记忆只按宿主允许的方式处理,未知机制默认只读;文件或分支删除只列候选,交付摘要后再按授权处理。

需要我提供的材料:
当前项目、这次改动、现有文档和项目规则

期望得到:
更新或建议更新的文档与规则清单、验证依据、待决事项和下一次接手说明。

先查看我在当前聊天中已经提供的目标与材料,只问缺少的关键内容;没有材料时,告诉我第一步提供什么,可给一个简短示例。条件满足后从一个小任务开始,检查输出,再说明怎样继续使用。示例仅用于演示,不充当我的真实数据;没有执行过的步骤、测试或交付物不要写成已经完成。需要发送、发布或修改外部账号内容时,先让我核对具体对象和内容。

相关 Skill

  • Systematic Debugging系统化排查问题
  • Test Driven Development测试驱动开发
  • React Best PracticesReact 性能优化

复制到 Codex

浏览器暂未允许直接复制。点击下方文字,按 Ctrl+C(Mac 按 ⌘C)复制,再粘贴到 Codex。

三步开始使用

  1. 找到想做的事,点击「复制提示词」。
  2. 打开 Codex,把提示词粘贴进去并发送。
  3. 按它的提示提供文件或材料,继续完成任务。

按需安装就好,不用一次装完。部分 Skill 需要软件、账号或付费服务,Codex 会先检查使用条件。