Learn Claude Code

学习路径

s01 到 s19:按 4 个阶段渐进搭建一个结构完整、接近真实主脉络的 Agent 系统

怎么使用这页

第一次完整读

从上往下顺序读,不要急着横跳。前六章是主闭环,后面都建立在它上面。

中途开始混

不要死盯源码。先看这章落在哪个阶段,再回桥接资料校正 task、runtime、teammate、worktree 这些边界。

准备自己实现

每走完一个阶段,就停下来自己手写一版最小实现。不要等到 s19 再一次性回头补。

全程可反复回看的桥接资料

如果你读到中后段开始打结,先回这些资料,而不是硬闯下一章。

时间线不仅告诉你顺序,也告诉你哪里该停

每走完一个阶段,先自己重建一版,再进入下一阶段

如果你只是一路往下读,章节边界迟早会糊。最稳的读法是在 `s06 / s11 / s14 / s19` 各停一次,确认自己真的能把该阶段已经成立的系统重新写出来。

s01-s06

先停在这里,自己重做一遍单 agent 主骨架

此时该能手搓出来的东西

一个能连续工作多轮、能调用工具、能写 todo、能委派子任务、能按需加载技能并且能做最小压缩的单 agent harness。

s07-s11

到这里先把控制面补稳,再进入任务系统

此时该能手搓出来的东西

一个不只是会跑,而是已经补齐执行闸门、扩展插口、长期记忆、输入装配与恢复续行的稳固单 agent。

s12-s14

到这里先把“工作系统”手搓出来,再看团队层

此时该能手搓出来的东西

一套能记录持久任务、后台运行慢工作、用通知带回结果,并且允许时间触发开工的最小 runtime 系统。

s15-s19

最后这一段要做的是平台边界,而不是只加很多功能

此时该能手搓出来的东西

一个拥有长期队友、共享协议、自治认领、隔离执行车道,并把原生工具与外部能力接回同一控制面的平台雏形。

阶段图例

核心闭环
系统加固
任务运行时
多 Agent 平台
核心闭环s01-s06

核心闭环:先把单 Agent 最基本的工作回路搭起来,包括工具、计划、委托、技能加载和上下文压缩。

学完本阶段,你应该能独立写出一个真正能工作的单 Agent harness。

阶段图例
01
s01LoopState + tool_result 回流

Agent 循环最小闭环

130 行代码1 个工具

真正的 agent 起点,是把真实工具结果重新喂回模型,而不只是输出一段文本。

了解更多
02
s02工具规格 + 分发映射

工具使用把意图路由成动作

169 行代码4 个工具

主循环本身不用变复杂;工具能力靠一层清晰的路由面增长。

了解更多
03
s03PlanningState + reminder loop

待办写入会话级计划

279 行代码5 个工具

对多步骤任务来说,可见计划不是装饰,而是防止会话漂移的稳定器。

了解更多
04
s04带隔离消息历史的委派

子代理子任务使用全新上下文

200 行代码5 个工具

把探索性工作移进干净上下文后,父 agent 才能持续盯住主目标。

了解更多
05
s05技能注册表 + 按需注入

技能系统先轻发现,再深加载

244 行代码5 个工具

专门知识不该一开始全部塞进上下文,而该在需要时被轻量发现、按需展开。

了解更多
06
s06持久标记 + 微压缩 + 总结压缩

上下文压缩保持活跃上下文小而稳

308 行代码5 个工具

压缩的目标不是删历史,而是保住连续性和下一步所需的工作记忆。

了解更多
系统加固s07-s11

系统加固:把“能跑”推进到“稳定可控地跑”,重点是权限、Hook、长期记忆、Prompt 装配与错误恢复。

学完本阶段,你应该知道怎样让 agent 不只是能跑,而是更稳、更安全、更容易扩展。

阶段图例
07
s07deny / mode / allow / ask 管线

权限系统意图先过安全闸门

308 行代码4 个工具

模型产生的执行意图,必须先通过清晰的权限门,再变成真正动作。

了解更多
08
s08生命周期事件 + 副作用 Hook

Hook 系统不改主循环也能扩展

252 行代码4 个工具

Hook 让系统围绕主循环生长,而不是不断重写主循环本身。

了解更多
09
s09类型化记忆记录 + reload 路径

记忆系统只保存跨会话还成立的东西

414 行代码5 个工具

只有跨会话、无法从当前工作重新推导的知识,才值得进入 memory。

了解更多
10
s10Prompt 分段 + 动态装配

系统提示词把输入组装成流水线

305 行代码4 个工具

模型看到的不是一坨固定 prompt,而是一条按阶段拼装的输入流水线。

了解更多
11
s11continuation reason + retry 分支

错误恢复先恢复,再继续

249 行代码4 个工具

系统必须清楚自己此刻是在继续、重试,还是处于恢复流程。

了解更多
任务运行时s12-s14

任务运行时:把工作从一次会话内的临时计划,提升成可持久、可后台、可定时触发的任务执行系统。

学完本阶段,你应该能把聊天内的步骤,升级成真正可持久推进的任务系统。

阶段图例
12
s12Task 记录 + 依赖 + 解锁规则

任务系统持久化工作图

227 行代码8 个工具

Todo 适合会话内规划,持久任务图才负责跨步骤、跨阶段协调工作。

了解更多
13
s13RuntimeTaskState + 异步执行槽位

后台任务把任务目标和运行槽位分开

287 行代码6 个工具

持久任务描述要完成什么,运行槽位描述谁在跑、跑到哪里;两者相关但不是一回事。

了解更多
14
s14基于 runtime task 的定时触发

定时调度让时间也能触发工作

452 行代码7 个工具

当任务能后台运行以后,时间本身也会变成另一种启动入口。

了解更多
多 Agent 平台s15-s19

多 Agent 平台:引入长期存在的队友、协议、自治行为、隔离执行工作区,以及 MCP / Plugin 外部能力总线。

学完本阶段,你应该能把单 agent 升级成多执行者协作的平台。

阶段图例
15
s15团队 roster + teammate 生命周期

Agent 团队长驻的专职队友

350 行代码10 个工具

系统一旦长期运行,就需要有名字、有身份、可持续存在的队友,而不只是一次性子任务。

了解更多
16
s16协议信封 + 请求关联

团队协议共享请求-响应规则

482 行代码12 个工具

团队只有在协作遵守共同消息模式时,才会变得可理解、可调试、可扩展。

了解更多
17
s17空闲轮询 + 角色感知认领 + 恢复上下文

自主代理自主认领,自主续跑

603 行代码14 个工具

自主性开始于:队友能安全找到可做的事、认领它,并带着正确身份继续执行。

了解更多
18
s18task-worktree 状态 + 显式 enter / closeout 生命周期

Worktree 隔离独立目录,独立车道

564 行代码18 个工具

task 管目标,worktree 管隔离执行车道和收尾状态;两者不能混成一个概念。

了解更多
19
s19作用域服务器 + 能力路由

MCP 与插件外部能力总线

463 行代码4 个工具

外部能力系统不该是外挂;它们应和原生工具一起处在同一控制面上。

了解更多

代码量增长

s01
130
s02
169
s03
279
s04
200
s05
244
s06
308
s07
308
s08
252
s09
414
s10
305
s11
249
s12
227
s13
287
s14
452
s15
350
s16
482
s17
603
s18
564
s19
463