模板注册表是什么
模板注册表把所有提示模板集中登记、按标识引用,避免模板散落在各处代码与文档里各自分叉。登记项包含用途、变量、状态、负责人与回归用例,调用方只写标识不写路径。名字体现领域与任务,并带版本与状态,找起来和评影响面都不靠记忆。
基本信息
| 命名 | 领域.任务.版本三段式,版本与仓库标签一致 |
|---|---|
| 状态机 | candidate 试验到 stable 稳定,退场标 deprecated |
| 引用方式 | 调用方只引用标识,不硬编码文件路径 |
| 登记字段 | 用途、变量、负责人、回归用例、最近验证时间 |
| 维护 | 废弃条目标注并设下线期限,调用方收到迁移通知 |
典型使用场景
- 新项目选模板:按领域与任务检索,避免重复造一份相似模板
- 评估改动影响:改公共模板前按注册表查全部引用方
- 权限与审计:注册表说明每个模板由谁负责,问题有人承接
- 清理技术债:把长期无人引用的模板标记废弃并下线
- 对外交付:给客户看登记表就能说明模板清单与版本状态
注册表条目示例
注册表条目示例
id: summarize.meeting.v3
用途: 会议纪要摘要
负责人: ops-team
变量: transcript, max_points?
状态: stable
回归: eval-meeting-v2(通过率 96%)
最近验证: 2026-10-01
# 调用方只写 summarize.meeting,主版本由注册表解析登记字段与作用
| 字段 | 作用 | 缺失后果 |
|---|---|---|
| 用途 | 检索与选型 | 只能靠翻文件找模板 |
| 变量 | 渲染校验与调用约定 | 调用方传错参数直到线上才发现 |
| 状态 | 区分试验与稳定 | 误用未验证的模板 |
| 负责人 | 问题承接与审批 | 改动无人拍板 |
| 回归用例 | 变更前验证依据 | 改完不知道是否变差 |
注册表要尽量由流水线自动生成或校验:手工维护的清单会在两三次迭代后与仓库实际状态脱节。
引用计数是注册表最实用的字段之一:长期零引用的模板优先考虑下线,而不是继续为它维护变量与回归用例。