什么是Prompt库？
📍 In One Sentence
Prompt库是一个共享的、受版本控制的、可搜索的Prompt仓库，团队可以随时间发现、重用和改进。
💬 In Plain Terms
把Prompt库想象成AI指令的代码库：所有内容都有命名、版本控制、可发现，并在投入生产前经过审查。
Prompt库是一个共享的、受版本控制的Prompt集合，团队可以随时间搜索、重用和改进。 它解决了三个问题：发现性（找到已经满足需求的Prompt）、重复（两次编写相同的Prompt）以及质量基线（确保所有Prompt在共享前满足最低标准）。
没有库，Prompt存在于个人笔记、Slack消息和ChatGPT历史中——团队无法访问、未受版本控制，当有人离开时丢失。
当3人或以上定期编写Prompt、团队在积极使用20种或以上不同Prompt，或者注意到同一Prompt因为没人能找到之前的版本而被重新创建时，构建Prompt库。
📌 何时构建
构建库的触发因素不是规模——而是当Prompt重新创建开始发生时。如果团队成员曾经说过"我认为我们已经有了这个Prompt"，就是构建库的时候了。
文件夹结构和命名规范
**对所有Prompt文件使用 `/prompts/主题/标识符-v版本.扩展名` 的模式。** 这种结构允许按主题过滤、按版本排序，并一目了然地识别格式。
命名规则：仅小写字母，用连字符代替空格，无特殊字符。在文件名中包含版本后缀（`-v1`、`-v2`），这样无需打开版本控制日志就能在文件列表中看到版本历史。
⚠️ 永远不要使用这些名称
永远不要在文件名中使用"最新"、"最终"、"新"或"副本"作为版本标识符。这些标识符立即变得毫无意义，使版本历史无法阅读。
Prompt库的版本控制策略
使用Git标签标记Prompt的生产版本：当该版本部署到生产环境时打标签 `prompt/ticket-triage/v2`。 这使回滚具有确定性。
对于并发编辑，遵循与代码相同的分支策略：创建功能分支，打开拉取请求，获得审查，然后合并。永远不要直接在 `main` 上编辑Prompt。
PromptHub为需要评论线程、审批复选框和基于角色访问的团队提供结构化审查工作流，无需手动管理Git分支。
访问控制和所有权
三角色模型适合大多数团队：贡献者（可以添加）、所有者/审查者（可以修改）、审批者（可以部署到生产环境）。 合并这些角色是共享库中Prompt回归的主要原因。
在Git中实现：在 `main` 上设置分支保护规则，要求合并前有1个审查批准。分配一个CODEOWNERS文件，将每个Prompt文件夹映射到特定的审查者。
每个Prompt应该有一个指定的所有者，负责保持Prompt更新、分类问题并决定何时弃用。
💡 所有权转移
将Prompt所有权重新分配添加到团队离职清单中。没有所有者的孤立Prompt会静默降级——直到下游系统失败才会有人注意到。
审查和弃用工作流
每季度对Prompt库进行审查：检查使用指标、评估当前版本是否仍满足质量标准，并识别准备弃用的Prompt。 90天内没有人使用的Prompt是维护负担，而非资产。
弃用Prompt的标准：过去90天没有使用；更好的版本已取代它；其编写和测试的模型不再在生产环境中使用。如果这三项中有两项适用，则弃用。
弃用流程：(1) 在Prompt前置数据中添加 `status: deprecated`，(2) 将文件移至 `/prompts/deprecated/`，(3) 如果存在替代Prompt则添加指向它的注释，(4) 在deprecated文件夹中至少保留1年。如果没有回滚请求，1年后删除。
Prompt库管理中的常见错误
❌ 没有主题组织的平面文件夹结构
Why it hurts: 有20个以上Prompt时，文件变得不可搜索，团队成员因为找不到现有Prompt而重复工作
Fix: 按主题组织Prompt：/prompts/主题/标识符-vN.txt。每个主题文件夹最多20个Prompt。
❌ Prompt文件没有命名规范
Why it hurts: 命名为"prompt1.txt"、"final.txt"的文件无法被程序化地发现或比较
Fix: 使用格式：标识符-v主要.次要.txt。示例：classify-intent-v2.1.txt。永远不要使用"final"、"copy"或"new"。
❌ 没有弃用流程
Why it hurts: 旧Prompt积累，团队成员在不知情的情况下使用已过时的版本
Fix: 为每个文件夹添加DEPRECATED.md，列出已弃用标识符、弃用日期和替代标识符。
❌ 生产Prompt没有访问控制
Why it hurts: 任何团队成员都可以在没有审查的情况下修改生产Prompt，导致静默质量回归
Fix: 添加分支保护规则：对/prompts/production/的任何更改都需要PR审查 + CI/CD通过。
关键要点
- Prompt库解决发现性、重复和质量基线问题——当3人以上编写Prompt或20个以上Prompt在积极使用时构建
- 文件夹结构：/prompts/主题/标识符-v版本.扩展名——小写、连字符、文件名中包含版本
- Git：标记生产版本，使用功能分支，合并到main前需要PR审查
- PromptHub：用于带评论线程和基于角色审批的结构化审查工作流
- 三种访问角色：贡献者（添加）、所有者/审查者（修改）、审批者（部署到生产环境）
- 弃用90天无使用的Prompt；归档并保留1年后再删除
常见问题
什么是Prompt库？
Prompt库是一个共享的、受版本控制的仓库，团队在其中存储、搜索和重用Prompt。它包括按主题组织的文件夹结构、版本控制文件和访问控制规则。
3人团队的最小结构是什么？
Git仓库中的/prompts/目录、按主题的文件夹（最多5个）、命名规范和每个文件夹的README.md。设置时间不到30分钟。
如何在Git库中搜索？
使用grep -r "关键词" /prompts/按内容搜索。为每个文件添加YAML元数据。对于较大的库，使用PromptHub的搜索。
何时使用PromptHub vs Git？
如果团队主要是开发者并希望在GitHub PR中审查，使用Git。如果团队包含非开发者或需要发现和比较的UI，使用PromptHub。