agents.md
为AI编程助手提供项目专属指南的开放格式文件
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：agents.md。 它的用途是：为AI编程助手提供项目专属指南的开放格式文件 完整的 Skill 内容见：https://321skill.com/skills/agents-md/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请帮我为这个项目添加一个用户登录功能。” AI会首先查找并阅读项目中的AGENTS.md文件，获知应使用pnpm创建Vite+React子包、运行测试的命令格式以及PR的标题规范，从而生成符合项目特定工作流的代码和操作建议。
介绍
AGENTS.md是一个简单、开放的格式规范，旨在为AI编程助手（如Claude、Cursor等）提供项目级的上下文和操作指南。它解决了AI助手在介入新项目时因不了解特定开发环境、测试流程和团队规范而效率低下的问题。
使用方式非常简单：开发者只需在项目根目录创建一个名为AGENTS.md的文件，按照约定格式编写开发环境设置、测试指令、提交规范等内容。当AI助手被要求在该项目上工作时，它可以优先读取此文件，从而获得精准的指引，避免盲目尝试。
它非常适合项目维护者、团队技术负责人，以及任何希望AI助手能更高效、更准确地协助完成代码编写、测试和重构等任务的开发者。通过提供标准化的“说明书”，它能显著提升人机协作的流畅度。
与传统的README.md或零散的注释提示不同，AGENTS.md是专门为AI助手设计的、结构化的指令集。它不像一些复杂的AI工作流编排工具，不依赖特定平台或插件，只是一个轻量级的纯文本文件，具有极低的采用成本和极强的可移植性。
核心特点
核心区别在于其定位专一且格式轻量：它并非一个功能复杂的AI工具平台，而是一个专为AI编程助手设计的、类似“项目说明书”的纯文本格式标准，不绑定任何特定AI或IDE，实现成本几乎为零。
注意事项
不适合需要复杂逻辑判断、动态交互或深度集成到CI/CD流水线中的自动化任务。
常见问题
AGENTS.md和README.md有什么区别？
README.md主要面向人类开发者，介绍项目；AGENTS.md则专门为AI编程助手编写，提供具体的操作指令和环境指引。
使用AGENTS.md需要安装什么吗？
完全不需要安装，只需在项目根目录创建该文本文件即可，任何支持读取文件的AI助手都能使用。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/agents-md/raw/index.md 读取 agents.md 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/agents-md/raw/index.md（查看排版版本）