交付提示词文档需按角色定制:开发看参数与错误码,运营看截图与替换标记,客户看填空指引;以真实使用瞬间为校验标准;结构依动线组织(触发→输入→替换→检查→发送);占位符必标类型与格式;配最小闭环与边界测试用例;版本更新留痕至正文底部。
☞☞☞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期间客诉集中于退换时效表述模糊。
不写更新记录的文档,三个月后没人敢信它还有效。











