版本管理中最关键的原则，和工具无关：一旦某个 prompt 版本发布到生产，永远不能修改它。哪怕是改个错别字，也要创建新版本。说起来，

This may sound extreme,but rationale is clear:

• If your trace ID cannot map to a specific prompt text。your observability stack is meaningless.
• You cannot answer “What exact prompt was running when that incident happened?”.

The correct mental model is an "immutable artifact".

从prompt来看，customer-service-v1. → immutable,permanently exists
prompt这方面。customer-service-v1. → new immutable version
production pointer → points to v1
...
rollback = change pointer from v1 back to v1.
Old versions always exist and can be restored instantly.

回滚 = 把指针从 v1 改回 v1.

• 旧版本永远在可随时恢复；秒级生效.

SemVer for Prompts：给 Prompt 变更定级

The software engineering community has long solved “how severe is this change?” communication problem—SemVer . It applies equally well to prompts but requires redefining what “breaking” means:

方案一的观点是，纯 Git 方案

目录结构示例

prompts/
├── customer-service/
│ ├── v1/
│ │ ├── system.txt
│ │ ├── user-template.txt
│ │ └── metadata.json
│ ├── v2/
│ │ ├── system.txt
│ │ ├── user-template.txt
│ │ └── metadata.json
│ └── production.json # 指向当前生产版本
├── code-review/
│   └── …└── CHANGELOG.md
`metadata.json` 示例：
json
{
"version": "v1","created_at": "2024-01-01T10:00Z"。"author": "","model": "deepseek-v3","description": "添加电商退款场景处理规则，并修复复杂订单号识别问题。","breaking_changes": false,"eval_score": null,"eval_baseline": null
}
`production.json`：
json
{
"production": "v1","staging": "v1","dev": "v1","last_updated":"2024-08-08T14:00Z","updated_by":"ci-bot"
}

运行时加载


import json,jsonschema,jsonschema.exceptions.SchemaError
from pathlib import Path
from datetime import datetime
class GitPromptLoader:
def __init__:
self.root = Path
def load:
"""加载指定 Prompt 的当前生产版本"""
pointer_file = self.root / name / 'production.json'
pointer = json.loads)
version = pointer
# 验证 JSON schema 可选
说到try。jsonschema.validate
except SchemaError as e:
raise RuntimeError
version_dir=self.root/name/version
return {
'system':.read_text,'user_template':.read_text,'metadata':json.loads.read_text),'version':version,}
def rollback:
"""回滚到指定版本"""
pointer_file=self.root/name/'production.json'
pointer=json.loads)
old_version=pointer
pointer=target_version
pointer=datetime.utcnow.isoformat+"Z"
pointer_file.write_text)
print
loader = GitPromptLoader
prompt_info = loader.load
print

PR 模板用于代码审查和自动化检查

markdown

Prompt 名称
customer-service

变更类型
MAJOR
MINOR
PATCH

变更描述
修复识别带连字符订单号时格式问题。

Eval 对比