| 主版本 | 输出字段、格式等不兼容变更，下游必须适配 |
|---|---|
| 次版本 | 行为与效果改进，契约保持兼容 |
| 修订号 | 措辞、错字与注释类微调 |
版本与兼容示例
版本与兼容示例
1.x：输出契约稳定（字段名、类型、误差口径）
2.0.0：输出由文本改为 JSON，下游需适配
调用方约束：summarize >=1.2 <2.0
升级流程：候选版本 → 灰度 5% → 指标对比 → 全量本包目录（290 条）
提示词基础40 条模式与框架50 条任务型写法50 条评估与迭代50 条提示注入与防护50 条
工程化实践50 条
- 提示模板的占位符设计
- 上下文窗口的使用规划
- 提示即代码：纳入仓库管理
- 模型与 SDK 版本固定
- token 预算与分配
- OpenTelemetry GenAI 语义约定
- 生成延迟的分解度量
- 线上质量抽检
- 模板变量注入与默认值
- 提示灰度发布与回滚
- 配置外置与环境差异
- 提示与密钥分离管理
- 多轮对话的滚动摘要
- 上下文排序与位置效应
- 提示缓存的概念与收益
- 重试与指数退避
- 模型不可用时的降级
- 流式输出处理
- 请求追踪与回放调试
- 成本归因与预算告警
- 日志与数据脱敏
- 模板渲染的转义与安全
- 提示变更评审清单
- 提示版本号与兼容策略
- 功能开关与实验分流
- 开发与生产环境隔离
- 分词器与 token 估算
- 会话记忆与实体表
- 会话隔离与并发
- 超时与取消设计
- 限流与配额处理
- 批量任务的部分失败处理
- 响应缓存与语义缓存
- 长任务的异步化
- 审计日志字段设计
- 用户反馈收集与回流
- LLM 功能的值班手册
- 模板注册表与命名规范
- 提示变更记录的写法
- 提示资产目录与元数据
- 历史截断策略对比
- 调用幂等性设计
- 回退链设计
- 并发控制与排队
- 数据保留与清理策略
- 依赖固定与升级窗口
- 模板片段复用与组合
- 提示静态检查规则
- 配置优先级与覆盖规则
- 会话恢复与持久化
提示版本号与兼容策略
用语义化版本管理提示：输出契约不兼容变更升主版本，行为改进升次版本，措辞微调升修订号；下游按范围锁定主版本。
易错点
- 行为大改却只升修订号，版本号失去信号意义
- 下游不做版本范围约束，提示更新引发解析故障
数据来源与参考
- Semantic Versioning 2.0.0 规范（应用于提示资产管理）