自定义提示词变量不生效时，先查看“实际发给 AI 的内容”预览，不要直接反复生成。如果预览里变量仍是占位符、内容为空或位置错乱，问题发生在模板替换阶段；如果预览正确但结果没有遵循要求，才需要调整提示词结构。用一条极短、特征明显的测试输入逐个验证变量，效率最高。
先做最小测试
新建一个只含两个变量的测试模板，例如“标题”和“原文”。标题填“变量测试甲”，原文填“只保留这句话乙”，然后观察实际发送内容。特征词甲、乙都出现且位置正确，说明替换正常；缺少其中一个，就检查变量是否创建、名称是否完全一致以及输入框是否确实填写。
变量名应简短且含义唯一，避免同时使用“内容”“正文”“原文内容”等相近名称。团队模板最好统一命名规则，并说明每个变量是否必填、允许的格式和最大长度。修改变量名后，模板正文中的旧占位符也要同步更新。
根据预览结果分流排查
预览中变量没有替换
检查占位符的括号、空格、大小写和全半角符号，不要凭肉眼认为“差不多”。从变量列表重新插入占位符，比手工输入更可靠。确认模板已保存为当前版本，避免打开旧标签页继续测试。
预览正确但结果忽略变量
把核心任务放在提示词前部，明确输入边界与输出格式。例如先说明“仅依据给定原文”，再列出不可改项，最后提供原文。若变量内容很长，重要规则不要埋在末尾。不要同时要求“完全保留原意”和“自由补充更多事实”，冲突指令会造成不稳定。
变量互相串位
为每段增加清晰标签，如“【目标平台】”“【原始材料】”“【输出要求】”，并在预览中确认边界。用户输入也可能包含与占位符相似的符号，测试时先用纯文本排除干扰。
按顺序增加复杂度
最小测试通过后，每次只增加一个变量：先平台和受众，再风格与长度，最后才加入复杂的条件分支。每增加一次都保留测试结果。一次加入十几个变量，失败后很难判断是替换问题、输入缺失还是指令冲突。
模板列表可用于管理不同用途的版本。不要直接覆盖正在使用的稳定模板，可复制后标注日期和用途，测试完成再替换。导入或共享模板后，仍要核对变量定义，因为对方的输入约定未必与你一致。
常见故障清单
- 结果带出上一次内容：确认当前输入框和实际预览，必要时新建任务测试，不要只看历史记录。
- 某个可选变量为空后句子断裂：把相关提示写成完整条件，或为空时不要求引用该段。
- 输出格式不稳定：给出字段顺序和一个简短格式示例，但避免提供会被照抄的具体事实。
- 提示词越长效果越差：删除重复、冲突和无法执行的要求，按优先级保留关键规则。
- 不同输入表现差异很大：建立包含空值、长文本和特殊符号的固定测试集。
FAQ 与边界
变量越多越灵活吗？ 不一定。变量越多，漏填和冲突概率越高，只保留确实会变化的信息。
可以把事实核验交给提示词吗？ 不可以。提示词可要求标记不确定内容，但发布前仍须核对可靠来源。
历史记录能当版本管理吗？ 它适合回看结果，不应替代独立的模板版本说明和变更记录。
完成调试后，用“占位符已替换、必填项不为空、预览边界清楚、规则无冲突、测试集通过”五项验收。先确保发送内容正确，再讨论文风好坏，能避免把技术错误误判成模型能力问题。
