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 つだけ付与してください。状態ロールが競合している場合は、その旨を報告し、ほかの作業に着手する前にメンテナーに確認してください。

これらは標準ロール名です。イシュートラッカーで実際に使われているラベル文字列は異なる場合があります。マッピングが提供されているはずです。提供されていない場合は /memo-flow を実行してください。

状態の遷移：ラベルのないイシューは通常、最初に 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

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

前回のセッションの再開

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