// 课程大纲 · 16 章 + 3 附录
从一次 API 调用，到一个 ~2500 行的编码 agent
完整章节地图与写作进度。每章固定五段式，结束项目必须可运行、且比上一章明显更强，代码按章打 git tag。
每章结构
- 1为什么需要它
- 2原理拆解
- 3动手实现
- 4跑起来看效果
- 5练习与延伸
全书写作中：spike 周已跑通核心能力链，正在写第 0–5 章。下方状态会随章节上线更新。
写作中 规划中 可读
第〇部分
00 导言：把黑盒拆开 写作中 里程碑 → 环境就绪，看完最终成品演示 为什么 agent 没有魔法；最终成品演示；环境准备（Node 22+、API key、~$5 预算）。 01 一次 API 调用 写作中 里程碑 → 一个会失忆的聊天 CLI——连问"我叫什么"都答不出 messages 与角色、system prompt；打通一次干净的调用，再套一个无状态对话循环。 起点
第一部分
02 Tool Use：给模型一双手 写作中 里程碑 → 能查时间、算算术的助手 工具即 JSON Schema 声明；tool call 的请求-响应协议；为什么说"模型只是输出了一段 JSON"。 03 Agent Loop：循环直到完成 写作中 里程碑 → 记得住你上一句的代码问答 agent loop 的终止条件；messages 数组的增长方式；实现 read_file 工具。 04 写与改：Write、Edit 与 diff 写作中 里程碑 → 能修真实 bug 的最小编码 agent 全量写 vs 精确替换；old_string/new_string 的设计权衡；终端里渲染 diff。 05 Bash：让 agent 跑命令 写作中 里程碑 → 丢给它一个失败的测试，它自己修到通过 子进程、stdout/stderr 捕获、超时与输出截断；跑测试→看报错→改代码→再跑的自我迭代闭环。 核心循环
agent 的本质 第二部分
06 系统提示词与环境感知 规划中 里程碑 → 注入环境后答对"当前分支有什么未提交改动" system prompt 的分层设计；注入 cwd、git 状态、目录结构；CLAUDE.md 式的项目记忆文件。 07 权限系统：信任但确认 规划中 里程碑 → agent 不再能悄悄 rm -rf 危险操作分级；写操作/命令执行的用户确认交互；白名单与会话内记忆。 08 上下文管理：对抗有限的窗口 规划中 里程碑 → 长对话不再爆窗口、API 账单下降 token 计数与预算；大输出截断；手写客户端 compaction；prompt caching 与之咬合。 09 健壮性：真实世界的网络与错误 规划中 里程碑 → 429 自动退避、Ctrl+C 取消、报错自我修正 限速与指数退避重试；流中断恢复；Ctrl+C 取消正在执行的工具；工具报错回传。 从玩具到可用
第三部分
10 子 agent：分而治之 规划中 里程碑 → 主 agent 派子 agent 全库搜索，自己保持清爽 为什么需要隔离上下文；Task 工具的实现：子 agent 的生命周期、结果回传。 11 计划与待办：让 agent 有条理 规划中 里程碑 → 开 todo 的多步任务不漏步骤 TodoWrite 式工具；为什么自列任务清单能提升长任务表现；plan 模式的实现。 12 MCP：接入外部世界 规划中 里程碑 → 你的 agent 能用上整个 MCP 生态 MCP 协议拆解（不是黑魔法，就是 JSON-RPC）；实现 MCP client，接入一个现成 server。 13 自定义命令与 Skills 规划中 里程碑 → 实现一个 /commit skill，按需加载眼见为实 斜杠命令；skill 文件的按需加载——本质是"把 prompt 工程产品化"。 进阶能力
第四部分
14 终端体验打磨 规划中 里程碑 → 流式 markdown、spinner、工具调用折叠 不依赖重型 TUI 框架的渲染：spinner、工具调用折叠；流式输出（SSE）在此落地。 15 评测：怎么知道它变好了 规划中 里程碑 → 三配置的通过率与 token 成本对比表 为 agent 写 mini eval：固定任务集 + 自动判分；用 eval 验证前面每个特性确实有效。 16 发布 规划中 里程碑 → 干净容器里 npm i -g 后三分钟跑通 demo 打包成 npm 全局命令；README 写法；如何让别人三分钟跑起来。 收尾
附录
A API 提供商选择 规划中 里程碑 → Anthropic 直连 / OpenRouter / 兼容端点 Anthropic 直连 / OpenRouter / 任意 OpenAI 兼容端点（解决国内读者访问问题）。 B 多模型适配层 规划中 在不同模型供应商之间切换的适配层设计。 C 术语表（中英对照） 规划中 全书技术名词的中英文对照表。