Harness Agent 脚手架实战课

很多人写 Agent，卡住的地方不在模型调用，而在脚手架。会调 API，不等于能搭出一个能跑、能改、能扩展的 Agent 项目；能跑通 demo，也不等于知道四个脚手架各自该在什么时候用。这门课就是补这块的。

先确认你缺的是哪一块

如果你现在处于下面任意一种状态，这门课的针对性会比较强：

• 能写单文件 Agent 脚本，但一到多工具、多轮次、多角色就开始乱，状态管理靠全局变量硬撑。
• 听过 Harness Agent 相关概念，但说不清它和普通 Agent 框架的分工边界在哪里。
• 知道有四个脚手架，实际只熟悉其中一个，遇到新需求仍然用老办法硬套。
• 项目能跑，但目录结构、配置方式、调试手段都是临时凑的，换个人接手就得重读一遍源码。
• 想让 Agent 接入真实工具链（文件、命令、外部服务），但不确定脚手架层面该负责到哪一步。

如果上面一条都不占，你大概不需要这门课。这门课不讲解模型原理，也不从零教编程。

四个脚手架，重点是"什么时候用哪个"

课程围绕四类脚手架展开，但真正的价值不在于把每个都过一遍，而在于建立选择判断：任务规模多大、需要多少工具、要不要多轮编排、要不要持久化状态，分别对应哪一套结构。很多人的问题不是不会用某个脚手架，而是用错了脚手架，然后在错误的结构上不断打补丁。

课程里会反复出现的一个训练点是：拿到一个需求，先判断它属于哪一类，再决定用哪套脚手架起步。这个判断做对了，后面省下的重构时间远超学习成本。

配套练习大致是什么形态

练习不是填空题，而是给一个具体场景，让你自己搭出可运行的 Agent 结构，再对照参考实现检查差异。重点看三处：

• 工具注册和调用路径是否清晰，加一个新工具需要改几个地方。
• 多轮交互时状态放在哪、怎么传递、出错后能否恢复。
• 调试时能不能快速定位是脚手架配置问题还是 Agent 逻辑问题。

建议每做完一个练习，先不看参考实现，自己回读一遍代码，问一句"如果需求变了我改哪里"。答不上来的地方，就是这门课真正要补的点。

看完应该能回答的问题

• 四类脚手架各自的适用边界是什么，什么信号出现时应该换一套？
• 一个 Agent 项目从需求到可运行，脚手架层面最低限度要做哪几件事？
• 新增一个工具或一个角色，需要动哪些配置、哪些代码，有没有更省的做法？
• 当 Agent 行为不符合预期时，怎么区分是脚手架搭得不对，还是提示与逻辑写得不对？
• 现有项目如果要迁移到另一套脚手架，成本主要落在哪里？

这几个问题能自己讲清楚，说明你不是"跟着敲了一遍"，而是真的把脚手架当工具在用。讲不清楚，就回去重做对应练习。

怎么用这门课

不建议顺序刷完就结束。更有效的做法是：先挑一个你手头真实的小项目，用课程里的判断方法选一套脚手架搭起来，遇到卡点再回看对应章节。脚手架这种东西，看懂和用过之间差得很远。带着一个具体问题进去，出来的收获会比空手听完大得多。