交付提示词文档需按角色定制：开发看参数与错误码，运营看截图与替换标记，客户看填空指引；以真实使用瞬间为校验标准；结构依动线组织（触发→输入→替换→检查→发送）；占位符必标类型与格式；配最小闭环与边界测试用例；版本更新留痕至正文底部。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

写一份能交付的提示词文档，核心是让接手的人不问问题就能直接用、改得明白、查得清楚，不是堆砌文字而是构建可执行的知识结构。

明确交付对象和使用场景

第一步：确认这份文档给谁用——是给开发同事接入API？给运营同事每天复制粘贴发消息？还是给客户自己填空调用？【不同角色需要的信息粒度完全不同，写给开发看的必须带参数说明和错误码，写给运营看的必须有示例截图和替换标记】。

第二步：写下三个真实会发生的使用瞬间。例如：“客服小王在下午3点收到新客咨询，打开文档复制第2节模板，把‘{客户姓名}’替换成张伟，发送前检查是否漏掉‘优惠截止时间’字段”。这种具体画面能立刻筛掉冗余描述。

结构按“动线”而非“逻辑”组织

方法一：从触发动作开始排布（推荐给一线使用者）
打开文档→找到对应业务类型（如“生成商品详情页”）→核对输入要求（需提供SKU、卖点列表、目标人群）→复制基础模板→粘贴到编辑器→替换花括号内占位符→检查输出长度是否超限→点击发送。

方法二：按调试流程分层（适合技术对接）
① 原始提示词（未优化版，带注释说明每行作用）
② 约束条件清单（如“禁用emoji”“必须含且仅含1个问句”“数字统一用阿拉伯字”）
③ 典型失败案例+修复对比（左栏是AI跑偏输出，右栏标红修改点）。

占位符和变量必须带类型与示例

所有{xxx}都要标注类型，比如{产品名称}【字符串，≤15字，不可含促销符号】；{折扣率}【数字，0.7–0.95之间，保留两位小数】。

这一步漏写类型，下游使用者一定会填错。有人把“{截止日期}”理解成“2024-06-30”，有人写成“6月30号”，还有人填“下周三”——文档里没定义格式，就是埋雷。

附上可验证的测试用例

方法一：最小闭环测试集
输入：“{品牌}=小米，{功能}=快充，{价格}=199” → 期望输出首句含“小米”且出现“199元起”，不含“旗舰”“顶级”等过度修饰词。

方法二：边界值暴力测试
输入{用户年龄}=0 → 输出应拒绝并提示“请输入1–120之间的整数”；
输入{用户年龄}=121 → 同样触发拒绝提示。
【没过这个测试的提示词，上线后必然被异常输入打穿】

版本与更新留痕写进正文底部

最后加一行固定格式：v2.3｜2024-06-28｜新增「售后话术」模块｜修改人：李明｜变更原因：618期间客诉集中于退换时效表述模糊。

不写更新记录的文档，三个月后没人敢信它还有效。