AI编程代理老是返工这份AGENTS.md完整指南让你一次讲清规矩【免费下载链接】agents.mdAGENTS.md — a simple, open format for guiding coding agents项目地址: https://gitcode.com/GitHub_Trending/ag/agents.md想让AI编程代理一次就做对却每次都得口头重复项目规矩AGENTS.md是一个开放的Markdown格式把构建、测试、代码风格等指令集中写进一个文件代理开工前自动读取。用Cursor、Copilot、Devin等工具的开发者写一份就能在所有代理里通用。 别再每次开会话都交代同一套规矩让AI修个bug它顺手把生产构建跑了一遍开发服务器的热更新直接没了换个代理它又不记得你们团队的PR标题格式。你只能每次开头从头念一遍规矩新同事接手时再念一遍。AGENTS.md要解决的正是这件事把这些口头交代固化成一个文件念一次所有代理都读得到。 AGENTS.md里该写哪5类信息把它理解成给AI代理留的工位交接便签人来看README代理来看这个文件不用问就能开工。项目概述一两句说清项目做什么、用了什么技术栈构建与测试命令启动、测试、lint的准确命令一行一条代理会照着真的去执行代码风格文件命名、语言偏好、样式文件放哪里测试要求提交前必须跑绿哪些检查团队约定PR标题格式、安全注意事项、部署步骤仓库自带的AGENTS.md就是活例子它只写了迭代时用dev服务器、别在代理会话里跑生产构建这类具体规矩没一句废话。 三步建好根目录的AGENTS.md在项目根目录建一个AGENTS.md文件。纯Markdown没有必填字段懒得动笔可以直接让代理先给你起草一版。把每次口头交代的规则写进去。命令务必写准确别写跑一下测试写pnpm test这种代理能直接执行的。大项目给每个子包再放一个AGENTS.md。代理读离被编辑文件最近的那个最近的优先根目录的只放全局规则。 写完AGENTS.md必查的3个误区误区一次写死从此不管。正确做法把它当活文档命令或规则一变就同步更新别让代理照着过时指令干活。误区大段散文式描述。正确做法短句加具体命令一条只说一件事越含糊代理越容易自行脑补。误区以为文件指令覆盖一切。正确做法你在会话里的聊天指令永远优先多个AGENTS.md冲突时离文件最近的生效——所以全局规矩放根文件子包里只写差异。写完这份文件后最直接的收益是同一套规矩只讲一次换工具、换会话、换人都不用重念代理提交前还会按你写的命令自己把测试跑绿。目前已有超过6万个开源项目在用它支持它的代理名单每天都在变长README里也能看到它在整个开源社区的定位。【免费下载链接】agents.mdAGENTS.md — a simple, open format for guiding coding agents项目地址: https://gitcode.com/GitHub_Trending/ag/agents.md创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考