neat-freak ｜ 项目知识收尾同步

适合什么任务

项目阶段收尾时对齐代码、README、规则与文档，合并重复、修正过期、清理废弃；只在明确授权范围内改动。

来源与核验范围

来源说明

2026-10-04已完整核对原Skill与本页步骤直接相关的说明；测试范围逐项列明，上游后续可能更新。

核验时间

2026-10-04

许可

原项目页面声明 MIT；数据源、平台内容或第三方服务另有规则，安装与使用前核对。

体验状态

已附原作者盘点脚本与合成项目对齐记录；未验证宿主或生产。

本站使用说明

首个任务

HR与AI一起做了表格工具或项目资料，实际输入已经换字段，README还写旧字段；任务结束后接手者不知道哪个版本有效。它适合这类收尾对齐，不是“自动删除杂乱文件”的按钮。

运行环境

原文版本3.0.0，面向可读项目文件的Agent Skills宿主。原作者盘点脚本需要Bash；本次在macOS隔离合成项目实际运行了该脚本，再由本次AI依据原文做文档对齐。未安装同名宿主Skill。

前提与依赖

• 你明确授权的单个项目目录、当前规则和主要说明文档
• 若项目有程序，提供运行入口、合成输入和实际结果
• Bash用于原作者只读盘点脚本；Git和rg有助于查差异，非全部必需
• 有部署时另需真实上线证据；没有部署就写未部署

费用

没有验证独立收费服务；AI工作台及模型费用按所用服务计费。它不会替你承担发布、客服或长期维护。

资料去向

AI会读取授权目录的文档及相关文件；云端宿主可能把内容传给模型。原盘点脚本还枚举平台目录和上级规则文件尺寸，因此真实项目运行前先审查脚本和输出用途；不要把内部路径、凭据、员工资料复制到公开报告。

第一次，按这几步做

1. 先给AI讲清只核对哪个项目、可改哪些文件。本页示例只允许修改隔离README，不写个人规则或记忆、不删除、不发布。
2. 完整读本项目README、规则、主要入口及受影响文档。先核对原包和练习项目路径，再运行 bash "<原包目录>/scripts/audit-inventory.sh" "<练习项目路径>"；请把两处占位符替换成实际路径，项目路径是该脚本必需的唯一参数。没有Bash时可由AI做同范围清单，但应标明未运行原脚本。
3. 运行合成例子，核对实际字段和结果，再与README逐条对照。实际无法运行的项写“未运行”，不能凭旧说明认定可用。
4. 让AI只修有证据且已授权的文档矛盾。旧副本先列清单与理由；有唯一内容时先保留，不按名字直接删除。
5. 交接说明必须讲清现在能做什么、怎么启动、还有哪些未验证、是否真的上线。本次例子应写“本机合成程序已运行、未部署”。

本轮核验笔记

实际检查

原作者盘点脚本与合成项目对齐通过

检查日期

2026-10-04 17:16（北京时间）

结果与范围

2026-10-04原作者脚本在隔离合成项目退出0；实际程序输出3条记录/2条完成。依据完整原文由本次AI修正README两处矛盾，原输入保留；未安装宿主Skill，未验证真实项目发布或全工作区收尾。

原作者只读脚本实际运行＋本次AI合成项目文档对齐

完成后，核对这些点

• 对照真实入口、字段和运行输出，不以文件名、测试通过或Git干净推导已上线。
• 打开修改后的说明，确认接手者能找到唯一入口和未验证项。
• 清理候选是否有唯一内容，恢复方式和删除授权是否明确。

遇到问题，先这样查

• 文档与程序无法裁决：列出两边出处，先保持待核实，不猜一个版本写为现役。
• 脚本不存在或Bash不可用：做同范围文件清单，但不能把人工盘点写成脚本通过。
• 没有运行或上线权限：继续完成本地文档与交接，部署状态如实保留，不擅自停服、迁移或修改调度。

当前仍未覆盖

• 验证了原作者只读脚本和一个合成项目的文档对齐，未验证任何生产或跨平台集成。
• 原作者参考表中的平台路径可能变化；本文没有推荐照抄旧Codex项目技能路径，应按你的当前工作台规则核对。
• 未清理旧文件，未修改真实规则、记忆、知识库或服务。

使用前