开发者与技术写作者经常要做「升级迁移指南」这类事：为破坏性版本升级编写迁移指南。每次都从头写提示词，结果时好时坏；把它做成智能体 Skill，就能让智能体每次按同一套步骤执行，输出结构也更稳定。

不是每个人都有能装技能的智能体平台。下面这份提示词可以直接粘贴到任何对话助手中使用，效果接近技能版本，只是需要每次手动粘贴。

可复制的提示词

# 角色
你是一名熟悉升级迁移指南的助手，服务对象是开发者与技术写作者。

# 任务
为破坏性版本升级编写迁移指南。

# 输入
我会提供：版本差异。如果缺少关键信息，请先列出问题，不要自行编造。

# 步骤
1. 列出破坏性变更
2. 写新旧对照
3. 给出迁移步骤
4. 附检查清单

# 输出
迁移指南。使用清晰的小标题，最后单独列出“需人工确认”的内容。

# 约束
- 文中的命令和接口要与当前代码逐一核对。
- 信息不足时先提问，不要自行编造数据或事实。

# 材料
（在这里粘贴你的内容）

用法

  1. 复制整段提示词，把材料粘贴到最后
  2. 第一次使用时附一份你认可的范例，告诉助手“参考这个格式”
  3. 对输出不满意时，指出具体哪一步有问题，而不是笼统地说“再改改”
  4. 把调好的提示词保存在笔记里，下次直接用

和技能版的区别

提示词版本每次都要手动粘贴，长对话中后半段可能逐渐偏离要求；技能版由平台自动加载，适合高频使用。如果你每周都要用好几次，建议升级为技能，参考快速上手。

小技巧

  • 把“输出”部分改成表格表头，能显著提高格式稳定性
  • 材料很长时先让助手复述理解，再开始处理
  • 风险较低，但输出仍需快速过目再使用

准备一份好范例

在技能的参考资料里放一份你认可的迁移指南范例，往往比多写十条规则更有效。好范例应当：

  • 来自真实工作，但已去除个人信息和敏感数据
  • 体现团队习惯的结构、措辞和详略程度
  • 包含一处“需人工确认”的标注示范，让智能体学会如何表达不确定
  • 篇幅适中，不要比平时的产出长太多

范例不必多，一到两份即可；太多范例反而会让智能体机械模仿某一份的细节。

每一步要产出什么

把每一步的中间产出写清楚，智能体就不容易跳步，人也方便定位问题：

  1. 列出破坏性变更：产出一段简短的中间结果，并注明依据来自版本差异的哪一部分
  2. 写新旧对照：产出一段简短的中间结果，并注明依据来自版本差异的哪一部分
  3. 给出迁移步骤：产出一段简短的中间结果，并注明依据来自版本差异的哪一部分
  4. 附检查清单：产出一段简短的中间结果，并注明依据来自版本差异的哪一部分

最后一步之后，再把这些中间结果汇总成迁移指南。中间结果可以折叠或省略展示，但在技能指令中要求智能体“先完成再汇总”，能明显减少遗漏。

延伸阅读

说明：文中的配置、代码与目录结构均为示意，用于说明思路；各平台的入口、字段名与能力会更新，落地前请以对应官方文档为准。示例中的数据与场景为虚构，不代表真实案例。