Agent-Learning-Hub README

The project's README from github.com/datawhalechina/Agent-Learning-Hub. As one markdown file: README.md.

Agent Learning Hub

A curated AI Agent learning roadmap for people who want to build useful, reliable agents instead of collecting random links.

这个仓库只维护一个核心展示面:README。目标是把社区里优秀分享、官方博客、论文、开源项目和真实工程经验,整理成一份可以照着执行的 AI Agent 学习 todo list。

Maintainer

Curated by 陈思州 (Datawhale 成员) Static Badge

How To Use

What To Learn Now

Agent 领域变化很快。当前更值得投入的不是老式“角色扮演多 agent 框架”,而是这些更贴近真实生产力的方向:

Priority Learn Why
1 Claude Code / Codex-style coding agents 真实代码库、shell、文件编辑、测试、权限、上下文压缩,是最好的 agent 工程样本。
2 Agent harness engineering agent 的能力很大一部分来自 harness:工具协议、权限、状态、反馈、回放、CI、评测。
3 OpenClaw / Hermes-style personal agents 长运行、本地优先、跨应用、记忆、skills、消息入口,更像“个人操作系统”。
4 Skills / MCP / A2A / ACP skills 负责能力复用,MCP 连接工具,A2A 连接 agent,ACP 连接宿主应用。
5 Evaluation and safety 没有 eval、trace、权限边界的 agent 只能算 demo。

不建议把精力重押在已经泛化成模板的老式 crew/role-play 框架上。它们可以了解,但不应成为主线。

Learning Todo List

Stage 0: Understand What An Agent Is

产出:写一页短笔记,回答「我的场景为什么需要 agent,而不是普通 workflow?」

Stage 1: Build A Minimal Agent Loop

推荐阅读:

产出:一个 50-150 行的最小 agent,可以选择工具、执行工具、返回最终答案。

Stage 2: Learn Tool Use, RAG, And Memory

推荐阅读:

开源项目参考:

Project Why It Fits Stage 2
GPT Researcher 最接近“资料研究助手”的成品:搜索、抓取、筛选、引用、生成长报告。
Open Deep Research LangGraph 写的 deep research 示例,适合学多轮搜索、状态管理和引用输出。
STORM Stanford OVAL 的研究写作系统,适合学 outline、question asking、多视角资料综合。
Khoj 个人 second brain,适合学本地文档、网页、语义搜索和长期记忆。
Onyx 企业级 RAG/search assistant,适合学 connectors、hybrid search、权限和生产化。
AnythingLLM 本地 RAG + agents 产品,适合初学者快速理解完整应用形态。
RAGFlow 文档理解型 RAG 引擎,适合学 ingestion、chunking、retrieval、grounded answer。
mem0 记忆层组件,适合学如何给 agent 加长期 memory。
Letta 面向 stateful agents 的 memory/context 平台,适合学上下文管理。

产出:一个资料研究助手,输入主题后自动搜索、筛选、总结并输出引用链接。

Stage 3: Study One Modern Agent Harness

先选一个现代 agent 系统学深。这里的重点不是“框架 API 怎么调”,而是它如何组织工具、上下文、权限、状态、日志、子任务和反馈。

System Best For Learn This If You Want To
Claude Code Docs Coding agent product 学真实 coding agent 的 CLI、工具、权限、hooks、subagents、MCP。
learn-claude-code From-scratch agent harness 从 0 到 1 复刻 Claude Code-like harness。
claw0 From-scratch OpenClaw gateway 从 agent loop 一路构建 session、channel、gateway、memory、heartbeat、delivery、resilience、concurrency。
hello-agents Chinese agent tutorial 从零开始构建智能体,适合系统补 Agent 原理与实践。
OpenClaw Local-first personal agent 学本地长运行 agent、skills、消息入口、系统工具和安全边界。
Hermes Agent Self-hosted growing agent 学长期记忆、skills、toolsets、多平台消息网关和迁移能力。
CyberClaw Transparent agent architecture 学全行为审计、两段式安全调用、双水位记忆和心跳任务。
LangGraph Stateful graph orchestration 学状态图、可恢复执行和可控编排。

产出:一个可调试的 agent harness demo,包含 README、运行步骤、示例输入输出和失败记录。

Stage 4: Multi-Agent Is Coordination, Not Magic

推荐阅读:

产出:一个小型多 agent 系统,例如 research -> write -> review -> revise。

Stage 5: Learn Skills, Protocols, And Capability Packaging

现代 agent 的能力不只来自模型和工具,也来自可复用的 skills。一个好的 skill 像一份小型操作手册:告诉 agent 什么时候使用、怎么使用、需要哪些脚本/资源、如何验证结果。

推荐阅读:

产出:一个可复用 skill,例如 code-review、research-report、migration-helper、pdf-extraction 或 release-note-writer。

Stage 6: Browser And Computer-Use Agents

推荐阅读:

产出:一个只操作公开网页的 browser agent,例如打开网页、提取信息、生成摘要。

Stage 7: Evaluation, Observability, And Safety

推荐阅读:

产出:一个 agent eval 表格,至少包含 20 个任务、期望结果、实际结果、失败分类。

Stage 8: Ship A Real Agent

产出:一个别人能 clone 下来跑的 agent 项目。

Project Ladder

Level Project What You Learn
1 Calculator Agent 最小 tool call loop
2 Web Research Agent 搜索、筛选、引用、总结
3 PDF QA Agent RAG、chunk、retrieval、citation
4 Coding Review Agent 读取 diff、风险排序、测试建议
5 Browser Agent 页面观察、点击、提取、失败恢复
6 Claude Code-like Nano Agent shell、文件编辑、权限、session、compact
7 OpenClaw-like Gateway channel、routing、session、memory、heartbeat、delivery
8 Reusable Skill Pack SKILL.md、脚本、模板、触发条件、smoke test
9 Multi-Agent Writer planner、writer、reviewer 协作
10 Personal Agent OpenClaw/Hermes-style 记忆、skills、消息入口
11 Production Harness evals、trace、权限、CI、runner、回放

Curated Resources

Official Guides And Blogs

Resource Why It Matters
Anthropic: Building effective agents Agent 设计入门必读,讲清 workflow 和 agent 的边界。
Claude Code Overview 当前最值得研究的 coding agent 产品文档入口。
Claude Code Subagents 学任务拆分、上下文隔离、专用子代理。
Claude Code Hooks 学如何拦截、校验和扩展 agent 行为。
Claude Code GitHub Actions 学 coding agent 如何进入 PR / issue 工作流。
Claude Code Advanced Patterns Anthropic 官方材料,覆盖 subagents、MCP 和真实代码库扩展。
OpenAI: A practical guide to building agents 面向产品和工程团队的 agent 落地指南。
OpenAI: New tools for building agents Responses API、Agents SDK、工具和 tracing 的官方介绍。
OpenAI Agents SDK OpenAI 原生 agent 开发入口。
Claude Tool Use Claude 工具调用机制。
Claude Computer Use 电脑操作类 agent 的官方参考。
Gemini Function Calling Gemini 工具调用官方文档。
Gemini Code Execution Gemini 代码执行工具。
Google Agent Development Kit Google 的 agent 开发框架。
Model Context Protocol Agent 连接工具和数据源的重要协议。

Project Map

项目不要按 star 数乱读,建议按学习目的分层:

Layer Study These Learn
Build From Scratch learn-claude-code, claw0, hello-agents agent loop、tool registry、session、context compaction、gateway、trace、subagents。
Personal / Always-On Agents OpenClaw, Hermes Agent, CyberClaw 长运行、skills、记忆、消息入口、权限、安全审计。
Coding Agents Claude Code, OpenAI Codex, OpenCode, OpenHands, SWE-agent, pi 真实代码库编辑、shell、测试、sandbox、PR 工作流。
Agent Harness / SuperAgent Runtime DeerFlow, LangGraph 长任务执行、sandbox、memory、skills、subagents、message gateway、trace。
Deep Research / RAG Agents GPT Researcher, Open Deep Research, LlamaIndex 搜索、抓取、检索、rerank、引用、报告生成。
Tutorial Encyclopedias GenAI_Agents, hello-agents, smolagents, agents-towards-production 横向看 ReAct、Plan-and-Execute、Multi-Agent、production patterns。
Browser / Multimodal Agents browser-use, UI-TARS-desktop 浏览器/桌面操作、视觉理解、动作空间、失败恢复。

Skills, Protocols, And Tooling

Concept Learn From What It Solves
Skills Claude Code Skills, OpenClaw Skills 把一类任务的流程知识、脚本、模板和验收标准打包成可复用能力。
MCP Model Context Protocol, 官方 MCP Servers 合集 让 agent 标准化连接外部工具、数据源和服务;官方 servers 合集涵盖文件系统、数据库、搜索、浏览器等常见场景,是学 MCP 接入最直接的参考。
A2A Agent2Agent Protocol 让不同 agent 之间发现、通信和协作。
ACP Agent Client Protocol 让编辑器、终端、IDE、宿主应用和 agent 之间形成统一接口。
Skill Quality SWE-Skills-Bench, Agent Skills analysis, SkillOpt 评估、优化和验证 skills 是否真的提升成功率,而不是制造新的 prompt 噪声。

Modern Agent Systems

System Why It Is Useful
Claude Code 学 coding agent 的产品化形态:shell、文件、权限、hooks、subagents、MCP。
learn-claude-code 从零构建 Claude Code-like nano agent,适合理解 harness engineering。
claw0 从零构建 OpenClaw-like agent gateway,覆盖 channel、routing、session、memory、delivery、concurrency。
hello-agents 中文智能体系统教程,适合从零开始补齐 Agent

Agent-Learning-Hub (datawhalechina/Agent-Learning-Hub)

Searching Database…

What is this?Agent Learning Hub is a curated, stage-by-stage roadmap and resource library for learning to build AI agents, covering everything from a minimal tool-call loop to shipping a production-ready multi-agent system.
Is this a framework to install, or just a reading list?It is a single README organized as a checklist-style curriculum with linked articles, papers, and open-source project references — there is no code or framework to install here.
Where should a beginner start?Start at Stage 0 by reading Anthropic's 'Building Effective Agents' and OpenAI's 'A practical guide to building agents', then write a short note on why your use case needs an agent before moving to Stage 1's minimal agent loop.
Does it include working agent code I can run?No — it is a curriculum of checklists and links to external guides, papers, and open-source projects; you build and run the actual agents yourself using the referenced resources at each stage.
How is the roadmap organized?It runs through 8 stages, from building a minimal agent loop and RAG/memory basics to studying a real agent harness, multi-agent coordination, skills/protocols, browser agents, evaluation, and finally shipping a real agent.
What is the Project Ladder?It is a table of 11 progressively harder hands-on projects, from a simple Calculator Agent up to a Production Harness, each naming the specific skill it teaches such as RAG, browser automation, or multi-agent writing.
Which agent harnesses does Stage 3 recommend studying in depth?It points to Claude Code, learn-claude-code, claw0, hello-agents, OpenClaw, Hermes Agent, CyberClaw, and LangGraph, chosen to study how real systems organize tools, context, permissions, and state.
Size
0.1 MB
Stars
8.8K
Updated
CommitJul 19
Age
5mo
Commits · 90 Days