核心背景

传统静态提示工程缺陷：将全部领域规则、指令一次性写入系统提示词

1. Token浪费：大量上下文内容与当前任务无关
2. 上下文腐化：无关信息稀释模型注意力

动态提示词演进思路：不一次性灌入全部知识，按需加载。
Agent Skills 就是这套理念工程化落地方案。

2.5.1 Skills：领域能力可组合单元

Skill：独立、可按需加载的知识包，模块化领域能力，遵循渐进式披露（Progressive Disclosure）
类比：不把所有手册堆给新员工，先提供目录，需要再调取完整文档。

三层渐进加载架构

第一层｜元数据（常驻上下文，~300 tokens）

每个Skill自带SKILL.md，头部YAML元数据：name + description

• 框架启动时扫描全部Skill，仅加载元数据列表
• description 是路由核心
  ✅ 推荐写法：Use when / Don’t use when + 反例场景
  ❌ 宽泛功能描述（极易误触发路由）

关键结论：何时使用 > 能做什么

第二层｜核心流程（按需加载，~2K tokens）

任务匹配Skill后，调用专用工具加载完整SKILL.md，以tool_result写入对话上下文。
示例：PPTX Skill 内置处理链路

1. markitdown 提取文档文本
2. 解压pptx读取内部XML结构
3. 修改幻灯片xml内容
4. 重新打包生成pptx

第三层｜细则子文档（选择性深入）

主文档通过引用链接细分资料：

• html2pptx.md：HTML模板生成PPT完整流程
• reference.md：XML格式规范
• scripts/*.py：配套可执行脚本

Skill不止文档指令，可绑定代码工具、模板文件，实现从知识指导到实际执行。

Skills 生态价值

1. 上下文资源精细化管控
2. 领域知识可持续沉淀，独立开发、版本管理
3. 能力扩展由修改系统提示词 → 模块化包管理（类似npm/pip）
4. 模型适配原则：优先采用厂商原生优化的Agent交互范式
   例：Claude生态优先使用Agent Skills，最大化模型训练对齐效果

2.5.2 Skills 三种实现方案与工程权衡

核心问题：Skill内容放置在上下文哪个位置，直接影响KV Cache效率与指令遵循效果

方式1：写入System系统提示词

• 优点：模型对system指令遵循效果最强
• 缺点：新增/切换Skill会改变system内容，KV Cache前缀失效，频繁切换场景成本极高

方式2：通用文件读取，内容置于上下文中部

• 优点：不改动system，缓存稳定
• 缺点：模型难以区分「参考资料」和「强制指令」；不同模型兼容性差距大

方式3｜生产最优方案（Claude Code 采用）路由与执行分离

1. 路由层（常驻元数据）
   所有Skill名称+简短描述封装为<system-reminder>，以user角色消息放在上下文末尾
   • 不修改system消息，保护KV缓存前缀
   • 采用emit-once：首次加载后不再重复推送，一次写入永久复用
2. 执行层（按需加载完整内容）
   模型识别需要某Skill → 调用专用Skill()工具，读取完整SKILL.md作为tool返回结果
   • 模型对自身主动调用工具输出，执行意愿更强，规避方案2指令失效问题

补充取舍：元数据永久驻留会话，随对话变长逐步移至上下文中部，注意力优势衰减；属于「缓存成本」与「指令注意力」经典权衡。

KV Cache关键认知

「对KV Cache友好」≠零成本

• 首次加载Skill需要一次性付出token写入开销
• 优势：仅付费一次写入，会话后续全程缓存命中
  对比：修改system提示词会让整条会话缓存失效，代价高出数个量级

2.5.3 Skills 与工具的关系

若将大量专用工具定义全部放入系统提示词：

• Token膨胀严重
• 更新工具定义直接破坏缓存前缀

Skill + 通用执行器优势
保持顶层工具集合精简（少量核心通用工具），领域能力通过Skill渐进式动态加载，兼顾缓存效率与能力扩展性。

工具与Skill选型对比框架详见第四章；Agent自主进化时能力沉淀策略见第八章。

实验2-6：基于Agent Skills 论文生成PPT

实验目标

验证Agent动态加载领域Skill完成复杂多步骤任务
运行环境：Claude Code + PPTX Skill

执行流程

1. 读取上下文末尾Skill元数据列表，识别PPTX能力
2. 判断任务匹配，触发PPTX Skill加载
3. 调用Skill工具读取完整SKILL.md获取标准流程
4. 根据需求进一步加载子文档html2pptx.md
5. 调用配套脚本、模板完成PPT渲染

验收标准

1. 幻灯片数量：10～15页，覆盖标题、研究背景、方法、实验结果、结论
2. 至少包含3张论文原图，图文匹配
3. 输出.pptx文件，可被PowerPoint正常打开

---