首页/AI/提示词工程速查/模板片段复用与组合

模板片段复用与组合

把公共部分(角色设定、输出格式约束)抽成片段,通过包含组装生成完整模板;改动片段前评估全部引用方,防止连锁影响。

提示词工程速查AI更新于 2026-10-13

模板片段复用与组合

把公共部分抽成片段——角色设定、通用约束、输出格式要求——再由各业务模板通过包含关系组装成完整提示。好处是口径统一、一处修改全局生效;风险是一个通用片段被改动时会连锁影响所有引用方,因此改动前必须先查引用清单。

基本信息

好处口径统一,公共规则只维护一份
风险片段与业务强耦合时会把无关上下文带进其他任务
原则片段只描述通用规则,不承载具体业务数据
版本对齐片段与模板各自有版本,组合结果需记录两者版本
影响面改片段前查引用方并跑它们的回归用例

典型使用场景

  • 统一输出格式:JSON 输出要求抽成片段,全部任务共用一套契约
  • 统一角色与语气:客服语气规范片段被多个业务模板引用
  • 安全约束复用:禁止事项片段被所有对外模板包含
  • 多变体实验:同一片段搭配不同任务段,快速生成对照版本
  • 迁移与收敛:把散落的重复段落逐步收敛到公共片段

组合结构示例

组合结构示例
base.system    = 角色定义 + 通用约束
frag.json_out  = 输出 JSON 的格式要求(字段名、类型、示例)
frag.safety    = 禁止事项与合规约束

模板 = base.system + 任务段落 + frag.json_out + frag.safety

# 组合结果要记录各片段版本,便于回溯某次差异来自哪个片段
# 片段里不写具体业务字段,否则复用到其他场景会带错内容

片段类型与归属

片段内容是否可含业务信息
角色设定身份、语气、能力边界否
通用约束输出格式、长度、语言否
安全约束禁止事项与合规要求否
任务段落具体业务目标与数据是,通常不属于公共片段
片段数量不要无限增加:每多一层包含,理解最终提示词的成本就多一层,排错时要顺着包含关系逐级看下去。

易错点

  • 片段内写死某业务字段,复用到其他场景带错内容
  • 改片段不跑全部引用方回归,隐性破坏其他任务
  • 组合结果不记录片段版本,出现差异时无法定位是哪一层变了
  • 包含层级嵌套过深,最终提示词难以阅读也难排查

数据来源与参考

  • DRY 原则(Hunt & Thomas《The Pragmatic Programmer》);模板引擎 include/partial 机制概念
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌