上下文工程 · 第 3 章 系统提示与工具上下文

上下文工程 · 第 3 章 系统提示与工具上下文

章节摘要：四成分中的两个开发者成分——指令与工具——合称常驻层：它们在设计期定型、每一轮都全额占据窗口，是为"常驻税"（1.2 节）。本章把第 2 章的预算视角落到开发者写下的每一行字上。3.1 讲系统提示的结构化设计：角色 / 边界 / 工具 / 输出契约四块模板，各自回答一个模型必须知道的问题；写作规则强调"禁止项比必须项更防错""工具用法说明是模型最常缺的信息""输出契约必须可校验"；管理上把系统提示当代码——唯一真相源、版本号与变更记录、改动过评测回归、变量注入显式化。3.2 讲工具 schema 也是上下文：它是每轮自动注入、最常被漏算的"API 文档"，1540 个工具的常驻开销可达数千 token（示意）；更关键的是权衡——工具越多选择越差（Anthropic 建议保持最小工具集，官方），节税三招是精简合并、分阶段注入、子 Agent 隔离。本章之后，常驻层的设计权完全交到你手里；第 45 章（后半）转向动态层。

学习目标

阅读完本章，你应当能够：

1. 用四块模板为自己的应用写出结构化系统提示，并说明每块的职责。
2. 建立系统提示的版本化管理：目录结构、变更纪律、评测挂钩。
3. 估算自己工具集的常驻税，并识别"工具过多"的失效信号。
4. 按三个层次（是什么 / 何时用 / 何时别用）重写一个工具描述。
5. 运用节税三招：精简合并、分阶段注入、子 Agent 隔离。
6. 说明常驻层与动态层在裁剪权上的分野：设计期定型的东西归谁管。

核心概念速览

（文字流程图）
C ──▶ "工具 schema 审计（3.2）·token 常驻税 + 工具越多选择越差"
S ──▶ "设计期裁剪：开发者说了算·（动态层的第 4~5 章才交给运行时策略）"
"工具 schema 审计（3.2）·token 常驻税 + 工具越多选择越差" ──▶ "设计期裁剪：开发者说了算·（动态层的第 4~5 章才交给运行时策略）"
​

一句话金句：系统提示与工具 schema 是常驻税——每一轮都要付，所以每一个字都要审计。

💡 本章两节可以对照着读：3.1 的四块模板与 3.2 的三层描述法是同一门手艺的两种载体——前者约束行为，后者供能行动；两处都强调"写给模型读的文档要可校验、可版本化、可审计"。

子章节导航

3.1 系统提示的结构化设计

四块模板与写作规则；完整模板示例；版本化管理四条纪律；常驻税视角下的长度预算。
本节产出一份可直接套用的模板与一套变更纪律。

3.2 工具 schema 也是上下文

被漏算的常驻项与成本估算；工具越多选择越差的权衡；工具描述三层写法；节税三招与 ce_tools.py 成本核算。
本节把 tools 参数从"没人看的地方"变成账本上可审计的一行。

子章节之间的逻辑关系

3.1 指令成分（约束行为：要做什么、规矩是什么）
   │  行为约束完了，供能行动 ↓
3.2 工具成分（供能行动：能做什么、怎么用好）
   │  常驻层定型 ↓
第 4 章 起转向动态层（记忆 / 素材：运行时策略的辖区）
​

两节是常驻层的一体两面：3.1 管"不许越界的框"，3.2 管"可以行动的手"——框和手都在设计期一次定型，所以本章的手艺是"写一次、每轮付钱"，字字皆成本。
读毕自检：拿你手上的系统提示与工具集各过一遍本章清单，两份审计结果合并，就是常驻层的完整预算申报。

前置知识与后续延伸

前置知识：1.2 节四成分表（指令与工具的定位）；2.1 节常驻税与预算表（本章一切"值不值"的裁判）；2.2 节位置效应（系统提示在窗口最前的位置红利）。
没有第 2 章的预算语言，本章会退化成"写作技巧课"；有了它，每个字都是一笔可计算的支出。

为后续奠定基础：3.1 的版本化纪律是第 6.2 节（后半）"上下文版本与调试"的子集与铺垫；3.2 的子 Agent 隔离是第 6 章（后半）压缩与第 7 章（后半）框架落地的常备手段；本章定型的常驻层，正是第 7.2 节（后半）客服 Agent 完整案例的第一块积木。
本章也是全书前半的收官：读完它，设计期可定型的两块（指令与工具）已全部审计完毕。