低效 Prompt 的四大典型症状
- 模糊性：仅给出“帮我写代码”这类无边界需求，导致模型返回通用示例，与业务脱节。
- 上下文缺失：缺少语言、运行环境、输入输出格式，模型只能猜测，结果不可控。
- 角色漂移：多轮对话中未持续强化角色，后续回答风格与首轮差异大，需反复纠偏。
- 过度约束：一次性塞入 2 k tokens 的复杂规则，既消耗额度又降低指令遵循率。
设计模式对比：零样本 vs 单样本 vs 结构化
| 模式 | 平均响应长度 | 业务相关度 | 首轮可用率 | 备注 |
|---|---|---|---|---|
| 零样本 | 312 tokens | 42 % | 28 % | 无示例，自由发挥 |
| 单样本 | 285 tokens | 67 % | 55 % | 给 1 例，模仿格式 |
| 结构化模板 | 198 tokens | 91 % | 84 % | 角色+任务+格式+边界 |
结构化模板在首轮即可把输出压缩到预期格式，显著减少后处理代码。
零样本与单样本在多轮场景下易出现“幻觉”累积，而结构化模板通过持续注入 system prompt 可将幻觉率压到 5 % 以下。
可立即复用的 5 组高效模板
以下示例均基于 OpenAI Python SDK ≥ 1.0，默认模型 gpt-3.5-turbo；如用 gpt-4 只需替换 model 参数。
模板 1：函数注释生成器
import openai, textwrap openai.api_key = "sk-xxx" def generate_docstring(code: str) -> str: prompt = f""" Role: 你是一名资深 Python 代码审查员。 Task: 为下方代码生成 Google Style 的 docstring，要求包含 Args、Returns、Raises。 Constraints: - 仅返回 docstring，不要附带任何解释。 - 保持缩进 4 空格。 Code: {textwrap.indent(code, ' ')} """ resp = openai.chat.completions.create( model="gpt-3.5-turbo", messages=[{"role": "user", "content": prompt}], temperature=0.2, max_tokens=400 ) return resp.choices[0].message.content.strip()模板 2：SQL 自然语言转写
def nl_to_sql(schema: str, question: str) -> str: prompt = f""" 数据库 schema: {schema} 用户问题: {question} 要求: 1. 仅输出可执行 SQL，以分号结尾。 2. 使用标准 SQL，不支持窗口函数时可退而求其次。 3. 禁止 SELECT *。 """ resp = openai.chat.completions.create( model="gpt-3.5-turbo", messages=[{"role": "user", "content": prompt}], temperature=0 ) return resp.choices[0].message.content.strip()模板 3：Commit Message 生成器
def generate_commit(diff: str) -> str: prompt = f""" 根据下方 git diff 生成符合 Conventional Commits 规范的提交说明。 格式: <type>(<scope>): <subject> Diff: {diff} """ resp = openai.chat.completions.create( model="gpt-3.5-turbo", messages=[{"role": "user", "content": prompt}], temperature=0.1, max_tokens=60 ) return resp.choices[0].message.content.strip()模板 4：单元测试用例批量产出
def gen_unittest(source: str, test_framework: str = "pytest") -> str: prompt = f""" 为以下 Python 函数编写 {test_framework} 单元测试。 要求: - 覆盖正常、异常、边界三种场景。 - 使用 arrange-act-assert 注释。 - 仅输出代码，不解释。 Source: {source} """ resp = openai.chat.completions.create( model="gpt-3.5-turbo", messages=[{"role": "user", "content": prompt}], temperature=0.3, max_tokens=800 ) return resp.choices[0].message.content.strip()模板 5：多语言错误消息本地化
def localize_error(error_en: str, locale: str = "zh-CN") -> str: prompt = f""" 将下方英文错误消息翻译为 {locale}，保持技术术语准确，语气友好。 仅返回译文。 Error: {error_en} """ resp = openai.chat.completions.create( model="gpt-3.5-turbo", messages=[{"role": "user", "content": prompt}], temperature=0 ) return resp.choices[0].message.content.strip()优化前后效果对比（100 次随机采样）
| 指标 | 优化前（零样本） | 优化后（结构化模板） | 提升 |
|---|---|---|---|
| 首轮格式合规率 | 34 % | 89 % | +162 % |
| 平均重试次数 | 2.7 | 0.4 | −85 % |
| Token 消耗/次 | 412 | 268 | −35 % |
| 端到端延迟 | 1.8 s | 1.2 s | −33 % |
测试环境：gpt-3.5-turbo-0125，温度 0.2，最大输出 512 tokens，局域网调用。
生产环境避坑要点
- 敏感词过滤：在输入侧先过一遍正则+本地敏感词库，命中则直接拒绝，节省额度。
- 超时重试：openai 默认 600 s 超时，建议设置 10 s 读秒 + 2 次退避，防止阻塞 API 网关。
- 长度截断：输入 > 4 k 时先摘要再提问，避免“中途断句”导致输出残缺。
- 温度锁定：生产环境关闭 temperature 随机，固定 seed 可让结果可回归，方便灰度比对。
- 版本冻结：模型别名映射到具体快照（如 gpt-3.5-turbo-0125），防止官方升级后行为漂移。
- 日志脱敏：记录前用占位符替换邮箱、密钥，满足审计同时降低泄露风险。
开放性问题
当业务场景从“代码生成”切换到“在线客服”或“医疗问诊”时，模板应如何动态调整角色、知识边界与安全护栏？欢迎读者在评论区贴出自己设计的 Prompt 并给出 A/B 测试数据，一起探讨多角色、多轮、多语言场景下的最优结构。
—— 如果你觉得动手搭一套“能听会说”的 AI 更有挑战，不妨体验从0打造个人豆包实时通话AI实验，把刚学会的 Prompt 工程直接塞进语音闭环，亲测一小时即可跑通 ASR+LLM+TTS 全链路。
