// 关于本项目
一本免费、开源的「从零复刻」教程
《Build Your Own AI Agent》是一本 build-your-own-x 风格的教学项目：用 ~2500 行 TypeScript、不依赖任何 agent 框架，渐进式地手写出一个具备 agent loop、文件读写、shell 执行、权限确认、上下文压缩、子 agent 与 MCP 能力的编码 agent。
和同类的区别
对标 · 付费课
免费，而且走得更深。 CodeCrafters 的《Build your own Claude Code》止步于 Read / Write / Bash + 基础 loop。本书免费开源，一路走到上下文压缩、子 agent、MCP、skills、评测——多数教程停下的地方，正是这本书的后半程。
对标 · 成品导读
从空文件渐进式构建，不是逆向导读。 不像 learn-claude-code 或成品导读式项目那样摊开成品代码讲解。本书每一章从上一章的可运行版本出发，只加一个能力，代码按章打 git tag，随时能 diff 对照、逐行看懂。
对标 · 使用教程
讲内部机制，不是用法。 tool use 就是一段 JSON、loop 就是重发数组、MCP 就是 JSON-RPC——把这些「黑魔法」拆成你能亲手复刻的协议，而不是教你怎么用现成的 agent 工具。
许可
代码 MIT —— 随意使用、修改、分发。
书稿 CC BY-NC-SA 4.0 —— 署名、非商业、相同方式共享。
「Build Your Own X」系列
本项目属于经典的「亲手复刻」流派——通过从零重写一个你每天在用的工具，真正理解它。下面是同流派的代表作，均收录于 codecrafters-io/build-your-own-x：
- Build your own Redis 从零实现一个支持并发的内存数据库
- Build your own Git 复刻对象存储、commit 与分支模型
- Build your own Docker 用 namespace / cgroup 手写容器运行时
- Build your own Shell 实现一个能跑管道与内建命令的 shell
- Build your own HTTP Server 从 socket 起手写一个 Web 服务器
- Build your own Interpreter 为一门小语言写词法、语法与求值器