SuperAPI AI 工具集

rhdh-backstage-upgrade

通用与其它

查看项目

更新于 10-16 06:52

技能介绍

用途:该技能负责管理 @backstage/* 依赖版本,确定当前检出所在的发布版、应迁移到的目标版,以及两者之间出现的所有问题。

主要能力:按结果路由到不同工作流,包括执行完整升级(workflows/upgrade-backstage.md)、发现当前版本与不一致(references/discover-versions.md)、确定目标发布版(references/determine-target.md)、批量更新依赖(references/bump-deps.md)、迁移被重命名或移动的包导入(references/migrate-packages.md)、处理版本间破坏性变更(references/fix-breaking-changes.md)以及验证升级(references/verify-upgrade.md)。

使用方式:修改依赖前先读取 package.json 和 backstage.json;确定目标 RHDH 版本,优先使用用户或仓库给出的明确值,否则调用 /rhdh-context 获取兼容性矩阵,不可用时向用户询问目标 RHDH 与 Backstage 版本,不要猜测;运行升级前报告当前版本与拟定目标。使用检出中的 versions:bump 脚本(若其封装了 backstage-cli versions:bump),否则直接使用 CLI,并在继续前审查 package.json 与锁文件差异。

边界与限制:本技能只负责版本号,不改变插件扩展的形态或挂载方式;扩展形态由 /rhdh-plugin-nfs-migration 负责,NFS API 差异由 /backstage-api-changes 负责,兼容性矩阵由 /rhdh-context 负责,非机械性源码改动由 /rhdh-plugin-authoring 负责,提交与 PR 由 /rhdh-pr-create 负责。不得升级超过目标 RHDH 发布版所附带的 Backstage 版本;升级前需清点所有 resolution 与 override 并记录来源与证据;需阅读新旧版本之间每个发布版的变更日志并搜索受影响 API;若当前版本与目标一致,应说明“already on target”并停止;报告完成前需运行检出定义的所有构建、测试、lint、格式化与单仓库一致性验证命令;本技能不执行暂存、提交、推送或创建 PR。

适用场景:Backstage 插件、工作区、应用或 redhat-developer/rhdh 单仓库的依赖版本升级与破坏性变更修复。

限制:具体命令、兼容性矩阵与验证命令细节以仓库实际内容为准,资料未提供完整清单。