---
title: "AgentFileFormat"
type: concept
tags: []
---

## Definition
Agent 定义文件采用 `.md` + YAML frontmatter 格式，是 Agency 项目与 GitHub Copilot 的共同标准文件格式。

## Core Properties
- **格式**：`Markdown 文本 + YAML frontmatter 元数据`
- **Frontmatter 字段**（典型）：`name`、`description`、`instructions`、`tools`、`model` 等
- **兼容平台**：The Agency agents、GitHub Copilot agents、Cursor（通过 `.mdc` 转换）

## Usage
1. **The Agency**：所有 agent 定义均使用此格式，存储于 `agency-agents/` 目录下
2. **GitHub Copilot**：直接读取 `.md` + YAML frontmatter，无需转换
3. **Cursor**：通过 `install.sh --tool cursor` 转换为 `.mdc` 规则文件

## Aliases
- Agent Definition Format
- Agency Agent Format

## Related
- [[GitHubCopilot]] — 使用此格式的 IDE
- [[TheAgency]] — 使用此格式的核心项目
- [[Cursor]] — 支持此格式（需转换）的 IDE