用 Cursor 或 Windsurf 写代码时，常遇到 AI 搞不清项目结构，或者还在用过时的构建命令，导致生成的代码无法运行。
这是因为 `http://README.md` 本质上是写给人看的，充满了人类能懂但机器难理解的上下文，缺乏精确的执行指令。
最近在 GitHub 上看到 http://AGENTS.md 这个开源项目，旨在为 AI 编程智能体提供一份专属的“操作手册”。
将面向人类的快速入门指南，与面向机器的构建步骤、测试指令和代码规范彻底分离，互不干扰。
核心逻辑非常清晰：在项目根目录创建一个 Markdown 文件，专门告诉 AI 如何构建、如何测试以及遵循什么样的代码风格。
广泛兼容目前主流的 AI 编程工具，包括 VS Code、Cursor、Windsurf、Aider 以及 GitHub Copilot 等。
GitHub：http://github.com/agentsmd/agents.md
使用成本极低，只需新建一个 `http://AGENTS.md` 文件，填入项目概览、测试命令和安全注意事项即可。
支持在大型项目中嵌套使用，比如在子目录放置不同的配置文件，AI 会自动读取最近的指令，非常灵活。
随着 AI 辅助编程成为主流，为项目配置一份“机器文档”或将成为开发者的基本技能，建议大家尽早尝试。
@aigc1024