Skip to main content

第一周:编码 Agent 的内部机制

本周主题​

The Internals of Coding Agents —— 编码 Agent 的内部机制

本周将深入编码 Agent 的内部工作原理,从 LLM 的本质出发,理解 Agent 循环(agent loop)的底层机制。

核心议题​

  • LLM 究竟是什么,Agent 循环在底层是如何运作的
  • 核心工具集(read、write、edit、bash)以及任务如何在这些工具间流转
  • 生产级编码 Agent 如何组织其系统提示词和工具定义

课程安排​

第一讲:课程介绍 + 200 行代码构建 Claude Code​

📖 代码导读

这份代码演示了编码 Agent 的四个核心概念:

  1. 工具注册表(TOOL_REGISTRY):把每个工具(函数)登记到一个 dict 里,键是工具名、值是函数对象。这张表既是"工具清单"的唯一来源,也是实际执行工具时的查表依据。

  2. 函数签名注入提示词(get_tool_str_representation):不手写工具说明,而是用 inspect.signature() 自动把每个工具的函数签名拼进系统提示词,同时把工具的 docstring 当作它的描述。新增一个工具只要往注册表里加一行,提示词会自动跟着更新。

  3. 工具调用协议(extract_tool_invocations):模型不返回结构化的 tool_call,而是按约定输出单行文本:tool: TOOL_NAME({"arg": "value"})。解析器把这种行还原成 (工具名, 参数 dict) 二元组,格式不合法的行直接忽略,不会中断整个循环。

  4. 单循环 agent loop(run_coding_agent_loop):一个 while 循环:读用户输入 → 调模型 → 若模型请求了工具就执行工具、把结果以 tool_result(...) 的形式回灌进对话再调模型 → 直到模型不再请求工具。

第二讲:最先进的编码 Agent 是如何设计的​

  • 主题:深入探讨定义 Agent 行为的系统提示词(system prompts),拆解最先进的编码 Agent 设计
  • 幻灯片:Google Slides
  • 提示词文件:Google Drive
  • 课程记录:9-24-26-transcript.txt(课堂内提供)

阅读材料​

本周共有 3 篇阅读材料,翻译版见下方链接:

  1. Building a Coding Agent —— 构建编码 Agent(原文视频)
  2. Lessons from Building Claude Code —— 构建 Claude Code 的经验教训(原文)
  3. Dive into Claude Code —— 深入 Claude Code(原文论文)

Prompts 翻译​

第二讲涉及的 Claude Code 提示词文件,已逐份完成中英对照翻译。每份文件包含英文原文与中文译文,方便对照阅读:

文件用途
system_prompt主系统提示词——定义智能体身份与行为准则、工具使用规范、会话专属指引、记忆机制、可用模型与环境信息
tool_list内置工具清单——按类别列出文件读写、Shell、搜索与代码智能体、Agent、计划与隔离、调度等工具
compaction_prompt上下文压缩提示词——把长对话压缩成可继续工作的摘要
plan_mode计划模式提示词——禁止改动、只读探索,规定 Phase 1–5 的计划工作流
subagent_prompt子智能体任务书示例——一份完整的深度分析型任务提示词
config_files项目级配置注入提示词——把 CLAUDE.md 等项目说明喂给模型