二、模板库设计原则：模块化、可复用、可扩展与版本管理

好，咱们接着聊。上一章我们讲了为什么要建模板库，这一章我重点说说——怎么建才靠谱。

说白了，模板库不是把一堆 Prompt 扔进文件夹就完事了。我见过太多人，刚开始热情高涨，攒了上百个模板，三个月后自己都找不到哪个是哪个。嗯，这就是没有设计原则的后果。

我个人习惯，在设计模板库之前，先想清楚四个核心原则：模块化、可复用性、可扩展性、版本管理。这四个词，你记住了，模板库至少能用三年不重构。

2.1 模块化设计：拆得开，拼得上

什么叫模块化？我举个例子你就明白了。

你写一个「产品文案生成」的 Prompt，如果把它写成一个 500 字的巨无霸，里面包含了产品描述、目标用户、卖点提炼、竞品分析、SEO 关键词……那这个模板基本废了。为什么？因为下次你只想生成一个标题，也得带着这 500 字一起跑。

模块化的思路是：把 Prompt 拆成最小功能单元。

我一般把模板库分成三层：

• 原子模块：最基础的指令单元。比如「角色设定模块」、「输出格式模块」、「约束条件模块」。每个模块 50-100 字，独立成文件。
• 组合模块：把几个原子模块拼起来，形成特定场景的模板。比如「小红书种草文案 = 角色设定 + 产品描述 + 情感化表达 + 话题标签」。
• 完整模板：直接可用的 Prompt，包含所有必要模块，用户拿来就能用。

我在项目中遇到过最典型的反面案例：团队里有人把整个营销方案的 Prompt 写成了一个 2000 字的怪物。后来需求变了，要加一个「竞品对比」模块，结果改一处崩三处。最后重写了整个模板。

所以我的建议是：先拆后合。哪怕你一开始觉得麻烦，也要坚持模块化。相信我，后期维护的时候你会感谢自己的。

2.2 可复用性：一次编写，到处使用

可复用性，说白了就是「别重复造轮子」。

你想想看，你的模板库里是不是经常出现这样的场景：

• 「角色设定」模块，在 10 个模板里写了 10 遍
• 「输出格式要求」几乎一模一样，但每个模板都重新写了一遍
• 「语气风格」的描述，改了 A 忘了 B

这就是复用性没做好。

我建议的做法是：建立公共模块库。

比如，我自己的模板库里有一个 common/ 文件夹，里面放了这些：

common/
├── role_expert.md          # 专家角色设定
├── role_writer.md          # 写手角色设定
├── format_markdown.md      # Markdown 输出格式
├── format_json.md          # JSON 输出格式
├── constraint_length.md    # 字数约束
├── constraint_tone.md      # 语气风格约束
└── quality_checklist.md    # 质量检查清单

每个完整模板在开头引用这些公共模块，而不是重新写一遍。怎么引用？我习惯用注释标记：

<!-- 引用公共模块：角色设定 -->
<!-- 引用公共模块：Markdown 输出格式 -->
<!-- 引用公共模块：字数约束（800字以内） -->

[正文内容开始...]

这样做的好处很明显：

• 改一处，所有模板都生效
• 新模板搭建速度提升 50% 以上
• 质量更稳定，不容易遗漏关键约束

2.3 可扩展性：给未来留个接口

这一点，说实话，是我踩坑踩出来的经验。

我曾经给一个项目设计了一套模板库，当时觉得完美无缺。结果三个月后，业务方说要支持多语言，又过了两个月，说要接入新的 AI 模型……我的模板库直接崩了，因为当初根本没考虑扩展。

可扩展性，核心就一句话：别把路堵死。

具体怎么做？我总结了三个要点：

1. 预留变量插槽：在模板里用 {{变量名}} 标记可替换的部分。比如 {{产品名称}}、{{目标用户}}、{{输出语言}}。这样未来加新变量，直接加插槽就行，不用改模板结构。
2. 分层设计：基础层（原子模块）不动，业务层（组合模板）可以灵活增删。我见过最糟糕的设计是把业务逻辑写死在基础模块里，那扩展性基本为零。
3. 预留「钩子」：在模板的关键位置留一个 <!-- 扩展点 --> 注释。比如在「输出格式」模块后面留一个扩展点，未来要加「多轮对话历史」或者「上下文记忆」，直接插在这里就行。

2.4 版本管理：别让你的模板「回不去了」

嗯，这一点我要重点说。因为我曾经犯过一个低级错误。

有一次，我优化了一个用了半年的模板，觉得改得特别好。结果上线后，效果反而变差了。我想回退到旧版本，但旧版本已经被覆盖了……最后花了整整两天重新调参，才找回原来的效果。

从那以后，我对版本管理有了执念。

我的做法很简单，但很有效：

版本号	命名规则	说明
主版本	v1.0, v2.0	重大重构，不兼容旧版本
次版本	v1.1, v1.2	新增功能，兼容旧版本
修订版本	v1.1.1, v1.1.2	小修小改，比如调参数、改措辞

每个模板文件头部，我都会加一个版本信息块：

---
name: 小红书种草文案模板
version: v2.1.0
author: 你的名字
last_modified: 2024-03-15
changelog: |
  v2.1.0 - 新增「情感化表达」模块
  v2.0.0 - 重构输出格式，支持多平台适配
  v1.0.0 - 初始版本
---

另外，我强烈建议用 Git 管理模板库。别觉得小题大做，Prompt 模板也是代码，值得用代码的方式管理。

2.5 四个原则的关系，一张图说清楚

最后，我帮你理一下这四个原则的关系：

• 模块化是地基——拆得够细，后面才能灵活组合
• 可复用性是效率——别重复劳动，让模块一次编写多次使用
• 可扩展性是未来——留好接口，别让模板库变成死库
• 版本管理是保险——出了事能回退，改了东西有记录

这四个原则，缺一不可。我见过太多模板库，要么只做了模块化但没做版本管理，结果改着改着就乱了；要么版本管理做得很好但模块化不够，每次复用都要手动改一大段。

嗯，这一章的内容就到这。下一章我会讲具体的模板库目录结构设计，包括怎么命名、怎么分类、怎么组织文件。到时候我会把我自己的模板库目录结构直接贴出来，你照着抄都行。

记住：好的设计，是为了让你以后少加班。