第一周:编码 Agent 的内部机制
本周主题
The Internals of Coding Agents —— 编码 Agent 的内部机制
本周将深入编码 Agent 的内部工作原理,从 LLM 的本质出发,理解 Agent 循环(agent loop)的底层机制。
核心议题
- LLM 究竟是什么,Agent 循环在底层是如何运作的
- 核心工具集(read、write、edit、bash)以及任务如何在这些工具间流转
- 生产级编码 Agent 如何组织其系统提示词和工具定义
课程安排
第一讲:课程介绍 + 200 行代码构建 Claude Code
- 主题:课程导论,从零开始用约 200 行代码构建一个编码 Agent
- 幻灯片:Google Slides
- 完整代码:Google Drive
- 中文注释版代码:video_completed_exercise.zh.py
📖 代码导读
这份代码演示了编码 Agent 的四个核心概念:
工具注册表(TOOL_REGISTRY):把每个工具(函数)登记到一个 dict 里,键是工具名、值是函数对象。这张表既是"工具清单"的唯一来源,也是实际执行工具时的查表依据。
函数签名注入提示词(get_tool_str_representation):不手写工具说明,而是用
inspect.signature()自动把每个工具的函数签名拼进系统提示词,同时把工具的 docstring 当作它的描述。新增一个工具只要往注册表里加一行,提示词会自动跟着更新。工具调用协议(extract_tool_invocations):模型不返回结构化的
tool_call,而是按约定输出单行文本:tool: TOOL_NAME({"arg": "value"})。解析器把这种行还原成 (工具名, 参数 dict) 二元组,格式不合法的行直接忽略,不会中断整个循环。单循环 agent loop(run_coding_agent_loop):一个 while 循环:读用户输入 → 调模型 → 若模型请求了工具就执行工具、把结果以
tool_result(...)的形式回灌进对话再调模型 → 直到模型不再请求工具。
第二讲:最先进的编码 Agent 是如何设计的
- 主题:深入探讨定义 Agent 行为的系统提示词(system prompts),拆解最先进的编码 Agent 设计
- 幻灯片:Google Slides
- 提示词文件:Google Drive
- 课程记录:9-24-26-transcript.txt(课堂内提供)
阅读材料
本周共有 3 篇阅读材料,翻译版见下方链接:
- Building a Coding Agent —— 构建编码 Agent(原文视频)
- Lessons from Building Claude Code —— 构建 Claude Code 的经验教训(原文)
- 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 等项目说明喂给模型 |
🗃️ Prompts 翻译
6 items
📄️ Building a Coding Agent —— 构建编码 Agent
CS146S Week 1 视频材料 | 如何构建一个编码 Agent
📄️ Dive into Claude Code —— 深入 Claude Code
CS146S Week 1 阅读材料翻译 | 深入分析 Claude Code 的架构与实现
📄️ Lessons from Building Claude Code —— 构建 Claude Code 的经验教训
CS146S Week 1 阅读材料翻译 | 构建 Claude Code 的经验教训