关于 tidy
tidy 是一项面向编码 Agent 的代码库精简技能,通过合并重复规则、清理废弃内容和设置文件大小钩子,减少 Agent 需要处理的噪声。每项改动先列出并征求用户确认。
主要功能
- 01合并重复业务规则
- 02删除未引用代码与过时文档
- 03设置提交前文件大小钩子
- 04精简 AGENTS.md 并整理工具
- 05按模板汇报清理结果
适用场景
- 01清理重复定义的业务规则
- 02移除确认无引用的死代码
- 03防止提交过大的源文件
- 04精简 Agent 项目指引
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ nagi-studio/ skills --skill tidy安装后在 Claude Code 中输入/tidy确认已加载。
附带文件agents/openai.yaml
详细介绍
来自项目 READMEAgent 变笨,多半是它每次读到的东西太多、太旧、太乱。这一次只做减法:合并、删除、拦住,不加新功能。
每一步先把要改的列给用户看,用户点头再动手。删掉的东西 git 里都还在,确认没人引用就可以删。
1. 同一条规矩只放一处
找出业务规则(算不算迟到、价格怎么算、谁能看什么)分别写在了哪几处。同一条规则出现在两处以上,就收到一个地方,其他地方改成调用它。代码长得像、管的却是不同的事,就各留各的。
做完的标准:每条业务规则只剩一个出处,测试照样通过。
2. 清废料
- 死代码:没有任何地方引用的文件、函数、导出,搜索确认后删掉。
- 注释:复述代码的删掉,讲「为什么这么做」的留下;和代码对不上的,照代码改过来。
- 过时的文档:已经做完或作废的草稿、计划、旧版说明,删掉。
3. 装文件大小钩子
用 Git 的提交前钩子:提交的文件超过 5,000 token(字节数 ÷ 4,约 20 KB)就拒绝提交,报错写明这个文件多大,请按功能拆成几个文件。lockfile、自动生成的代码、构建产物这类 agent 不会去读的文件,跳过不查。项目已经在用 husky、lefthook、pre-commit 这类工具的,加在它里面。
装好后拿一个超标的文件试:提交必须被拦下,拆完再提交必须通过。已经超标的文件列出来交给用户,这一步不顺手去拆。
再在 AGENTS.md 里写两行:提交被钩子拒了,照报错拆文件再提交;写新函数、新规则前,先搜项目里有没有现成的。
4. AGENTS.md 和工具瘦身
- AGENTS.md 压到 100 行左右:留下项目是做什么的、这个项目特有的坑、指向
docs/的路标。看一眼目录、package.json或--help就知道的删掉;长篇细节挪进docs/,在 AGENTS.md 里用一行指过去。 - 工具:列出全局装着、但这个项目用不上的 MCP、skill 和插件,建议用户改成只在需要的项目里开。全局配置交给用户自己改。
- 老犯的错:同一个错 agent 犯了两次以上,加一条 lint 规则或测试拦住,不往 AGENTS.md 里写提醒。
- 记忆插件:写代码时建议用户关掉,最新的代码和 git 记录就是记忆。
5. 交差
规矩收拢:<规则> → <路径>(原来 N 处)
删掉:N 个文件,N 行
钩子:<装在哪>;超标文件被拦下、拆完通过
AGENTS.md:N 行 → N 行
建议关掉的工具:…;没有就写「无」
还超标、没拆的文件:…;没有就写「无」
最后告诉用户以后的三个习惯:读代码、搜资料交给 sub-agent,只带回结论;聊长了就 /compact;换任务就清空,开一个新对话。
评论
支持 Markdown