Agent 开发学习路线

🗺️ 学习路线图

由浅入深，每个阶段都有明确目标和可交付成果

PHASE 01核心原理第 1-2 周

🎯 搞懂 Agent 本质——理解 LLM 基础、工具调用、Agent 范式、Prompt 工程

1.1LLM 基础机制

理解 Prompt → Completion 完整流程（API 调用链路）
搞懂 Token、Context Window、Temperature、Top-p 等核心参数
理解 System Prompt vs User Prompt 的角色分工
🛠️ 动手：用智谱 API 写一个最简单的对话脚本
🛠️ 对比测试：glm-5.2 / turbo / MiniMax M3 输出差异

1.2Function Calling / Tool Use

理解工具定义的 JSON Schema 格式
理解调用链：LLM 返回意图 → 执行 → 结果回注 → 继续推理
🛠️ 动手：用智谱 API 实现带自定义工具的 Agent
对比 Anthropic vs OpenAI vs 智谱的 Tool Use 实现差异

1.3Agent 核心范式

理解 ReAct 模式（Reasoning + Acting）核心循环
理解 Chain of Thought 对推理质量的提升
理解 Plan-and-Execute 模式
🛠️ 动手：读 OpenClaw 源码的 Agent Loop，画执行流程图

1.4System Prompt 工程

理解角色定义、指令分层、边界约束的写法
对比 SOUL.md / AGENTS.md，分析设计技巧
🛠️ 动手：为不同场景写 System Prompt 并测试

📚 推荐资料

Anthropic: Building AgentsClaude Code 设计理念来源Link →

Anthropic: Prompt EngineeringSystem Prompt 最佳实践Link →

智谱 API 文档Function Calling 协议Link →

OpenClaw 源码本地 Agent 运行时源码本地

PHASE 02工具与记忆第 3-5 周

🎯 让 Agent 能做事（工具）、能记住（记忆）、能管理上下文

2.1工具系统深入

理解工具定义的完整 JSON Schema
理解 description 写法对工具选择的影响（关键细节）
多工具场景：LLM 在 10+ 工具中的选择策略
工具编排：串行依赖 vs 并行执行
🛠️ 动手：实现带 5+ 工具的 Agent

2.2记忆系统

短期记忆 = 上下文窗口，及其局限性
上下文压缩：摘要、滑动窗口、关键信息提取
长期记忆 = 向量数据库（Embedding + 相似度检索）
RAG 完整流程理解
Embedding 原理：文本 → 向量 → 空间距离 = 语义相似度
🛠️ 动手：分析 OpenClaw memory-tencentdb 插件机制
🛠️ 动手：用 Node.js + 向量数据库实现简单 RAG

2.3上下文管理实战

阅读 Claude Code 上下文窗口文档，理解 token 消耗
分析：一次完整 Agent 循环消耗多少 token
理解 OpenClaw compaction 压缩机制
🛠️ 动手：实现上下文管理器（token 计数 + 自动摘要）

📚 推荐资料

Claude Code: Context Window上下文可视化Link →

Claude Code: How It WorksAgentic Loop 详解Link →

LangChain RAG TutorialRAG 概念入门Link →

ChromaDB 文档轻量向量数据库Link →

PHASE 03规划与多步推理第 6-8 周

🎯 让 Agent 能解决复杂多步骤问题，具备错误恢复和子任务委派能力

3.1规划框架

深入 Plan-and-Execute：计划 → 执行 → 动态调整
理解 ReWOO 模式：规划与执行分离
动态规划：中途发现新信息后修改计划
子任务分解：大任务 → 子任务 → 委派 → 汇总
🛠️ 动手：实现多步指令 Agent（分析→找bug→修复→验证）

3.2错误恢复与自纠错

重试策略：指数退避、最大重试次数
Fallback 机制：主模型失败 → 降级备用模型
自纠错循环：执行 → 验证 → 失败 → 分析 → 重试
🛠️ 动手：给 Agent 加错误恢复（工具重试、模型降级）

3.3子任务委派（Sub-agent）

Sub-agent 价值：独立上下文、专用 Prompt、受控权限
生命周期：创建 → 委派 → 独立执行 → 返回摘要
阅读 Claude Code Sub-agent 文档（Explore / Plan 设计）
🛠️ 动手：用 OpenClaw sessions_spawn 创建子代理

📚 推荐资料

Claude Code: Sub-agents子代理设计详解Link →

LangGraph 文档有状态多步 Agent 图编排Link →

ReWOO 论文规划与执行分离范式Link →

PHASE 04自主编码 Agent第 9-14 周

🎯 开发能自主读代码、改代码、跑测试的编码 Agent（对标 Claude Code）

4.1代码理解能力

文件系统导航：目录感知、类型判断
代码读取：语法结构、函数/类/模块边界
依赖分析：import/require 链路追踪
Git 集成：log、diff、变更历史
🛠️ 动手：实现代码库探索工具（类 Claude Code Explore）

4.2代码修改能力

增量编辑 vs 全量重写的 tradeoff
Diff 生成与 Apply：精确定位修改
多文件协同修改：改 A 后自动检测 B 是否同步
🛠️ 动手：实现精确文件编辑工具（类 OpenClaw edit）

4.3执行与验证

Sandbox 执行环境：隔离危险操作
命令执行工具：shell → 捕获输出 → 解析结果
测试验证循环：跑测试 → 解析失败 → 定位 → 修改 → 重跑
构建验证：build → exit code → 处理错误
🛠️ 动手：搭建完整的编码→测试→修复循环

4.4项目级工作流

理解 CLAUDE.md / AGENTS.md 的作用
项目初始化：读结构 → 加配置 → 建上下文
Git 工作流：修改 → 提交 → 创建 PR
🛠️ 动手：整合所有能力，搭建最小可行编码 Agent

📚 推荐资料

Claude Code: Best Practices编码 Agent 最佳实践Link →

Claude Code: Tools Reference内置工具完整参考Link →

Claude Code: Hooks生命周期钩子机制Link →

Claude Code: Skills技能系统设计Link →

Aider (开源编码 Agent)终端编码助手参考实现Link →

PHASE 05多 Agent 协作第 15-18 周

🎯 理解多 Agent 架构，反推 OpenClaw 三 Agent 架构原理

5.1Agent 间通信

消息协议设计：格式、字段、错误码
指令模板设计：标准化任务下发格式
权限控制：谁可以给谁下指令
🛠️ 动手：设计一套 Agent 间通信协议

5.2任务分发与汇总

主 Agent → 子 Agent 分发：任务拆解与独立执行
并行执行：多个子任务同时处理
结果聚合：子 Agent 结果合并与冲突消解
🛠️ 动手：实现一个简单的多 Agent 协作系统

5.3反推实战：OpenClaw 三 Agent 架构

读 openclaw.json 配置文件，理解 Agent 定义与绑定
分析 bindings/agentToAgent：Agent 间消息路由规则
思考：如何改进现有架构？添加新 Agent？优化通信？
🛠️ 动手：写出 OpenClaw 架构分析报告

📚 推荐资料

OpenClaw 文档Agent 平台完整文档Link →

OpenClaw 本地源码Agent 运行时完整实现本地

openclaw.jsonAgent 配置与绑定定义本地

Agent 开发学习路线
从原理到 Claude Code 级

🧩 Agent 核心架构

🛠️ 实验环境准备

💡 学习方法建议

Agent 开发学习路线从原理到 Claude Code 级

🧩 Agent 核心架构

🛠️ 实验环境准备

💡 学习方法建议

Agent 开发学习路线
从原理到 Claude Code 级