AGENTS.md 是一个用于指导 AI 编码代理的开放标准。它兼容 25 个以上的代理，包括 Claude Code、GitHub Copilot、Cursor、Devin、Windsurf、Cline、Aider 等。
AGENTS.md 的作用
为项目特定的 AI 指令提供一个单一、可预测的位置
通用性强 —— 任何能读取 Markdown 的 AI 代理都可以使用它
支持包含嵌套文件的单体仓库模式（最近的配置文件生效）
与平台特定文件（CLAUDE.md、.cursorrules、GEMINI.md）互补
何时使用 AGENTS.md
将 AGENTS.md 作为适用于任何代理的通用基准。对于特定平台独有的功能，请使用平台特定文件：
文件
适用范围
最佳用途
AGENTS.md
通用 —— 所有 AI 代理
项目概述、构建命令、代码风格、架构、测试
CLAUDE.md
仅限 Claude Code
Claude 特定功能、记忆库、技能引用
.cursorrules
仅限 Cursor
Cursor 特定行为
🇺🇸English
Agents.md — Universal AI Agent Configuration
AGENTS.md is an open standard for guiding AI coding agents. It works across 25+ agents including Claude Code, GitHub Copilot, Cursor, Devin, Windsurf, Cline, Aider, and more.
What AGENTS.md Does
Provides a single, predictable location for project-specific AI instructions
Works universally — any AI agent that reads markdown can use it
Supports monorepo patterns with nested files (closest file wins)
Rule of thumb: If an instruction applies to any AI agent working on your project, put it in AGENTS.md. If it's platform-specific, put it in the platform file.
File Structure
AGENTS.md is standard Markdown. No required schema — use headings that make sense for your project. Recommended sections:
# Project Name
## Project Overview
[What this project does, its purpose]
## Build and Test Commands
[How to install, run, test, build]
## Tech Stack
[Languages, frameworks, runtime, package manager]
## Code Style
[Conventions: TypeScript, semicolons, quotes, formatting]
## Architecture
[Patterns, directory structure, key design decisions]
## Testing
[Test framework, coverage requirements, how to run tests]
## Dependencies
[Key packages and their purposes]
## Guidelines
[Rules for AI agents: what to do, what to avoid]
Monorepo Support
In monorepos, place AGENTS.md at each package/app level. The nearest file to the code being edited takes precedence:
codekit auto-generates AGENTS.md alongside other platform files:
# Generate for all platforms including AGENTS.md
codekit learn --all
# Generate only AGENTS.md
codekit learn -p agents
# Sync all platform files
codekit sync
The generated AGENTS.md includes:
Project overview and type detection
Build/test commands from package manager
Full tech stack and dependency summary
Code style conventions detected from the codebase
Architecture patterns
Installed skills reference
Memory-bank session continuity instructions
Best Practices
Keep it concise — Agents parse the entire file. Long files waste tokens.
Focus on "what" not "how" — Describe conventions and rules, not step-by-step tutorials.
Include commands — Build, test, lint, and deploy commands are the most universally useful.
Update it — AGENTS.md should evolve with the project. Run codekit sync after major changes.
Don't duplicate — If CLAUDE.md or .cursorrules already has platform-specific instructions, don't repeat them in AGENTS.md.
All these files are generated and synced by codekit learn and codekit sync. AGENTS.md acts as the common denominator that ensures any AI agent — current or future — can understand your project.
