トリアージ は何をしますか？
プロジェクトの課題トラッカー上の課題を、トリアージロールの小さなステートマシンに従って移動させます。
トリアージ中に課題トラッカーに投稿されるコメントや課題はすべて、以下の免責事項で必ず始めてください。
> *これはトリアージ中にAIによって生成されました。*
参考ドキュメント
- AGENT-BRIEF.md — 耐久性のあるエージェントブリーフの書き方
- OUT-OF-SCOPE.md —
.out-of-scope/ナレッジベースの仕組み
ロール
2つのカテゴリロール:
bug— 何かが壊れているenhancement— 新機能または改善
5つの状態ロール:
needs-triage— メンテナーによる評価が必要needs-info— 報告者からの追加情報待ちready-for-agent— 完全に仕様が固まり、AFKエージェントが処理可能ready-for-human— 人間による実装が必要wontfix— 対応しない
トリアージされた各課題は、1つのカテゴリロールと1つの状態ロールを正確に持つ必要があります。状態ロールが競合している場合は、その旨をフラグし、他の作業を行う前にメンテナーに確認してください。
これらは標準的なロール名です。実際の課題トラッカーで使用されるラベル文字列は異なる場合があります。マッピングは提供されているはずです。提供されていない場合は /setup-matt-pocock-skills を実行してください。
状態遷移: ラベルのない課題は通常、最初に needs-triage に移動します。そこから needs-info、ready-for-agent、ready-for-human、または wontfix に移動します。needs-info は報告者が返信すると needs-triage に戻ります。メンテナーはいつでもオーバーライドできます。異常な遷移をフラグし、先に進む前に確認してください。
呼び出し方
メンテナーが /triage を呼び出し、自然言語で希望を説明します。リクエストを解釈して行動してください。例:
- 「私の注意が必要なものをすべて表示して」
- 「#42 を見てみよう」
- 「#42 を ready-for-agent に移動して」
- 「エージェントが引き取る準備ができているものは？」
注意が必要なものを表示する
課題トラッカーをクエリし、以下の3つのバケットを古い順に表示します:
- ラベルなし — まだトリアージされていない。
needs-triage— 評価中。needs-infoで、最後のトリアージメモ以降に報告者のアクティビティがあるもの — 再評価が必要。
バケットごとに件数と課題ごとに1行の概要を表示します。メンテナーに選択させます。
特定の課題をトリアージする
-
コンテキストを収集する。 課題の全文（本文、コメント、ラベル、報告者、日付）を読みます。以前のトリアージメモがあれば解析し、解決済みの質問を再度聞かないようにします。プロジェクトのドメイン用語集を使用してコードベースを調査し、該当領域のADRを尊重します。
.out-of-scope/*.mdを読み、この課題に類似した過去の却下があれば表面化させます。 -
提案する。 メンテナーに、推論とともにおすすめのカテゴリと状態を伝え、課題に関連する簡潔なコードベースの概要を添えます。指示を待ちます。
-
再現する（バグのみ）。 詳細な詰めに入る前に、再現を試みます: 報告者の手順を読み、関連するコードをトレースし、テストやコマンドを実行します。何が起こったかを報告します — コードパスを含む成功した再現、失敗した再現、または詳細不足（強い
needs-infoシグナル）。確認された再現は、はるかに強力なエージェントブリーフになります。 -
詳細を詰める（必要な場合）。 課題に肉付けが必要な場合は、
/grillingと/domain-modelingスキルを一緒に実行します — 一度に1つの質問で課題を整理し、決定が確定するにつれてCONTEXT.md/ ADR をインラインで更新しながら、ドメイン用語を明確にします。 -
結果を適用する:
ready-for-agent— エージェントブリーフのコメントを投稿します（AGENT-BRIEF.md）。ready-for-human— エージェントブリーフと同じ構造ですが、委任できない理由（判断、外部アクセス、設計判断、手動テストなど）を記します。needs-info— トリアージメモを投稿します（以下のテンプレート）。wontfix(バグ) — 丁寧に説明し、クローズします。wontfix(機能拡張) —.out-of-scope/に書き込み、コメントからリンクし、クローズします（OUT-OF-SCOPE.md）。needs-triage— ロールを適用します。部分的な進捗がある場合は、オプションでコメントを残します。
クイック状態オーバーライド
メンテナーが「#42 を ready-for-agent に移動して」と言った場合、それを信頼し、ロールを直接適用します。これから行うこと（ロール変更、コメント、クローズ）を確認し、行動します。詳細な詰めはスキップします。詳細な詰めなしで ready-for-agent に移動する場合は、エージェントブリーフを作成するかどうか尋ねます。
情報不足 (Needs-info) テンプレート
## トリアージメモ
**これまでに判明していること:**
- ポイント1
- ポイント2
**報告者（@reporter）からまだ必要なこと:**
- 質問1
- 質問2
詳細な詰めの中で解決されたことはすべて「判明していること」に記録し、作業が失われないようにします。質問は具体的で実行可能なものにし、「詳細情報を提供してください」のような漠然としたものは避けます。
以前のセッションを再開する
課題に以前のトリアージメモが存在する場合、それを読み、報告者が未解決の質問に回答したかどうかを確認し、続行する前に最新の状況を提示します。解決済みの質問を再度聞かないようにします。