rhdh-plugin-bug-fix について
rhdh-plugin-bug-fix は、RHDH プラグインの不具合対応を支援する開発スキルです。修正前の再現と証拠に基づく診断を必須とし、最小限の修正を検証した後、一時的な再現テストを削除します。
主な機能
- 01報告のトリアージとワークスペース特定
- 02Playwright による不具合再現
- 03修正前後の動画証拠の記録
- 04根拠に基づく最小限の修正
- 05変更の検証と一時テストの削除
活用シーン
- 01RHDH プラグインの不具合報告の調査
- 02修正で再現した問題が解消するかの確認
- 03テストや公開に向けた引き継ぎの準備
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ redhat-developer/ rhdh-skills --skill rhdh-plugin-bug-fixインストール後、Claude Code で/rhdh-plugin-bug-fixを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlreferences/e2e-patterns.mdvideo-recording.mdworkspace-map.mdworkflows/fix-bug.md詳細
RHDH プラグインのバグ修正
バグ報告から、検証済みの修正までを担当します。診断の前に再現し、編集の前に診断し、報告の前に検証します。再現テストは診断の証拠であり、製品には含めません。
まずはこちらから
最初から workflows/fix-bug.md に従ってください。課題の参照先を特定し、エージェントが対応できる状態か報告をトリアージし、ワークスペースを見つけ、full-e2e または no-e2e の分岐を選択して、再現、修正、検証、クリーンアップを行います。
結果に応じた参照先
| 結果 | 読み込んで従うもの |
|---|---|
| プラグインのバグを再現、診断、修正する | workflows/fix-bug.md |
| 報告からプラグインのワークスペースを特定する | references/workspace-map.md |
| 一時的な Playwright 再現テストを作成する | references/e2e-patterns.md |
| 修正前後の証拠を記録して変換する | references/video-recording.md |
境界
/rhdh-forgeは GitHub の読み取りを担当します。生のイシューまたはプルリクエストの参照先を指定して名前で呼び出し、返された構造化されたイシューのコンテキスト(キー、概要、URL、リポジトリ、番号、状態、ラベル、説明、候補となるワークスペースと、それを特定した戦略)を使用します。作業を始める前に、そのワークスペースがチェックアウトと一致することを確認し、戦略で未解決と報告された場合はユーザーに尋ねます。ここでは URL を解析したり、gh issue viewを実行したりしないでください。/rhdh-jira-apiは Jira キーの読み取りを担当し、同じイシューの詳細を返します。/grillingは、複数の根本原因が依然として妥当な場合や、修正案によって互換性への影響が大きく異なる場合の設計ゲートです。実装前に、そこで提示される制約を使用してください。インストールされていない場合はその旨を伝え、次に人が行う手順として/setup-rhdh-skills installを明示し、その分岐を一時停止します。/rhdh-test-placementは、永続的な回帰テストをどこに配置するかを助言します。ここで作成する再現テストは使い捨てであり、変更を引き渡す前に削除します。/rhdh-plugin-authoringは機能開発と公開 API 設計を担当します。/rhdh-pr-createはステージング、変更セット、コミット、プッシュ、プルリクエスト、録画のアップロード、イシューの更新を担当します。
名前を指定してスキルを呼び出し、会話の中で引き継ぎ内容を説明します。他のスキルのファイルを開かないでください。
不変条件
- 製品コードを編集する前に、失敗を再現します。「修正前」の録画は、修正後には再現できません。
- 一時的な
_repro-<issue>.test.tsは成果物ではなく、証拠です。変更を引き渡す前に、該当するファイルを必ず削除します。 - ワークスペースの実際の Playwright 設定、ヘルパー、周辺のテストを確認します。
references/workspace-map.mdで候補のワークスペースは特定できますが、現在のテスト基盤の説明はありません。 - 各録画が確実に確定されるよう Playwright のコンテキストを閉じ、公開処理で使用されるまで修正前後の録画を保持します。
- 実装前に、観測した証拠を示して根本原因を説明し、そのうえでリポジトリの規約に沿った最小限の修正を行います。
- テストが失敗した場合は、診断に戻ります。テストを通すためにアサーションを弱めてはいけません。
- イシューへのラベル追加やトリアージコメントの投稿は外部への書き込みです。名前付きスキル
mutation-gateを呼び出して、その指示に従います。操作の対象は、対象のリポジトリとイシュー番号そのものです。バグ修正の依頼は、イシューへの書き込みを承認するものではありません。 - ここではステージング、コミット、プッシュ、プルリクエストの作成を行わないでください。
完了時
解決したイシューとワークスペース、再現内容とそこから判明したこと、証拠を伴う根本原因、変更したファイルとステージングされていないファイル、修正前後の録画パス、検証コマンドとその結果、レビュアーが実行すべきテスト計画、公開に向けて次に呼び出す名前付きスキルを報告します。
コメント
Markdown 対応