我的 agent 的提示词面

My Agent's Prompt Surface

PE-P-01内容已写满G09落地实践第 16 层

01为什么需要它

一个 agent 的行为不只由系统提示决定：工具定义、技能的触发描述、子 Agent 的委派模板、记忆与检索注入、门控判据都在同一时刻影响它。

• 把这些部件合起来称作提示词面，是为了能统一回答三个问题——哪些内容必须常驻、哪些可以按需加载、改动之后要在哪里验证。
• 只盯着系统提示做优化，会漏掉大部分实际在起作用的文本，也会把回归验证做在错误的对象上。

02机制说明

盘点提示词面按四层进行。

• 常驻层是每一轮都进入上下文的部分，包括系统提示、工具的名称与描述、安全规则；它改动的影响面最大，必须跑全量回归。
• 按需层是技能正文、检索资料与外部文档，只有在触发描述被匹配中之后才展开，因此触发描述本身是常驻成本，必须短且可判定；这也解释了为什么把技能写成详尽行程单的做法已经过时——模型对细微差别与模糊性的理解变好之后，过度具体的分步指导反而会限制它的判断，把技能写成判断准则（做什么、不做什么、怎么算做完）比写成步骤表更稳，细节则交给引用文件承载。
• 传递层是委派给子 Agent 的任务描述与返回契约，要求契约稳定且可被机器检查。
• 判据层是门控脚本、校验器与评测集判据，它们不是给模型看的文本，而是给这次改动下结论的装置。
• 同一处改动会在多处显形：改工具描述会影响工具选择，改技能触发描述会影响技能是否被选中，改系统提示则会影响下游的全部判据。
• 盘点的产出是一张清单，逐部件标注所在位置、注入条件、更新频率与验证方式，这张清单本身就是后续优化的依据。

03何时该用 / 何时不该用

04实验台

1. filemarkdown

   查看代码

   # 提示词面盘点清单（逐部件一行，填完即可看出这面有多大）
   
   | 部件 | 所在位置 | 注入条件 | 更新频率 | 验证方式 |
   |---|---|---|---|---|
   | 系统提示 | <路径> | 常驻 | 低 | 全量回归 |
   | 工具描述 | <路径> | 常驻 | 中 | 工具选择评测 |
   | 技能触发描述 | <路径> | 常驻 | 中 | 触发命中率 |
   | 技能正文 | <路径> | 按需（被选中后展开） | 高 | 单技能评测 |
   | 检索资料 | <路径> | 按需注入 | 高 | 引用正确性抽查 |
   | 委派模板 | <路径> | 委派时 | 中 | 返回契约校验 |
   | 记忆条目 | <路径> | 按需注入 | 高 | 过期复核 |
   | 门控判据 | <路径> | 不注入模型 | 中 | 负向自检 |
   
   ## 填完要回答的三个问题
   1. 常驻部件的合计占用是多少？
   2. 哪些部件本该按需却被设成了常驻？
   3. 每个部件改动之后，用哪一条判据证明它变好了？

   预期观察：读者得到一张覆盖常驻、按需、传递、判据四层的清单，每个部件都写明了注入条件与验证方式；清单里标记为常驻却更新频繁的部件，就是下一步该改成按需加载的对象。

2. shellbash

   查看代码

   # 量一遍常驻占用：逐个列出常驻层部件，看谁最贵
   for f in prompt/system.md prompt/tools/*.json prompt/skills/*/SKILL.md; do
     [ -f "$f" ] || continue
     wc -m "$f"
   done
   
   # 按需层只应在被选中后展开：技能正文与引用文件不应出现在常驻清单里
   for f in prompt/skills/*/references/*.md; do
     [ -f "$f" ] || continue
     echo "按需：$f"
     wc -m "$f"
   done

   预期观察：输出是一张常驻占用清单：系统提示、工具描述与技能触发描述各占多少字一目了然；若某个技能的正文出现在常驻清单里，就说明它没有被拆成短触发描述加按需引用文件。

05证据

06术语

07失效模式

• 把系统提示当成唯一的提示词面工具描述、技能触发描述、委派模板与记忆条目都没进盘点，改动只在看不见的地方生效。
• 把技能写成详尽行程单过度具体的分步指导在新一代模型上反而限制判断，同时推高常驻占用。
• 把本该按需的资产设成常驻技能正文与检索资料挤占每一轮的上下文，成本上升而效果不升。
• 盘点完不写验证方式清单只剩部件名，改动之后无法判断是否真的变好，盘点退化成目录。

08在本站知识结构中的位置

所属分组

G09落地实践

依赖深度

第 16 层（同层节点彼此无先后约束）

在 交互全景图 中定位本节点。