Agent 开发·从心智模型到造出 Claude Code —— 导读与地图
墨叔：老哥，这是整本教程的”目录 + 地图 + 使用方法”。你时间紧就先读这一页，按路线走，别乱跳。
这套教程在解决什么
你不是不会做 agent，你是被”LLM 没法逻辑”这个错觉困住了。真相是：逻辑不在模型里，在模型外面那层循环里。 这套教程要把那层循环补全，再把 Claude Code / Codex 这类你已经用得挺爽的工具拆开，让你看懂里面的齿轮——等你看懂了，自己造一个就只是”想造多大”的问题。
全套 15 个文件，约 15 万字（案例实战篇已拆为上 / 中 / 下三篇，每篇 30 分钟以内），对话讨论式（墨叔 vs 老哥），每个子章节 30 分钟以内，章末都配【思考题】+【参考答案】（答案当学习材料看，不是测验）。代码以 Python 示意为主，不交付可运行工程——定位是”理论 + 真实架构剖析”。
阅读路线（按顺序，别跳）
开篇（建立心智模型）
└─> Part 0.5 模式全景（模式是旋钮组合，ReAct 是基准点）
└─> Part 1 心智模型（地基：ReAct / Loop / 上下文窗口 / 概率程序可信度）
└─> Part 2 工具机制（给模型一只手）
└─> Part 3 规划与分解（让 agent 先想后做）
└─> Part 4 记忆（记得与忘记）
└─> Part 5 工程化（把玩具变生产级）
└─> Part 6 架构剖析（拆 Claude Code / Codex）
└─> Part 7 多智能体与编排
└─> Part 8 迷你 Claude Code 蓝图（自己造的分层设计）
└─> Part 9 进阶与避坑（从"能用"到"敢用"）
Part 0.5 与前 5 个 Part 是后面所有章节的”词汇表”，跳了会处处卡。Part 6 之后是真实工具拆解与进阶。
分章索引
| 文件 | 话题 | 子章节（每节 ≤30 分钟） |
|---|---|---|
| 01-开篇.md | 为什么你觉得 LLM 没法逻辑 | 缺了“循环”这层心智模型 / LLM 是函数还是人 / 怎么读这本教程 |
| 02-Part0.5-模式全景.md | 30 种模式其实是旋钮组合 | 0.1 旋钮框架 / 0.2 基础推理零件 / 0.3 单 agent 变体 / 0.4 搜索形状升级 / 0.5 多 agent 协作 / 0.6 自主长程与记忆 / 0.7 诊断选型 |
| 02-Part1-心智模型.md | Agent 到底是什么（地基） | 1.1 补全到调用工具的认知跃迁 / 1.2 ReAct 拆解 / 1.3 Agent Loop 骨架 / 1.4 上下文窗口是工作台记忆 / 1.5 概率程序怎么信 |
| 03-Part2-工具机制.md | 给 LLM 一只手 | 2.1 工具的本质 / 2.2 Tool Schema 设计 / 2.3 失败与重试（免疫系统）/ 2.4 副作用与安全 / 2.5 CRUD 暴露成工具案例 |
| 04-Part3-规划与分解.md | 让 agent 先想后做 | 3.1 规划为什么难 / 3.2 Plan-and-Execute / 3.3 粒度控制 / 3.4 反思自修正 / 3.5 规划失败的 5 种形态 |
| 05-Part4-记忆.md | 记得与忘记 | 4.1 短期 vs 长期记忆边界 / 4.2 RAG 不是银弹 / 4.3 结构化 vs 非结构化 / 4.4 记住项目约定案例 |
| 06-Part5-工程化.md | 把玩具变生产级 | 5.1 状态可恢复 / 5.2 流式与丝滑体验 / 5.3 成本延迟限流 / 5.4 可观测性 / 5.5 安全护栏 |
| 07-Part6-架构剖析.md | 拆 Claude Code / Codex | 6.1 分层拆解 / 6.2 Codex 无头模式 / 6.3 读/写/搜/执行四件套 / 6.4 系统提示词藏了什么 / 6.5 丝滑的延迟秘密 |
| 08-Part7-多智能体与编排.md | 一个不够怎么办 | 7.1 何时需要多 agent / 7.2 Orchestrator-Worker / 7.3 框架对比（LangGraph/AutoGen/自研）/ 7.4 协作成本 |
| 09-Part8-迷你ClaudeCode蓝图.md | 自己造一个怎么分层（蓝图） | 8.1 架构设计 / 8.2 核心循环怎么写 / 8.3 工具集设计 / 8.4 上下文管理 / 8.5 端到端改一个 bug |
| 10-Part9-进阶与避坑.md | 从”能用”到”敢用” | 9.1 评测 / 9.2 常见反模式 / 9.3 从 agent 到 agentic 系统 |
| 12-实战-任务拆解50例.md | 任务拆解 50 例 · 总索引 | 已拆上中下三篇，本页为分篇导航（各篇领域、案例号、阅读时长） |
| 12-1-任务拆解50例-上.md | 案例 1–15：造东西 | 技术/编程、写作/内容，编号连续，约 15 分钟，配 Part 3 读 |
| 12-2-任务拆解50例-中.md | 案例 16–25/39–48：过日子+数据 | 旅行、日常、健康、美食、数据分析，约 18 分钟 |
| 12-3-任务拆解50例-下.md | 案例 26–38/45–50：跟人钱规则 | 商业、理财、教育、法律、人际 + 收尾，约 18 分钟 |
怎么读效率最高
- 顺序读，前面是后面的词汇表。
- 每个子章节先自己答章末思考题，再看参考答案——“看懂”和”能讲给别人听”中间差着十万八千里，思考题就是逼你跨那道沟。
- 所有 Python 片段是示意，不是让你抄去跑的，作用是把机制钉死。真要动手，读完 Part 8 蓝图你自然知道该补什么工程细节。
- 本教程不教具体 SDK 写法（会过期），只教十年不过时的心智模型与系统设计取舍。抓住这些，换任何框架都只是换个螺丝刀。
- 想回看全局，就回这一页。
一句话总纲
Agent = 大厨（模型）+ 递纸条的人（你写的循环）。你焦虑的”逻辑缺失”，只看到了大厨；补全循环这层心智模型，后面所有机制才有落脚点。
配套实战手册（可运行代码）
理论看累了吧？实战/ 目录下有一套完整的可运行配套——从 lab00 跑通第一个循环，到 lab06 造出能改 bug 的迷你 Claude Code，再到 lab07 学会评测它。每个 lab 默认零依赖、零 API key、离线可跑（内置 mock LLM 适配器，没 key 也能看完整流程）。
先读 实战/00-README.md 这个总入口，按 lab00→lab07 顺序动手。每个 lab 都标注了对应的理论 Part：理论卡壳时回去翻对应章节，代码跑起来时回来对照机制。难度阶梯：
lab00 最简循环（Part1） → lab01 工具（Part2） → lab02 规划（Part3） → lab03 记忆（Part4）
→ lab04 工程化（Part5） → lab05 多智能体（Part7） → lab06 迷你 Claude Code（Part8） → lab07 评测（Part9）