SuperAPI AI 工具集

rhdh-plugin-authoring

编程与开发

查看项目

更新于 10-16 02:27

技能介绍

用途:为 Red Hat Developer Hub(RHDH)编写 Backstage 插件源码,既包括在 rhdh-plugins 或 community-plugins 中新建动态插件,也包括在已有插件内实现功能。前端与后端是同一任务的两个分支,遵循相同约定、构建门禁与仓库,需按请求判断分支。

主要能力:新建后端和前端动态插件(执行 scripts/scaffold.py,参考 references/backend.md、frontend.md);判断扩展类型(plugin-types.md);实现或评审插件代码(development-patterns.md 及相关参考);使用 Backstage UI 或 MUI 样式(bui.md);在新插件中编写 NFS 代码(nfs.md);应用 RHDH 特定模式(rhdh.md);运行或扩展插件开发应用(dev-app.md);编写测试(testing.md);编写或阅读前端功能规格(frontend-specs.md)。

使用方式:先阅读目标仓库的 AGENTS.md 或 CLAUDE.md 及关联规格或问题,仓库规则优先。在已有检出中运行 python scripts/detect-rhdh-context.py --path <plugin-or-workspace>,记录角色、前端系统、插件 ID、动态状态、MUI 版本和包管理器。确定目标 RHDH 与 Backstage 版本,优先使用用户或仓库明确值,否则调用 /rhdh-context,不可用时应询问用户而非猜测。修改前检查分支与状态,保护未提交工作。新插件或公共 API 变更且存在多种有效设计时,调用 /grilling 作为设计门禁,展示设计后再实现;若未安装则暂停并提示 /setup-rhdh-skills install。按结果路由:脚手架用 scaffold.py,实现按参考文档。

限制:本技能只编写插件源码,不导出制品、不生成部署配置、不发布。导出打包由 /rhdh-plugin-export 负责;生成 dynamic-plugins.yaml 配置和挂载点由 /rhdh-plugin-wiring 负责;旧版前端插件转 NFS 由 /rhdh-plugin-nfs-migration 负责;升级 @backstage/* 依赖由 /rhdh-backstage-upgrade 负责;测试放置由 /rhdh-test-placement 负责;变更集、提交与 PR 由 /rhdh-pr-create 负责。后端代码仅用新后端系统(createBackendPlugin 或 createBackendModule from @backstage/backend-plugin-api),src/index.ts 必须有默认导出,Scalprum 名称须与 dynamic-plugins.yaml 中的键一致。按顺序运行构建门禁并在首次失败时停止:yarn prettier:fix、yarn tsc:full、yarn build:all、yarn test --watchAll=false、yarn build:api-reports:only。不要在此暂存、提交、推送或开 PR。