深入工程细节，动手实现你的第一个 Coding Agent
市面上有很多 Agent 相关的内容——有论文、有教学、有产品、有开源项目——但很少有人教大家"从零开始做一个产品级 Agent"。这个仓库就是这么一个教学案例项目。
- 从第一行代码开始，一步步构建一个类似 Claude Code / Codex 的产品级 Coding Agent
- 完全公开透明，包括需求分析、设计决策、踩过的坑、走过的弯路
- 记录和 AI 协作的真实过程，Vibe Coding / Agentic Engineering 会应用在开发过程中
| 维度 | 其他课程 | 开源产品 | Zero2Agent |
|---|---|---|---|
| 工程实践 | 概念讲解为主，代码多为 demo | 只有最终代码，缺少过程 | 深入真实工程问题，基于过往 Agent 开发实际经验沉淀 |
| 产品级 | 功能与案例问题较基础 | 完整但复杂，难以学习 | 从实际产品中筛选与整理的功能，作为跟练素材 |
| 小步跟练 | 章节式学习，跨度大，不细致 | 代码与变更庞杂，难跟练 | 每个迭代都可独立跟练，大小适中，循序渐进 |
看一个具体例子，你能直观感受到区别：
实现 Grep Search 工具。不仅介绍如何实现，还会从产品和工程角度，拆解为什么不用 RAG 代码搜索背后的三层原因——效果、成本、可控性。（→ grep search vs codebase search）
如果你：
- 想入门 LLM 应用开发，但不知道从哪开始
- 想学习 AI Agent 开发，但看别人的博客太抽象、看框架又太黑盒
- 想了解真实的 AI 辅助开发是什么样的，而不是营销文里那种"10 分钟搞定"
- 喜欢通过实战学习，而不是只看理论
那这个教学项目适合你。
从生产项目中总结出来的内容，作为教学案例，不是完全的 Toy Project，而是基于真实的开发。
这里融入了笔者真实的产品开发经验——来自于实际产品团队中踩过的坑、做过的一些设计决策，甚至走过的弯路。
- 从实际问题/需求出发
- 包括需求讨论记录（为什么这么做，而不是那么做）、设计文档（每次迭代的 spec，Story 入口页下再用
details/收纳技术细节） - 配套的代码实现
- 复盘笔记（哪里做对了，哪里搞砸了）
每个迭代都有 Git tag，你可以：
git checkout E01-S001-react-basic # 跳到任意迭代Fork 后自己动手，是最好的学习方式。别担心，你可以在任意时间、从任意进度（git tag）进入来跟练，或者挑选你感兴趣的来了解。
同时，这个项目也会全程用 AI 协同开发，本身也是一次 Vibe Coding/Agentic Engineering 的旅程。你可以看到：
- 实际编码时和 AI 的对话和 prompt 长什么样
- SSD 开发等模式的实践
- 如何用 AI 来做更多的事情
课程内容按四层结构组织：
- README / 首页：快速理解项目定位与入口
- Roadmap 总览页：先看完整学习地图
- Epic 页：理解一个阶段为什么存在
- Story 页：进入具体课题，先看课程入口，再按需进入
details/深入技术细节
| Epic | 目标 | 状态 |
|---|---|---|
| Epic 1：能看 / 能查 | 让 Agent 跑起安全、可解释的最小只读闭环 | In Progress |
| Epic 2：能动 / 能改 / 能执行 | 让 Agent 从“会看”走向“能动手做事” | Planned |
| Epic 3：基础能力与产品化 | 让 Agent 从 demo 走向可使用的产品形态 | Planned |
| Epic 4：健壮性与上下文管理 | 处理异常、长上下文和复杂运行情况 | Planned |
| Epic 5：扩展能力 | 引入 AGENTS、Skills、MCP、Hooks 等扩展能力 | Planned |
- 如果你是第一次了解这个项目，先看 课程 Roadmap 总览
- 先建立完整学习地图，再进入具体 Epic 和 Story
- 如果你想直接开始第一个完整样例，可以从 E1-S1：让 Agent 跑起最小只读闭环 开始
- 这里会先告诉你这次要解决什么；想继续深入时，再进入 Story 下的
details/看设计文档
- 这里会先告诉你这次要解决什么；想继续深入时，再进入 Story 下的
- 如果你想先看最近做了什么，去看 CHANGELOG.md
- 可以顺着迭代记录，再进入对应的 Epic 或 Story
首次进入建议顺序：
这不是一个希望让你直接用于生产的 Agent 产品，更多还是作为“教具"。
如果你想找一个开箱即用的 AI Agent，去试试 Claude Code、Cursor、Codex 这些产品，或者 Open Code、PI 这些项目。
这里是学习资源，不是纯粹的工具。
zero2agent/
├── packages/ # 代码
│ ├── core/ # Agent 核心逻辑
│ ├── tui/ # CLI 界面
│ └── shared/ # 共享代码
├── specs/ # 课程入口 + Story 技术文档
├── retros/ # 复盘笔记
├── .vibecoding/ # AI 协作记录
├── .discuss/ # 需求讨论记录
└── CHANGELOG.md # 迭代日志
最新更新：E01-S002 内容搜索（grep_search）已完成 — 查看详情
| 迭代 | 内容 | 状态 |
|---|---|---|
| E01-S001 | 基础 Agent 循环 | Done |
| E01-S002 | 内容搜索 (grep_search) | Done |
查看完整迭代记录和学习指南：CHANGELOG.md | 课程 Roadmap
git clone git@github.com:alienzhou/zero2agent.git
cd zero2agent
pnpm install && pnpm build
pnpm --filter @zero2agent/tui start环境要求：Node.js >= 22.0.0, pnpm >= 9.0.0
MIT