我把 Agent 的 Plan 与执行做成了「运行时对象」，它终于不会在半路上自己跑偏了

编者按，本文来自一个真实开源项目的复盘，写的是一套叫XTAO的 Agent 规划与执行框架。它用G4C做 Plan 生成，用TAO（Think-Action-Observation，思考-行动-观察）做步骤级执行，用Replan做执行中的自我修正。读完这篇，你会对「为什么 Agent 做着做着就偏了」「怎么让 Plan 自己知道错了还知道怎么改」有一个完全不一样的理解。GitHub 地址：https://github.com/xiaoyesoso/XTAO故事是这样的。最近我一直在跟 Agent 的 Plan 较劲。起因特别具体。我手里有一个自动处理 PDF 的工作流，原本想得挺美好，用户丢进来一份财报，Agent 先读、再总结、再生成图表、最后输出一份一页纸的摘要。结果跑起来以后，bug 接踵而至。印象最深的一次，财报里某一页的页脚有补充说明，Agent 在「分段」那一步把它漏了，到「摘要」那一步自然就少了关键数字。但日志里报错的位置，是最后格式化输出那一环。我当时就愣住了。我盯着错误信息看了半天，差点直接去改格式化模块。后来冷静下来才意识到，失败点不等于根因点。格式化那一步只是老老实实地把脏数据输出了，真正的病根在更早的分段那一步。这种体验，做 Agent 的人应该都懂。我们太习惯把 Plan 当成一个「步骤列表」去执行，只要有一步走