针对老项目生成 AGENTS.md,核心思路是:先用工具自动提取可确定的硬信息(命令、技术栈),再靠人工补充架构判断和项目约定。
不要试图一次性写全。 AGENTS.md 是活的文档,最有效的用法是:AI 每犯一次同一个错误,就把对应的规则写进去。接手老项目尤其如此——你不可能一开始就知道所有约定,但每次纠正 AI 之后固化一条,文件会自然长成适合这个项目的样子。
控制长度。 建议在 200 行以内。太长会导致真正重要的规则被“淹没”,模型对冗长指令的遵循度会下降。
先跑起来再完善。 第一版只需要覆盖“怎么跑、怎么测、哪些地方不能碰”三件事就足够有用。架构层面的深度约定,等遇到具体问题再补充。
晒图笔记大赛
