提示词工程 编辑复核

提示词版本变更记录

记录提示词每次改动的原因、影响、测试结果和回滚方式,让模板可以长期维护。

场景:团队提示词库、生产模板和模型升级输出:变更日志 + 影响表 + 回滚信息更新于 2026-08-03

复制后替换变量

保留结构,先填真实信息,再把结果交给模型运行。

你是一名提示词版本管理员。请把一次提示词改动写成可追溯的版本记录,区分意图、实际变化、测试证据和未验证风险。

先区分已知事实、合理假设和待核验信息;没有依据的内容写“待验证”,不要为了完整而猜测。

请按以下结构输出:
1. 版本、日期、作者和变更原因
2. 具体改动:角色、约束、变量或输出格式
3. 受影响用户、任务和兼容性
4. 回归测试、失败样例和待观察指标
5. 回滚版本、触发条件和后续计划

输入变量:
- 旧版本({{before}}):提供旧提示词和版本号。
- 新版本({{after}}):提供新提示词和版本号。
- 改动原因({{reason}}):说明真实失败样例或需求。
- 测试结果({{tests}}):提供回归样本和结果摘要。

约束:保留用户的真实语气和业务边界;把事实、推断与建议分开;涉及日期、价格、版本、法规或安全的内容写明来源和采集时间。

使用说明

  1. 变更记录绑定失败样例和测试结果,不只写“优化效果更好”。
  2. 生产模板保留可部署的旧版本。

适用判断

适合这些情况

  • 提示词会持续迭代,需要记录改了什么。
  • 出问题时要能回溯是哪次改动引入的。
  • 多人协作,需要让他人知道版本差异。

换个做法更好

  • 提示词在版本控制里:diff 已经记录了改动。
  • 只改过一次:不需要变更记录。
  • 你要的是优化建议:用《提示词优化器》。

常见翻车与修正

  • 变更记录只写「优化了提示词」,回溯时毫无帮助。

    要求每条记录写清改了哪部分、为什么改、预期影响什么,能对应到具体位置。

  • 记录里没写这次改动的验证情况。

    要求每个版本标注在哪些用例上验证过、结果如何,未验证的明确标出。

  • 破坏性改动没有标注,下游调用方毫无预警地失效。

    要求单独标出改变输出格式或行为的改动,并说明下游需要做什么调整。

怎么判断输出合格

  1. 每条记录写清改了什么、为什么、影响什么。
  2. 标注了验证情况,未验证的有说明。
  3. 破坏性改动单独标出,附下游调整说明。
  4. 版本之间可以看出演进脉络。

使用边界

  • 变更记录里不要写入密钥和内部系统细节,提示词库常与代码一起分发。
  • 破坏性变更必须显著标注,下游调用方看不到警告就会在升级后静默出错。