SH

Soloharness

概念 · 辨析 · Agent

← 返回概念辨析

Concept Contrast Fable

提示词管理和提示版本管理:一个管流程,一个管历史

团队讨论提示词工程时经常把管理和版本管理当成一码事——反正都是管提示词。管理回答谁能改、谁来审、怎么上线;版本管理回答某个版本长什么样、什么时候改过、能不能回退。两件事共用同一组文件,但管的是两本账。

寓言

编辑部的两本总账

一家报社的编辑部每天要出十几条标题和导语。早年只有一位老编辑统管全局,他拿一本大本子,左边写今天用的标题,右边标注谁改的、几时改的。到了月底,总能翻出几条标题和上周不一样但没人知道什么时候变的。

报社扩版之后招了四位年轻编辑,大本子变成了共享文档。四个人同时编辑一个标题区域,你改一半我改回来,标题在一天之内来回变五次。主编想要审稿时发现标题已经被人覆盖了三次,连初审时写的是什么都找不到。

总编室索性把本子拆成了两本。第一本叫作业日志,记录每一版标题是谁起草的、谁审核的、谁签署上版的,管的是一条标题从想法到见报的流程。第二本叫修订记录,只记录标题内容逐次变动的快照,不关心是谁批的。

元旦特刊出过一次事。一篇评论的标题在见报前被主编临时改了一句,但主编改完忘了通知排版组。排版组用的还是上一版标题。第二天读者发现纸版和电子版标题不一致,投诉涌进热线。查作业日志,主编的签署记录在案;查修订记录,排版组拿到的快照比签署版早了两个小时。

事后复盘,两本账都没写错——作业日志记录了谁批了哪一版,修订记录如实存下了每个版本的内容。问题是两本账之间没有关联记号:没有人记录主编签署时到底指向哪一条修订快照。作业日志里签了字,但签字对不上任何一个修订时间戳。

报社后来在两个系统之间加了一根线:每次签署时,作业日志自动记录对应的修订快照编号。从此排查标题事故,先看作业日志找到签署决策,再跳转到修订记录确认签发的是哪个内容。两本账各记各的,但线头连着。

年终盘点时,总编在总结里写下一句:流程管的是人的动作和决策节点,历史管的是内容状态的时间序列。两份记录可以存在同一套工具里,但别指望一份记录同时回答谁同意的和内容什么时候变成这样的。这两件事的查询方向是正交的。

提示词管理

围绕提示词的协作流程:谁起草、谁审核、谁发布、如何从开发环境推进到生产环境。管的是一群人的动作和决策。

提示版本管理

对提示词内容变化的追踪:每次修改的快照、版本号、时间戳和差异对比。管的是内容状态的时间序列。

故事对应

  • 作业日志记录谁起草谁审核谁签署:提示词管理,管人的协作流程
  • 修订记录存下每次内容变动的快照:提示版本管理,管内容的时间序列
  • 两本账没关联导致标题事故:管理和版本系统缺乏联动时的典型故障
  • 签署时自动记录修订快照编号:管理动作与版本快照通过标识关联
  • 查事故时先看作业日志再跳修订记录:排查思路——先定位流程节点再查状态

落到 Agent 项目里

提示词管理工具和版本管理工具可以选同一个平台,但内部要拆成两个视图。管理视图回答:当前生产环境跑的是哪个版本、谁审批的、下次评审什么时候。版本视图回答:上一版内容是什么、什么时间改了什么、diff 在哪些行。评测或排障时先走管理视图定位决策链,再切版本视图对比内容差异。