SuperAPI AI 工具集

backstage-api-changes

编程与开发

查看项目

更新于 10-16 02:28

技能介绍

用途:该技能是 NFS API 变更的集中资料源,记录 Backstage 新前端系统从早期 alpha 到当前 GA 之间的破坏性与重要变更,供 Red Hat Developer Hub 插件相关的升级与迁移流程按名称调用。

调用关系:/rhdh-backstage-upgrade 负责版本号,当版本升级跨越这些变更导致 NFS 代码无法编译时会调用本技能;/rhdh-plugin-nfs-migration 负责扩展形态,当插件已按更早的 alpha 迁移,或旧指南中的 Blueprint 参数引发 TypeScript 错误时会调用本技能。本技能属于两者之下,只说明 API 发生了什么变化,不规定应做哪种改动。

主要能力:读取 references/api-changes.md,该文件每个变更一节,列出旧形式、新形式以及符号现在所属的包;可作为对照手头代码的检查清单使用。

使用方式与完成标准:报告哪些变更适用于当前代码、每个变更涉及的准确符号与包、无法解决的匹配项,并把结果交回调用它的技能。

限制:它描述的是从早期 alpha 到当前 GA 的差异,不是逐版本变更日志,也不能替代阅读升级所跨具体版本的 changelog;上游接口仍在变化,当文字说明与 node_modules/@backstage/frontend-plugin-api 的类型定义冲突时,以类型定义为准,并报告该冲突。其他细节暂未提供。