必须放参考样例，当生成可执行迁移计划时；需满足真实、简短、结构一致，且严格包含可执行动作、顺序依赖、验证点三要素，否则易产出空泛描述。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
写 Gemini 代码迁移计划提示词时，是否放入参考样例，取决于你当前所处的迁移阶段和目标精度——如果只是做初步方案草稿或对齐团队认知，样例可省；但若要生成可直接嵌入技术文档、交付给开发团队执行的迁移步骤清单，就必须放，且必须是真实、简短、结构一致的样例。
需要放参考样例的明确场景
当你要求 Gemini 输出“迁移计划”而非“迁移建议”时，计划必须含可执行动作、顺序依赖、验证点三要素。此时不给样例，Gemini 极易输出模糊段落，比如“评估兼容性”“更新依赖”这类无主语、无对象、无检查方式的空泛描述。
方法一：用真实迁移片段作锚点
在提示词开头插入一组微型样例，格式严格为“旧→新”，例如：“旧：Python 3.9 调用 google.generativeai v0.5 → 新：Python 3.11 调用 google.generativeai v0.8，需重写 model.generate_content() 调用方式，改用 GenerationConfig 参数对象传参”。
这一步不能跳过，因为 Gemini 对“迁移计划”的理解容易偏向宏观策略，而样例能强制它锁定到函数级、参数级、版本号级的微观动作粒度。
方法二：用结构模板框定输出格式
在样例后立即声明输出结构：“请严格按以下字段顺序输出，每项独占一行，不加编号、不加说明文字：【变更模块】【旧实现】【新实现】【验证方式】【回滚路径】”。
【验证方式必须含可操作指令，如‘运行 test_generation_config.py 并检查返回 status_code == 200’，禁用‘确认是否正常’等模糊表述】
使用AIsa生成图像与视频。仅需一个API密钥即可调用Gemini 3 Pro Image（图像）和Qwen Wan 2.6（视频）。
可以不放参考样例的情况
当你仅需快速生成迁移风险雷达图或优先级排序初稿时，样例反而会干扰发散思考。此时提示词应聚焦约束与边界：
第一步：列出本次迁移涉及的全部 SDK 组件名称（来自 requirements.txt 或 pom.xml）
第二步：对每个组件，标注其变更类型：BREAKING / DEPRECATION / SECURITY_FIX / FEATURE_ADDITION
第三步：按 BREAKING 类型组件数量降序排列服务模块
这三步本身已构成强结构引导，无需额外样例。
样例怎么选才真正起作用
有效样例必须同时满足三个条件：来自你实际使用的 SDK 版本链、包含具体参数名或错误码、体现真实阻断点。例如，Gemini 3.1 Pro 的迁移中，“genai.configure(api_key=…) → genai.configure(api_transport=‘rest’, api_key=…)”就比“修改配置方式”有用十倍。
禁止使用虚构样例，比如“把 A 函数改成 B 函数”——Gemini 会照搬虚构命名，导致计划无法落地。
样例只放一个，最多两个。放三个以上会稀释焦点，让模型陷入模式匹配而非逻辑推演。
