agents-md
一个文件，让所有AI编程助手都像资深工程师一样工作。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：agents-md。 它的用途是：一个文件，让所有AI编程助手都像资深工程师一样工作。 完整的 Skill 内容见：https://321skill.com/skills/agents-md-ferroxlabs/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“安装AGENTS.md到这个项目。”，它会自动下载文件、创建必要的符号链接，并根据现有代码库填充项目技术栈和构建命令。之后，当你要求AI修改代码时，它会自动遵循AGENTS.md中的规则，例如：在修改前先验证代码能否运行，用最简洁的diff解决问题，并在不确定时主动向你提问。
介绍
AGENTS.md 是一个旨在标准化和提升AI编程助手行为的配置文件。它解决了开发者在日常工作中，不同AI助手（如Claude Code、Cursor、Gemini CLI等）行为不一致、代码质量参差、经常忽略项目特定规则或上下文的问题。通过一个统一的、精心设计的指令文件，它能引导AI助手遵循最佳实践，产出更可靠、更简洁、更符合项目规范的代码。
使用方式极其简单，只需将AGENTS.md文件放置于项目根目录即可。主流AI编程助手会自动读取并遵循其中的指令。对于Claude Code和Gemini CLI，可能需要创建对应的符号链接（CLAUDE.md, GEMINI.md）。文件本身包含可编辑的“项目上下文”和“项目经验教训”部分，其余核心规则保持不变，确保了指令的简洁和高效加载。
它非常适合所有使用AI编程助手（如Claude Code、Cursor、Aider、Copilot等）的软件开发者、工程师和团队。无论是个人项目还是团队协作，AGENTS.md都能帮助统一AI的行为标准，减少因AI误解或随意发挥带来的代码混乱和返工。
与同类工具（如项目特定的.prompt文件或自定义助手指令）相比，AGENTS.md的核心优势在于其普适性、精炼性和设计哲学。它并非一个臃肿的指令清单，而是一个经过实战检验、高度凝练（约200行）的“操作系统”，通过“项目经验教训”部分实现自我迭代，让AI助手在项目中持续学习和改进。
核心特点
核心区别在于其“一个文件，所有代理”的普适性设计，以及通过“项目经验教训”部分实现的持续学习和行为固化能力，而非静态的、一次性的指令集。
注意事项
不适合完全依赖AI生成全新、无现有代码库参考的“绿地项目”的初始阶段，因为其“项目上下文”部分需要基于现有代码进行填充。
常见问题
AGENTS.md 和 CLAUDE.md 有什么区别？
AGENTS.md是通用核心文件，CLAUDE.md是Claude Code识别的特定文件名，通常通过符号链接指向AGENTS.md以实现统一管理。
需要为每个项目都配置吗？
是的，建议每个项目都放置一份，并根据项目具体情况（技术栈、目录结构）修改其“项目上下文”部分。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/agents-md-ferroxlabs/raw/index.md 读取 agents-md 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/agents-md-ferroxlabs/raw/index.md（查看排版版本）