前置知识
阅读本文前，你需要先学习：
动手实现一个 Coding Agent 给 Agent 装了 read_file、write_file、run_command 三个工具，靠它们就能读代码、改代码、跑测试。
但那三个工具是最朴素的版本，read_file 直接返回纯文本，write_file 二话不说整体覆盖，连个 edit_file 都没有。
Claude Code 文件读写是怎么实现的 分析过这样用文件会碰上的三个问题：幻觉盲改、并发覆盖、token 浪费，以及 Claude Code 怎么用一套状态管理机制解决它们。
这篇我们动手把那套机制搬到自己的 Agent 上。