Triage

プロジェクトの issue tracker で、triage roles による小規模なステートマシンを通して issue を移動させます。

triage 中に issue tracker に投稿されるコメントまたは issue は必ず以下の免責事項で始まる必要があります:

> *This was generated by AI during triage.*

Reference docs

• AGENT-BRIEF.md — 耐久性のある agent brief の書き方
• OUT-OF-SCOPE.md — .out-of-scope/ ナレッジベースの仕組み

Roles

2 つのカテゴリ role:

• bug — 何かが壊れている
• enhancement — 新機能または改善

5 つのステート role:

• needs-triage — maintainer による評価が必要
• needs-info — 報告者からの追加情報を待機中
• ready-for-agent — 完全に仕様が決まっており、AFK agent の準備完了
• ready-for-human — 人間による実装が必要
• wontfix — 対応しない

triage されたすべての issue は、カテゴリ role と ステート role をそれぞれ 1 つずつ持つべきです。ステート role が競合する場合は、フラグを立てて maintainer に確認してから何もしないでください。

これらは正規の role 名です。issue tracker で実際に使用されるラベル文字列は異なる場合があります。マッピングはあなたに提供されているはずです。提供されていない場合は /setup-matt-pocock-skills を実行してください。

ステート遷移: ラベルなしの issue は通常 needs-triage に最初に移動し、そこから needs-info、ready-for-agent、ready-for-human、または wontfix に移動します。needs-info は、報告者が返信すると needs-triage に戻ります。maintainer はいつでもオーバーライドできます。通常と異なる遷移には必ずフラグを立てて、進む前に確認してください。

Invocation

maintainer は /triage を起動し、自然言語で何をしたいかを説明します。リクエストを解釈して対応してください。例:

• "Show me anything that needs my attention"
• "Let's look at #42"
• "Move #42 to ready-for-agent"
• "What's ready for agents to pick up?"

Show what needs attention

issue tracker にクエリを実行し、3 つのバケットを古い順に表示します:

1. Unlabeled — triage されたことがない。
2. needs-triage — 評価進行中。
3. needs-info with reporter activity since the last triage notes — 再評価が必要。

件数と issue ごとの 1 行のサマリーを表示します。maintainer に選択させます。

Triage a specific issue

1. Gather context. issue の全文(body、コメント、ラベル、報告者、日付)を読む。以前の triage ノートを解析して、解決済みの質問を再度質問しないようにする。プロジェクトのドメイン用語集を使用してコードベースを探索し、エリア内の ADR を尊重する。.out-of-scope/*.md を読み、この issue に類似した以前の却下がないか検出する。

2. Recommend. カテゴリと ステートの推奨事項を理由とともに maintainer に伝え、plus issue に関連するコードベースの簡潔なサマリーを提供します。指示を待つ。

3. Reproduce (bugs only). グリリングの前に、再現を試みてください: 報告者のステップを読む、関連するコードをトレースする、テストまたはコマンドを実行する。何が起こったかを報告する — 成功した再現(コードパス付き)、失敗した再現、または不十分な詳細(強力な needs-info シグナル)。確認された再現は、より強力な agent brief につながります。

4. Grill (if needed). issue を具体化する必要がある場合は、/grill-with-docs セッションを実行してください。

5. Apply the outcome:

   • ready-for-agent — agent brief コメントを投稿 (AGENT-BRIEF.md)。
   • ready-for-human — agent brief と同じ構造だが、委任できない理由(判断、外部アクセス、デザイン決定、手動テスト)を注記。
   • needs-info — triage ノートを投稿(以下のテンプレート)。
   • wontfix (bug) — 丁寧な説明を行い、close。
   • wontfix (enhancement) — .out-of-scope/ に書き込み、コメントからリンク、close (OUT-OF-SCOPE.md)。
   • needs-triage — role を適用。部分的な進捗がある場合はオプションのコメント。

Quick state override

maintainer が「move #42 to ready-for-agent」と言う場合は、maintainer を信頼して role を直接適用します。実行する内容(role 変更、コメント、close)を確認してから実行します。grilling をスキップします。grilling セッションなしで ready-for-agent に移動する場合は、agent brief を書きたいかどうか尋ねてください。

Needs-info template

## Triage Notes

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

- point 1
- point 2

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

- question 1
- question 2

grilling 中に解決されたすべてのことを「established so far」の下に記録して、作業が失われないようにします。質問は「please provide more info」ではなく、具体的で実行可能である必要があります。

Resuming a previous session

issue に以前の triage ノートが存在する場合は、それを読み、報告者が未解決の質問に答えたかどうかを確認し、続行する前に更新された見方を提示します。解決済みの質問を再度質問しないでください。