AGENTS.md
一份全局指令文件，用于规范AI编码代理的工作流程，避免常见错误。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：AGENTS.md。 它的用途是：一份全局指令文件，用于规范AI编码代理的工作流程，避免常见错误。 完整的 Skill 内容见：https://321skill.com/skills/agents-md-anbeeld/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请为这个API端点添加用户身份验证。” 它会先询问或查找项目现有的认证方案，检查相关依赖，然后提出一个基于证据的具体实现计划，并在修改后运行相关测试进行验证，最后确认解决了问题且无副作用。
介绍
AGENTS.md 是一个专为AI编码代理设计的全局指令文件，旨在解决它们在编程任务中最常犯的错误，例如未经调查就盲目编写代码、无节制地扩大任务范围或交付未经充分验证的改动。它通过一套经过实战检验的规则，强制代理遵循“先探索证据、再实施方案、最后严格验证”的结构化流程，从而提升代码质量和开发效率。
使用方式非常简单，只需将AGENTS.md文件复制到您的AI代理配置目录即可。仓库还提供了适用于macOS/Linux和Windows的同步脚本，支持一键部署到多个不同的AI工具（如Claude Code、Cursor等）。用户也可以根据自身需求，仅采纳其中的部分规则，或将其作为基础构建自己的指令集。
这个Skill非常适合所有使用AI代理进行编程开发的开发者、工程师和团队负责人。无论是使用Claude、Gemini等前沿模型，还是GLM、Kimi等倾向于顺序执行、容易跳过关键步骤的模型，这套规则都能显著提升代理输出的可靠性和安全性。
与市面上许多零散的“最佳实践”提示词不同，AGENTS.md是一个系统化、经过大量日常使用调优的完整解决方案。它并非简单的技巧集合，而是源于对代理常见错误的持续观察，并参考了行业领袖的建议，最终形成了一套具有明确优先级、执行顺序和硬性边界的操作规范。
核心特点
核心区别在于其系统性和实战性：它并非零散的提示技巧，而是一套源于日常观察、经过多模型调优、强制代理遵循“证据-执行-验证”结构化流程的完整指令体系，尤其擅长纠正代理跳过调查、盲目编码的倾向。
注意事项
不适合那些希望AI代理完全自由发挥、进行探索性创意编程或一次性快速原型验证的场景。
常见问题
AGENTS.md 和 CLAUDE.md 是什么关系？
它们是同一套指令文件，只是文件名不同以适配不同AI工具（如Claude Code通常用CLAUDE.md）。内容完全一致。
这个文件会影响AI的创造力吗？
不会限制核心创造力，而是将创造力引导到更安全、更高效的轨道上，避免浪费在错误的路径或引入低级错误。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/agents-md-anbeeld/raw/index.md 读取 AGENTS.md 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/agents-md-anbeeld/raw/index.md（查看排版版本）