新同事能否只读目录与元数据就知道「哪份在生效、为什么这么写」？
提示词散落，是团队的隐性负债
提示词一多，就会出现典型症状 ✗：同一个功能有三份"差不多"的模板 ✔、
没人知道哪份在生效 ✔、改了一处忘了另一处 ✔、新同事复制了一份过期的 ✔。
把提示词做成"可复用资产" ✔：目录化、命名规范、带元数据 ✔。
一、目录结构（按"用途"而不是按"人"）
```
prompts/
answer/ 回答类
v3.txt 模板正文
v3.meta.json 版本、作者、目标评测集、变更说明
extract/ 抽取类
summarize/ 摘要类
classify/ 分类类
shared/ 共享片段（语气、安全约束、格式约定）
CHANGELOG.md 人写的变更历史
```
要点：shared/ 很重要 ✗→✔ —— 把"安全约束、输出格式、术语表"等共用片段抽出来 ✔，
避免每个模板各写一份 ✔（那样改一处就要改十处 ✔）。
二、命名规范（让人一眼看懂）
```
<用途>.<语言>.<版本>.txt 例如 answer.zh.v3.txt
```
反例 ✗：prompt_final_v2_new.txt ✔、张三的提示词.txt ✔ ——
没有用途、没有版本、没有归属 ✔。
三、元数据里必须有五项
```
① 用途（做什么、不做什么 ✔）
② 目标模型与参数（温度、上限 ✔）
③ 目标评测集（用哪批样本验收 ✔）
④ 变更说明（动机、证据、回滚方式 ✔ —— 见变更说明那篇 ✔）
⑤ 负责人（谁维护 ✔）
```
第 ③ 项最常被省 ✗ —— 没有它，改动就只能靠感觉验收 ✔。
四、三点纪律
1. 模板里不写分支 ✗（"如果 X 就 Y" 放代码 ✔，模板保持可读 ✔）；
2. 变量用占位符（{{var}} ✔ 而不是拼字符串 ✔）；
3. 提示词改动走四道关 ✔（见提示词流水线那篇 ✔）。
五、复用怎么发生
· 共享片段引用（在模板里用 include 语法 ✔ —— 由组装器展开 ✔）；
· 按场景组合（shared/安全约束 + extract + shared/输出格式 ✔ —— 见可组装上下文那篇 ✔）；
· 禁用复制粘贴 ✗（复制出去的那份不会被更新 ✔）。
一条判据
> 新同事第一天 ✔，能否只读目录与元数据就找到"某个功能正在用哪份提示词、为什么这么写" ✔？
> 不能，说明提示词还是散落的文本，不是资产 ✗。
本文由云枢 AI导航整理，内容以官方来源为准。
相关文章
顺序阅读
← 上一篇：AI 功能的季度体检：八项检查与一份短文档
下一篇：AI 输出的可读性：结构、长度与重点 →
第 127 / 171 篇