编码代理的六大关键组件：现代AI代码编写系统如何工作

本文深入剖析了编码代理（coding agents）的内部机制，这类工具如Claude Code或Codex CLI，本质上是为大型语言模型（LLM）设计的一整套框架（harness）。作者认为，在现代系统中，正是这套框架（而非模型本身）常常成为决定实际效果的关键因素。他归纳了该框架的六大核心组件：第一，实时仓库上下文（live repo context）：代理事先收集Git分支、项目文件、README和规则（如AGENTS.md）等信息，避免每次任务都从零开始。第二，提示词塑形与缓存复用（prompt shape and cache reuse）：将提示词中稳定的部分（通用指令、工具描述、工作空间概况）缓存并重复使用，仅更新最近一次用户请求、近期的交互记录和短期记忆。第三，结构化工具、验证与权限（structured tools, validation and permissions）：代理只能调用预定义的工具（例如列表文件、读取文件、搜索、运行Shell命令），每次执行前都会进行参数正确性、路径合法性和用户授权检查。第四，上下文精简与输出管理（context reduction and output management）：通过截断（clip）和历史管理来避免上下文膨胀，防止回答质量下降。第五，交互记录、记忆与会话恢复（transcripts, memory and resumption）：保存交互日志、笔记，支持会话的中止与续接。第六，任务委派与有限子代理（delegation and bounded subagents）：代理可将部分工作交给专门的子代理处理。作者强调，优秀的框架能显著提升普通（非推理型）模型的效能，使其媲美甚至超越未配备此类框架的更强大系统。