mcpField
R
rhdh-context

rhdh-context

github.com/redhat-developer開発1961 回インストール1 日前に更新
リポジトリ

rhdh-context について

RHDH 開発ワークフロー向けの環境確認スキルです。チェックアウト済みリポジトリ、利用可能なツール、対象の RHDH と Backstage のバージョン、設定場所を JSON で返し、他のスキルが利用します。

主な機能

  1. 01リポジトリ名とパスの報告
  2. 02ツールの利用可否確認
  3. 03対象 RHDH と Backstage のバージョン解決
  4. 04設定場所と情報源の提示
  5. 05status、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 Context

ほかのすべての RHDH スキルが前提とする環境情報です。チェックアウトされているリポジトリとその場所、PATH 上のツール、このチェックアウトが対象とする RHDH および Backstage のバージョン、設定の保存場所を示します。呼び出し元はスキル名でこのスキルを呼び出し、報告された内容を読み取ります。ファイルを調べたり、Python パッケージをインポートしたりすることはありません。

このスキルが返す情報

別のスキルでリポジトリ、ツール、バージョン、設定の情報が必要になる前に実行してください。

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

JSON オブジェクトを 1 つだけ出力します。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 ...
ToDo の状態uv run scripts/rhdh todo ...

Config、作業ログ、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 対応