mcpField
R
rhdh-plugin-bug-fix

rhdh-plugin-bug-fix

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

rhdh-plugin-bug-fix について

rhdh-plugin-bug-fix は、RHDH プラグインの不具合対応を支援する開発スキルです。修正前の再現と証拠に基づく診断を必須とし、最小限の修正を検証した後、一時的な再現テストを削除します。

主な機能

  1. 01報告のトリアージとワークスペース特定
  2. 02Playwright による不具合再現
  3. 03修正前後の動画証拠の記録
  4. 04根拠に基づく最小限の修正
  5. 05変更の検証と一時テストの削除

活用シーン

  1. 01RHDH プラグインの不具合報告の調査
  2. 02修正で再現した問題が解消するかの確認
  3. 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.yaml
references/
e2e-patterns.md
video-recording.md
workspace-map.md
workflows/
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 を呼び出して、その指示に従います。操作の対象は、対象のリポジトリとイシュー番号そのものです。バグ修正の依頼は、イシューへの書き込みを承認するものではありません。
  • ここではステージング、コミット、プッシュ、プルリクエストの作成を行わないでください。

完了時

解決したイシューとワークスペース、再現内容とそこから判明したこと、証拠を伴う根本原因、変更したファイルとステージングされていないファイル、修正前後の録画パス、検証コマンドとその結果、レビュアーが実行すべきテスト計画、公開に向けて次に呼び出す名前付きスキルを報告します。

コメント