能拆开跑通的最小件就是理解的单位

freeCodeCamp 出了个很对味的手册，标题就是方法论本身：想真正理解 Claude Code 这样趁手的工具，最好的办法是自己造一个。手册带你用 Python 和 Gemini 写一个自己的 AI agent，顺带把多目录项目怎么组织、AI 工具在底层如何运转、函数式编程的用法一并讲透。

（转述自原帖，手册：freecodecamp.org/news/build-an-… ）

"自己造一个"这五个字，在今晚的课程序列里出现得越来越密。先是 harness 免费课程教你把闭环搭起来、Palantir 六层告诉你栈该长什么样、SkillOpt 演示了技能怎么自己进化——这篇补上了更基础的一环：用之前先拆一遍。

看说明书是消费、跑任务是使用、动手复刻才是理解；而 agent 恰好是少数"复刻成本不高、理解收益极高"的对象：两三百行就能跑通循环，难的部分（上下文管理、工具调用、状态延续）正是你自己会撞上的那些墙——撞过一次，再用别人的工具时每一步都看得懂。

这也解释了为什么"底层原理"四个字值得单独圈出来。多数教程教的是调用姿势：怎么配、怎么提示、怎么接 API；这篇讲的是"under the hood"——为什么多目录要那样划分、工具为什么长成现在的接口、状态为什么必须显式传递。姿势会在下个版本过期，原理不会；今晚"留三成精力跟下一代接口"那篇说要迁移的是结构，这里的注脚是：能迁移结构的人，得先看懂过结构。

留一格实际的：造这个练习品不是为了上线，是为了留一份"手搓的参照"——当工具行为反常时，你知道从哪一行开始查；这也是免费课程里那套 audit 脚本之外的另一种体检：不检查你的配置，检查你的理解。

给想上手的人一句落地的：别从"写 agent"开始，从"最小可跑的三件事"开始——读一个文件、调一个工具、把结果写回去；三件事各自能单测，再谈循环与记忆。能拆开跑通的最小件，就是你理解一个复杂工具的最小单位；跑通它，今晚读过的每一篇都会各自再亮一次。