提示词版本管理与团队协作：建立提示词的Git工作流

---
# 元数据
id: customer-service-chat-bot
version: 2.1.0
author: 张三
reviewers: [李四, 王五]
last_updated: 2026-08-20
status: production  # draft | review | production | deprecated
tags: [customer-service, chatbot, chinese]
model: gpt-5.6-sol
temperature: 0.5
top_p: 0.9
max_tokens: 2000
---

# 客服聊天机器人提示词

## 角色
你是一位专业的客服代表...

## 任务
{task_description}

## 约束
{constraints}

## 变更记录
- v2.1.0 (2026-08-20): 增加多语言支持
- v2.0.0 (2026-08-10): 重构为结构化格式
- v1.0.0 (2026-07-01): 初始版本

# 格式: <type>(<scope>): <description>

# 类型
feat: 新功能（新增提示词或新能力）
fix: 修复（修复提示词问题）
opt: 优化（改进现有提示词效果）
refactor: 重构（结构调整，不改效果）
docs: 文档（更新文档）
test: 测试（新增或修改测试用例）
chore: 杂项（配置、脚本等）

# 示例
feat(customer-service): add multilingual support to chat-bot
fix(coding): correct variable placeholder syntax in code-review
opt(marketing): improve email-campaign open rate with better subject
test(data): add edge cases for analysis prompt

## 提示词审查清单

### 结构检查
- [ ] 有明确的角色定义
- [ ] 任务说明清晰无歧义
- [ ] 输入/输出格式定义完整
- [ ] 约束条件完备
- [ ] 异常处理已定义

### 质量检查
- [ ] 无模糊指令（如"适当""合理"）
- [ ] 无引导性表述
- [ ] Few-shot示例准确
- [ ] 边界条件已覆盖
- [ ] 安全风险已评估

### 兼容性检查
- [ ] 变量占位符格式一致
- [ ] 与现有提示词无冲突
- [ ] 模型参数配置合理
- [ ] 测试用例已更新

### 文档检查
- [ ] 变更记录已更新
- [ ] 使用说明已更新
- [ ] 相关文档已同步
- [ ] 版本号已更新

## PR审查模板

### 变更概述
{一句话描述本次变更}

### 变更原因
{为什么需要这次变更}

### 变更内容
| 文件 | 变更类型 | 说明 |
|------|---------|------|
| prompts/customer-service/chat-bot.md | 新增 | 新增多语言支持 |

### 测试结果
| 测试用例 | 通过 | 说明 |
|---------|------|------|
| TC-001 | ✅ | 中文场景正常 |
| TC-002 | ✅ | 英文场景正常 |
| TC-003 | ✅ | 日文场景正常 |

### 影响评估
- 影响范围：{如：所有客服对话}
- 风险等级：{低/中/高}
- 回滚方案：{如何回滚}

### 审查者
- [ ] 审查者1: {审批意见}
- [ ] 审查者2: {审批意见}

# 变更日志

## [2.1.0] - 2026-08-20

### 新增
- 客服聊天机器人增加多语言支持（中文/英文/日文）
- 新增数据分析提示词模板

### 修复
- 修复代码审查提示词中的变量占位符语法错误

### 优化
- 改进邮件营销提示词的主题行生成质量
- 优化客服提示词的响应速度

### 变更
- 调整编码提示词的temperature从0.5降至0.1

### 废弃
- 旧版客服提示词v1.0标记为deprecated

## 回滚流程

### 情况1：PR未合并
直接关闭PR，无影响。

### 情况2：已合并到develop但未发布
git revert <commit-hash>
git push origin develop

### 情况3：已发布到生产
1. 确认回滚版本号
2. git checkout <previous-version-tag>
3. 运行测试验证
4. 部署到生产
5. 通知相关团队
6. 记录回滚原因

### 回滚决策
- 线上故障 → 立即回滚
- 质量下降 → 评估后回滚
- 小问题 → 可热修复

# configs/dev.yaml
environment: development
model_config:
  model: gpt-5.6-sol
  temperature: 0.7  # 开发环境用高温度测试多样性
  top_p: 0.95
  max_tokens: 2000
rate_limit:
  requests_per_minute: 60
logging:
  level: debug
  save_io: true  # 保存所有输入输出

# configs/staging.yaml
environment: staging
model_config:
  model: gpt-5.6-sol
  temperature: 0.5  # 测试环境用中等温度
  top_p: 0.9
  max_tokens: 2000
rate_limit:
  requests_per_minute: 600
logging:
  level: info
  save_io: true  # 测试环境也保存

# configs/prod.yaml
environment: production
model_config:
  model: gpt-5.6-sol
  temperature: 0.5  # 生产环境用确认的参数
  top_p: 0.9
  max_tokens: 2000
rate_limit:
  requests_per_minute: 6000
logging:
  level: warning
  save_io: false  # 生产环境不保存敏感数据