⚠️ 如果你平时只会用聊天型大模型,最近又老刷到 tech-leads-club / agent-skills 这类内容,说白了就是教你怎么给智能助手分层放规则,最容易踩的坑不是不会写规则,而是图省事把规则全塞根目录。全塞根目录,是在每次调用里交税[C002]。

代价不只是多写几行字,更麻烦的是上下文错配。比如你明明在前端目录改一个按钮,却还让助手一起背着后端、发布、安全那一大包规则,你更容易碰到“看着听话,结果还是答偏”的情况。第一次偷懒,后面常常每次都要补一轮解释。

我后来才补上这个判断:一条更新值不值得看,不看它列了多少功能,先看它会不会改掉你下一步的判断。OpenAI 文档写得很直白:AGENTS.md(给编程助手看的规则文件)会跟着当前工作位置走,从项目根一路读到当前目录,还建议把专项规则放得更近[C003]。

社区讨论也提到,子目录可以继续叠加这份规则文件,不用永远只靠根目录一张总纲[C004]。所以更省事的做法反而是:根目录只放全局共识,具体规则拆到更近的目录。仓库里任务差很多的人,值得立刻检查;只有两三个脚本、规则几乎不变的小项目,不一定要折腾。要是你身边也有人刚从聊天框转到这类工具,这条可以直接转给他。

🤔 你现在最想先避开的,是哪一个坑?