概览

AI 时代，万物皆 Agent。Yao 给你提供笼子——你决定里面装什么。

本教程带你从一个最小的两文件 Agent，一步步构建到多阶段自主执行系统。

## 你将学到什么

本系列共五章：

| 章节 | 主题 | 你将构建的成果 |
|------|------|---------------|
| **快速开始**（本章） | 第一个 Agent + 执行模型 | 10 分钟内跑起来一个可对话的 Agent |
| **Yao Agent** | Hook、MCP 工具、Memory、多 Agent | 带工具和记忆的书签助理 |
| **CLI Agent** | Sandbox、SKILL 生态、文件工作区 | 自主编程 Agent |
| **进阶** | 私有数据库 + SUI 页面 | 有数据库和 UI 的 Agent |
| **Robot** | 多阶段自主执行流水线 | 定时、事件驱动的无人值守 Agent |

## 面向读者

- **开发者**，有基本编程基础（了解 TypeScript 更好）
- **Coding AI Agent**（Cursor、Claude Code 等）— 参见 [SKILL 包](../skill/SKILL.md)，机器可读的结构化知识

## 怎么读

根据你的情况选择路径：

**我想快速跑起来**
→ 本章从头读到尾，然后进入 [Yao Agent](/tutorials/agent/yao-agent)

**我懂基础，想直接做项目**
→ 浏览本章，然后直接跳到 [CLI Agent](/tutorials/agent/cli-agent)

**我需要定时、自动化的 Agent**
→ 先完成第 2、3 章，再读 [Robot](/tutorials/agent/robot)

## 本章内容

两个页面，合计约 15 分钟：

1. **[第一个 Agent](./first-agent)** — 只用提示词创建最小 Agent，让它跑起来并能对话。
2. **[运行原理](./how-it-works)** — 理解目录结构、三种执行模式，以及下一步该走哪条路。