（问题） 随着面向智能工具的协作方式兴起，“AGENTS.md”等指令文件在开发团队中快速普及。一些从业者把它当作“写给工具看的说明书”，试图用一个文件覆盖项目约束、编码规范、业务知识、操作流程甚至基础概念。随之而来的问题也逐渐显现：文档越写越长，关键信息越难被准确提取；上下文负担变重，生成结果波动增大；团队对“该写什么、写到什么程度”缺少共识，协作成本随之上升。
这场关于技术文档的讨论，折射出智能化时代工具使用的新课题。技术边界不断拓展之时，回到问题本身、遵循工程规律，往往比一味加码更有效。正如一位资深工程师所言：“最好的工具使用手册——不在于篇幅长短——而在于能否让机器和人都各得其所。”这值得行业继续思考。