triage

トリアージ

プロジェクトの課題トラッカー上の課題を、トリアージの役割による小さなステートマシンに沿って移動します。

トリアージ中に課題トラッカーへ投稿するコメントや課題は、すべて次の免責事項から始める必要があります。

> *This was generated by AI during triage.*

参考ドキュメント

• 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 つのグループに分けて表示します。

1. ラベルなし — まだトリアージされていません。
2. needs-triage — 評価中です。
3. 前回のトリアージメモ以降に報告者のアクティビティがある needs-info — 再評価が必要です。

件数と、課題ごとの 1 行の概要を表示します。メンテナーに選んでもらってください。

特定の課題をトリアージする

1. コンテキストを収集します。 課題の全内容（本文、コメント、ラベル、報告者、日付）を読みます。以前のトリアージメモを解析し、解決済みの質問を再度尋ねないようにします。プロジェクトのドメイン用語集を使ってコードベースを調べ、該当領域の ADR を尊重します。.out-of-scope/*.md を読み、この課題に似た過去の却下事例があれば提示します。

2. 推奨案を示します。 推奨するカテゴリと状態、その理由、および課題に関連するコードベースの概要を簡潔にメンテナーに伝えます。指示を待ってください。

3. 再現します（バグのみ）。 詳細を質問する前に、再現を試みます。報告者の手順を読み、関連コードをたどり、テストやコマンドを実行します。何が起きたかを報告します。再現に成功した場合はコードパスを、再現に失敗した場合はその旨を、詳細が不十分な場合はその旨を伝えます（needs-info とする有力な根拠です）。再現が確認できていると、エージェントブリーフの説得力が大きく高まります。

4. 詳細を確認します（必要な場合）。 課題の詳細を詰める必要がある場合は、/grill-with-docs セッションを実施します。

5. 結果を適用します。

   • 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 に移動する場合は、エージェントブリーフを作成するかどうかを尋ねてください。

情報が必要な場合のテンプレート

## Triage Notes

**What we've established so far:**

- point 1
- point 2

**What we still need from you (@reporter):**

- question 1
- question 2

ヒアリング中に明らかになったことはすべて「これまでに確認できたこと」に記録し、作業内容が失われないようにしてください。質問は具体的で、回答者が行動できる内容にしてください。「もう少し情報をください」のような質問は避けてください。

前回のセッションの再開

課題に以前のトリアージメモがある場合は、それを読み、報告者が未回答の質問に回答したかどうかを確認してから、続行する前に状況を更新して提示してください。解決済みの質問は再度尋ねないでください。