setup-rhdh-skills について
Set Up RHDH Skillsは、人の判断のもとでRHDHスキル群を導入し、必要な機能を設定するスキルです。セットアップ診断、分岐ごとの手順、変更前の承認ゲートを使い、ユーザーのマシンやアカウントへの操作を扱います。
主な機能
- 01スキル群の導入・更新・修復
- 02診断ツールによる設定状況の確認
- 03分岐に沿った機能の設定
- 04マシンへの変更計画と承認
- 05認証情報を各ツールの保管先に保持
活用シーン
- 01スキル群の導入または修復
- 02JiraやGoogle Workspaceへのアクセス設定
- 03リポジトリやローカル実行環境の設定
- 04CursorでのAtlassian MCP認証
MCP 対応
設定分岐の一つで、CursorにおけるAtlassian MCPの認証を案内します。他の分岐ではスキルの導入や機能の設定を扱います。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ redhat-developer/ rhdh-skills --skill setup-rhdh-skillsインストール後、Claude Code で/setup-rhdh-skillsを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlassets/catalog.jsonreferences/atlassian-mcp.mdgoogle-workspace.mdinstall.mdjira.mdlocal-runtime.mdopenshift-ci.mdprivate-data.mdrepositories.mdscripts/setup.py詳細
RHDH Skills のセットアップ
パック一式をブートストラップし、続いてモデルスキルに必要な機能を設定します。インストール、認証情報、外部システムへの変更には人間の操作が必要なため、このページは人間向けのエントリーポイントです。
セットアップ分岐を選択する
| リクエスト | 読み込む内容 |
|---|---|
| スキルコレクション一式をインストール、アップグレード、または修復する | references/install.md |
| Jira CLI、REST、または GraphQL へのアクセスを設定する | references/jira.md |
| スケジュールとテスト計画用に Google Workspace へのアクセスを設定する | references/google-workspace.md |
| RHDH のプライベートデータチェックアウトを設定する | references/private-data.md |
| Cursor で Atlassian MCP を認証する | references/atlassian-mcp.md |
| RHDH リポジトリを検出または設定する | references/repositories.md |
| コンテナとローカル RHDH ランタイムを設定する | references/local-runtime.md |
| OpenShift CI Gangway アダプターを認証する | references/openshift-ci.md |
リクエストに分岐の指定がない場合は、この表を表示してユーザーの選択を待ちます。
事前確認
各分岐の開始前に、セットアップ診断ツールを実行します。
uv run scripts/setup.py doctor --json
レポート全体を確認します。セットアップに変更がない限り、セッション中はこのレポートを再利用します。診断ツールはインストール済みのスキル、不足しているスキル、機能の状態、設定場所を一覧表示します。認証情報は読み取りません。
書き込みゲート
スキルのインストールと機能の設定では、ユーザーのマシンやアカウントに書き込みが行われます。mutation-gate という名前のスキルを呼び出し、その指示に従ってください。
scripts/setup.py install-plan は順序付きのインストール操作を提示し、scripts/setup.py apply --plan <file> --confirm は承認済みのプランを実行し、各操作の結果を報告します。設定分岐でも、同様に各分岐での操作を提示します。
認証情報は、所有するツールの認証情報ストアまたは OS キーチェーンに保持します。シークレットはツールに直接渡し、会話、設定 JSON、プラン、結果レポート、パックの内容には含めないでください。
完了
診断レポートで、assets/catalog.json に記載されたすべての昇格済みスキルに加えて、grilling、code-review、handoff がインストール済みと報告され、同じ診断レポートで分岐固有の機能が利用可能と示され、分岐のリファレンスに記載されたスモークチェックを実行してその出力を提示した時点で、分岐は完了です。インストール分岐ではさらに、承認済みプランの各操作について結果が報告され、エージェントを再起動または再スキャンするようユーザーに伝えている必要があります。機能が不足しているためにモデルスキルからここに案内された場合は、そのスキルが指定したすべての機能がインストール済みと報告されるまで完了できません。未解決のまま残っている機能は、分岐を完了扱いにせず、未解決として明示してください。