mcpField
R
rhdh-context

rhdh-context

github.com/redhat-developer开发1961 次安装1 天前更新
代码仓库

关于 rhdh-context

面向 RHDH 开发工作流的环境信息技能。它以 JSON 提供已检出的仓库、可用工具、目标 RHDH 和 Backstage 版本及配置位置，供其他技能读取。

主要功能

  1. 01报告仓库名称和路径
  2. 02检查工具是否可用
  3. 03解析目标 RHDH 与 Backstage 版本
  4. 04返回配置位置及其来源
  5. 05提供 status、doctor、config 和 workspace 命令

适用场景

  1. 01为其他技能说明当前检出环境
  2. 02在工作流开始前识别缺失工具
  3. 03确定适用的兼容版本
  4. 04在技能间传递环境信息

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/redhat-developer/rhdh-skills --skill rhdh-context

安装后在 Claude Code 中输入/rhdh-context确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
rhdh-jira-projects.md
rhdh-repos.md
versions.md
rhdh/
__init__.py
__main__.py
cli.py
config.py
formatters.py
todo.py
worklog.py
workspace.py
scripts/
context.py
rhdh

详细介绍

RHDH 上下文

其他每个 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。如果指定了 --target-rhdh，source 的值为 user；如果检出版本在 backstage.json 中固定了版本，则为 repository；如果答案来自已检入的兼容性矩阵，则为 rhdh-context。

读取整个对象。在本次会话中重复使用，除非配置或仓库状态发生变化。如果缺少所需的功能，请指出该功能，并告知用户运行 /setup-rhdh-skills；模型技能无法调用仅供人类使用的入口。

保留的 CLI

从此技能目录运行 CLI：uv run scripts/rhdh <command>。它是捆绑的包装器，而非已安装的可执行文件：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 路径，绝不可猜测。调用方收到的是事实本身，而不是需要自行打开的文件路径。

评论

支持 Markdown