模块 ② · 搭建 · Harness 五支柱
简单任务用不上,复杂项目离不开
上一步你造出了第一个会干活的 agent。现在把它一步步升级成一个有工具箱、会规划、能派子智能体、会压缩记忆、有安全门的 mini Claude Code——只加 6 个想法。
「创建 hello.txt」这种小任务,一个基础 agent 就够了。但真实开发面对的是一个有很多文件、互相调用、还可能藏着 bug 的项目。下面这五个机制,恰恰只有在这种真实项目上才显出价值——简单任务用不上,复杂项目离不开。
每一步只加一个想法。终点只有 ~35 行,却已经是真 Claude Code 的雏形。
把上一步的「命令:/完成:」文本,升级成结构化 JSON。为什么:机器读得准、前端好解析,不再靠猜。
不止能跑命令——加上 read_file / write_file,按名字派发。为什么:真实项目要读写很多文件,一个 bash 不够用。
让 agent 先列出计划、边做边勾。为什么:多步骤任务不列计划,做着做着就乱、就漏。
派一个有独立上下文的子 agent 去干脏活,只拿回一句摘要。为什么:脏活塞主上下文会爆;也是「安全复核」的用法。
历史太长就自动折叠成摘要、重开窗口。为什么:长对话会撑爆上下文,压缩让它能一直干下去。
危险命令(删文件等)执行前先问你 y/n。为什么:放权给 AI,但高风险动作必须人点头——安全底线。
光在「创建 hello.txt」上练,你永远看不出这五个机制为什么存在。所以我们准备了一个麻雀虽小、五脏俱全的玩具笔记本 CLI(notes_app:多文件 + README + TODO + 一个故意藏起来的 bug)。c0–c5 的每个复杂例子和作业,都在这同一个靶子上跑——你会亲眼看到:哦,原来这一步是为了这个。
打开开源仓库,跟着 c0→c5 一步步把 mini Claude Code 造出来。你不用手写,让 Claude Code 帮你跑、你负责看懂每一支柱。卡住了叫爱兔宝。