mcpField
T
triage

triage

github.com/withastro開発63.6k379 回インストール1 日前に更新
リポジトリ

triage について

バグ報告をエンドツーエンドでトリアージするスキルです。問題の再現、原因の診断、意図された動作かの確認を行い、結果に応じて修正を試みます。インフラの問題で停滞しないよう、再試行を制限します。

主な機能

  1. 01入力内容または GitHub Issue の取得
  2. 02コンテキストを分けた問題の再現
  3. 03原因診断と動作の意図確認
  4. 04修正を試みるかどうかの判断

活用シーン

  1. 01GitHub のバグ報告の調査
  2. 02問題を再現できるかの確認
  3. 03意図しない動作と判断した後の修正

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/withastro/astro --skill triage

インストール後、Claude Code で/triageを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

diagnose.md
fix.md
reproduce.md
verify.md
evals/
evals.json

詳細

トリアージ

バグ報告を最初から最後までトリアージします。バグを再現し、根本原因を診断し、意図された挙動かどうかを確認して、修正を試みます。

一般ルール

インフラの問題に行き詰まらないでください。 サーバーが起動しない、ポートがブロックされている、CI 環境でツールが利用できない場合は、2 回試した時点で切り上げ、手元にあるデータをもとに報告を書いてください。サーバーの再起動や、見つからない CLI ツールを探してループするのは、限られた時間を無駄にします。古いプロセスとの格闘で時間切れになって報告がないより、確かな調査結果を含む部分的な報告のほうがはるかに価値があります。

入力

次のいずれかが必要です。

  • 引数で指定された issueTitle と issueBody（推奨。バグ報告としてそのまま使用してください）、または
  • 会話内で言及された GitHub の Issue 番号または URL（gh issue view を使用して詳細を取得してください）

引数に triageDir が指定されている場合は、トリアージの作業ディレクトリとして使用してください。指定されていない場合は、triage/gh-<issue_number>（Issue 番号がある場合）または triage/current をデフォルトで使用してください。

ステップ 1：再現

reproduce.md を読み、その指示に従ってください。このステップでは、コンテキストを切り分けるためにサブエージェントを使用してください。

再現が完了したら、結果を確認してください。

  • Issue がスキップされた場合（ホスト固有、未対応バージョンなど）は、出力に進みます。
  • Issue を再現できなかった場合は、出力に進みます。
  • Issue を再現できた場合は、ステップ 2 に進みます。

ステップ 2：診断

diagnose.md を読み、その指示に従ってください。このステップでは、コンテキストを切り分けるためにサブエージェントを使用してください。

診断が完了したら、確信度を確認してください。

  • 確信度が低い場合は、出力に進みます。
  • 確信度が中程度または高い場合は、ステップ 3 に進みます。

ステップ 3：検証

verify.md を読み、その指示に従ってください。このステップでは、コンテキストを切り分けるためにサブエージェントを使用してください。

検証が完了したら、判定を確認してください。

  • 判定が intended-behavior の場合は、出力に進みます。これはバグではないため、修正を試みないでください。
  • 判定が bug または unclear の場合は、ステップ 4 に進みます。

ステップ 4：修正

fix.md を読み、その指示に従ってください。このステップでは、コンテキストを切り分けるためにサブエージェントを使用してください。

修正が成功しても失敗しても、出力に進みます。

出力

トリアージの完了後（または途中で終了した場合）、オーケストレーターがコメントを投稿し、ラベルを管理できるように、構造化された結果を返してください。

コメント

Markdown 対応