
1 / 1
【概述】 AGENTS.md 是一种简单、开放的 Markdown 格式,用于向 AI 编码代理提供项目上下文和指令,使其能够理解并参与代码库的工作。它相当于一份面向代理而非人类读者的 README,为代理提供了一个专门且可预测的位置来获取构建步骤、测试方法和代码约定等信息。 该格式已被超过 6 万个开源项目采用,旨在解决 AI 编码代理在缺乏项目上下文时难以有效工作的问题。通过将项目相关的指令集中在一个标准化的文件中,开发者可以更高效地引导代理完成开发任务,而无需依赖专有的配置文件。 AGENTS.md 适用于构建或使用 AI 编码代理的开发者、开源项目维护者以及拥有大型 monorepo 的团队。它免费使用,采用开放格式,任何人都可以将其集成到自己的项目中。 【核心功能】 • 代理指令文件格式: 在仓库中提供一个专门且可预测的位置,向编码代理传达构建步骤、测试和约定等上下文与指令。 • 嵌套的包级指令: 允许大型 monorepo 在每个包内放置另一个 AGENTS.md,代理会读取目录树中最近的文件。 • 自动化测试执行指导: 代理会尝试运行 AGENTS.md 中列出的相关程序化检查,并在完成任务前修复失败。 • 通过符号链接迁移: 支持通过符号链接将现有文档(如 AGENT.md)重命名为 AGENTS.md,以保持向后兼容性。 【适用场景】 1. 为 AI 编码代理提供项目上下文和指令 2. 为代理记录构建和测试命令 3. 为代理指定代码风格指南 4. 提供提交信息和拉取请求指南 5. 在 monorepo 中为每个子项目提供定制指令 【优缺点】 优点: - 对于使用 AI 编码代理的开发者,AGENTS.md 提供了一种标准化且开放的方式来传递项目上下文,避免了为不同代理工具维护多套配置的麻烦;其简单的 Markdown 格式也易于阅读和编写。 缺点: - 嵌套的包级指令遵循“最近文件优先”原则,且用户聊天中的明确提示会覆盖文件内容,因此代理可能不会完全按照 AGENTS.md 执行。 - 自动化测试执行指导仅在文件中列出测试命令时才生效,否则代理不会主动运行测试。 【常见问题】 Q: AGENTS.md 和 README 有什么区别? A: AGENTS.md 是专门为 AI 编码代理设计的,内容更侧重于构建步骤、测试命令和代码约定等代理需要执行的指令,而 README 主要面向人类读者,介绍项目概况和使用方法。 Q: 在 monorepo 中,代理如何决定使用哪个 AGENTS.md? A: 代理会读取目录树中距离当前编辑文件最近的 AGENTS.md,因此每个包可以有自己的指令文件,实现细粒度控制。 Q: 如果项目中已有 AGENT.md,如何迁移到 AGENTS.md? A: 可以通过创建符号链接将 AGENT.md 指向 AGENTS.md,这样既保留了旧文件的兼容性,又统一使用了新格式。
free
以下为美区参考价,其他地区的价格可能不同,请以官网实际价格为准。
WPS AI 是集成在 WPS Office 中的 AI 助手,面向日常办公与学习写作场景。它把文档写作、PPT 生成、长文阅读和表格处理这些常见任务,直接放进用户已经在用的办公软件里,减少在多个工具之间来回切换的麻烦。 在文档侧,WPS…
Baidu Comate 是百度基于文心大模型研发的 AI 编程辅助工具,面向软件开发全流程提供智能化支持。它能够自动生成代码、单元测试和注释,并通过智能问答帮助开发者快速理解项目架构与模块关系,从而提升编码效率。…
UniConverter 是一款 AI 媒体转换与增强工具,可对视频、音频和图片进行转换、压缩、编辑与画质提升。对于因压缩过度、噪点过多或分辨率偏低而显得模糊的素材,它提供 AI 视频增强与视频放大能力,帮助还原画面细节。…
添加时间
2026/10/22
浏览
662
点击
2
共 6 个可替代 AGENTS.md 的相似工具