SuperAPI AI 工具集

migration-guidance

编程与开发

查看项目

更新于 10-20 16:21

技能介绍

migration-guidance 是一个面向 v3 到 v4 API 迁移的指引维护技能,适用于调整 v3 公共 API 到 v4 的映射方式、编辑迁移标注,或重新生成 migration/v3-to-v4.md 的场景。

用途 当 v3 公共模块或 API 被重命名、移动、删除、替换,或其在 v4 中的契约发生实质差异时,用它更新迁移指引。注意:仅在 v4 中存在、没有 v3 对应物的 API 不会自动需要标注。

主要能力

  • 要求为每一个受影响的 v3 符号作出交代,避免遗漏。
  • 新增或修改标注 YAML 前需先阅读 annotations.md。
  • 对照实现与测试核实每一个建议的替换项。
  • 在检查或重新生成参考文档时,或 API 变更存在于已提交 ref 中时,阅读 generation.md 执行相应流程;否则需报告生成被推迟。
  • 生成输出后,检查是否存在无关变动与过期引用。

使用方式 按技能说明的流程执行:先梳理受影响的 v3 符号,再依据 annotations.md 编写或更新标注,核实替换项,然后按 generation.md 进行校验与生成,最后审阅生成差异。对于未提交的 API 变更,应明确报告哪些检查被推迟。

完成标准 每个受影响的 v3 符号均有交代,标注中的替换项已核实,变更位于已提交 ref 时检查与生成均成功,且每个生成差异都能得到解释。

限制 资料未提供具体安装命令、依赖环境、平台支持、收费方式与效果数据,暂未提供。