首页/AI/提示词工程速查/模板注册表与命名规范

模板注册表与命名规范

模板集中登记、按 ID 引用,避免散落各处与复制分叉:命名体现领域与任务、带版本与状态,负责人与回归用例一并记录。

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

模板注册表是什么

模板注册表把所有提示模板集中登记、按标识引用,避免模板散落在各处代码与文档里各自分叉。登记项包含用途、变量、状态、负责人与回归用例,调用方只写标识不写路径。名字体现领域与任务,并带版本与状态,找起来和评影响面都不靠记忆。

基本信息

命名领域.任务.版本三段式,版本与仓库标签一致
状态机candidate 试验到 stable 稳定,退场标 deprecated
引用方式调用方只引用标识,不硬编码文件路径
登记字段用途、变量、负责人、回归用例、最近验证时间
维护废弃条目标注并设下线期限,调用方收到迁移通知

典型使用场景

  • 新项目选模板:按领域与任务检索,避免重复造一份相似模板
  • 评估改动影响:改公共模板前按注册表查全部引用方
  • 权限与审计:注册表说明每个模板由谁负责,问题有人承接
  • 清理技术债:把长期无人引用的模板标记废弃并下线
  • 对外交付:给客户看登记表就能说明模板清单与版本状态

注册表条目示例

注册表条目示例
id: summarize.meeting.v3
用途: 会议纪要摘要
负责人: ops-team
变量: transcript, max_points?
状态: stable
回归: eval-meeting-v2(通过率 96%)
最近验证: 2026-10-01
# 调用方只写 summarize.meeting,主版本由注册表解析

登记字段与作用

字段作用缺失后果
用途检索与选型只能靠翻文件找模板
变量渲染校验与调用约定调用方传错参数直到线上才发现
状态区分试验与稳定误用未验证的模板
负责人问题承接与审批改动无人拍板
回归用例变更前验证依据改完不知道是否变差
注册表要尽量由流水线自动生成或校验:手工维护的清单会在两三次迭代后与仓库实际状态脱节。
引用计数是注册表最实用的字段之一:长期零引用的模板优先考虑下线,而不是继续为它维护变量与回归用例。

易错点

  • 复制模板后各自修改,修一处漏三处,行为逐渐分叉
  • 废弃模板不标注,调用方继续引用旧版本
  • 注册表与仓库实际内容脱节,检索到的是已经删掉的条目
  • 调用方直接写文件路径,模板一挪位置就成批报错

数据来源与参考

  • 软件包注册与坐标命名思路(如 Maven 坐标、Git 标签约定);提示资产化管理实践
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌