SuperAPI AI 工具集

rhdh-context

部署与运维

查看项目

更新于 10-16 02:14

技能介绍

用途

rhdh-context 提供每项其他 RHDH 技能所依据的环境事实:哪些仓库已检出、位置在哪里,哪些工具在 PATH 上,这次检出对应哪些 RHDH 和 Backstage 版本,以及其配置所在的位置。调用方按名称调用本技能并读取其报告结果;它们从不检查本技能的文件,也不导入其 Python 包。

在另一个技能需要仓库、工具、版本或配置事实之前运行本技能:

python scripts/context.py --project-root <repo> --json

返回内容

它只打印一个 JSON 对象,不含其他内容:

  • repositories 是一个 {name, path} 数组。
  • tools 将每个被探测的工具映射为 installed、missing 或 not-probed。
  • configuration 携带配置路径,以及 targetRhdh、targetBackstage 和 source。

source 的取值:当给出 --target-rhdh 时为 user;当检出在 backstage.json 中固定了版本时为 repository;当答案来自签入的兼容性矩阵时为 rhdh-context。

应消费整个对象。除非配置或仓库状态发生变化,否则在同一会话内复用该结果。当缺少某项必需能力时,指明该能力并告知人工运行 /setup-rhdh-skills;模型技能无法调用该仅限人工的入口点。

保留的 CLI

在本技能目录下以 uv run scripts/rhdh <command> 运行该 CLI。它是一个捆绑的包装器,不是已安装的可执行文件:npx skills add 只复制技能目录,不安装控制台脚本。该包装器未声明任何依赖——与其并列的 rhdh 包仅使用标准库。

结果与接口对应关系:

  • 环境定位与诊断:uv run scripts/rhdh status、uv run scripts/rhdh doctor
  • 分层项目/用户配置:uv run scripts/rhdh config ...
  • 仓库子模块设置:uv run scripts/rhdh setup submodule ...
  • 覆盖工作区检查:uv run scripts/rhdh workspace ...
  • 工作日志状态:uv run scripts/rhdh log ...
  • 待办状态:uv run scripts/rhdh todo ...

配置、工作日志、待办、JSON 输出结构、退出码以及已有的 .rhdh 状态保持兼容。本地运行时操作属于 /rhdh-local。兼容命令 uv run scripts/rhdh local ... 委托给独立的 rhdh-local 可执行文件;本技能不导入或定位其他技能的文件。

交接

交接保留在对话中。本技能将其上下文以 JSON 打印;调用方读取并携带其所需内容。

当人工需要上下文延续到后续会话时,告知他们运行 /handoff,它会将摘要写入操作系统临时目录。这是一个由人工调用的技能,也是一种有意的操作,而非本技能代其执行的事情。

条件引用

  • 在识别 RHDH 仓库或解释生态关系时,阅读 references/rhdh-repos.md。
  • 当某工作流需要签入的兼容性矩阵时,阅读 references/versions.md。当实时仓库事实与缓存文本不一致时,优先采用实时仓库事实。

完成判定

当答案包含已解析的仓库及其路径、工具状态、目标 RHDH 和 Backstage 版本及其产生的来源,以及调用方仍需设置的每项能力时,即告完成。未配置的仓库会以 null 路径报告,绝不猜测。调用方接收的是事实本身,而不是一个需要其打开的文件路径。