triage

トリアージ

プロジェクトの課題トラッカー上で、トリアージ担当の小さな状態遷移に沿って課題を移動させます。

トリアージ中に課題トラッカーへ投稿するコメントや課題は、すべて次の免責事項から始めなければなりません。

> *This was generated by AI during triage.*

参考ドキュメント

エージェント向けブリーフ

エージェント向けブリーフとは、課題に投稿する構造化されたコメントです。これにより、AFK エージェントが人間の手助けを受けずに修正や機能を実装するために必要な情報をすべて得られます。質の高いエージェント向けブリーフには、次の内容が含まれます。

• 背景：この課題が重要な理由、関連する背景情報、関連課題や ADR へのリンク
• 範囲：変更が必要な内容を正確に記載します。過不足のないようにします
• 受け入れ基準：「完了」を定義する、検証可能な条件のチェックリスト
• 関連ファイル：最初に確認すべき主要なファイルやモジュール（網羅的な一覧ではなく、入口となるものだけ）
• 制約：エージェントがしてはならないこと（例：無関係なコードをリファクタリングしない、公開 API を変更しない）

ブリーフは簡潔にまとめてください。エージェント向けブリーフはチュートリアルではなく、仕様です。エージェントはコードを読めるものとして、コードベースの内容をブリーフに書き写さないでください。

対象外のナレッジベース

.out-of-scope/ ディレクトリは、却下された機能を記録するナレッジベースです。各ファイルは、特定の機能改善が却下された理由を説明する短い Markdown ドキュメントです。次の形式に従います。

• wontfix の機能改善をクローズする際は、リクエストと却下の理由を記録したファイルを .out-of-scope/<slug>.md に作成します。
• 今後報告する人が理由を確認できるよう、課題のクローズコメントからそのファイルにリンクします。
• 新しい課題をトリアージする際は、.out-of-scope/*.md を読み、現在の課題に類似する過去の却下事例があれば提示します。これにより、すでに決着した議論の蒸し返しを防げます。

各 .out-of-scope/ ファイルには、機能リクエストの1行の概要、却下日、却下理由（技術面、製品面、または戦略面）、元の課題へのリンクを含めてください。

役割

カテゴリの役割は2つあります。

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

状態の役割は5つあります。

• needs-triage — メンテナーによる評価が必要
• needs-info — 報告者からの追加情報を待っている
• ready-for-agent — 仕様が完全で、AFK エージェントが着手できる
• ready-for-human — 人間による実装が必要
• wontfix — 対応しない

トリアージ済みの各課題には、カテゴリの役割を1つ、状態の役割を1つだけ付けてください。状態の役割が競合している場合は、フラグを立て、それ以外の作業に進む前にメンテナーに確認してください。

これらは標準の役割名です。課題トラッカーで実際に使用されているラベル文字列は異なる場合があります。プロジェクトの AGENTS.md または既存の課題ラベルを確認し、対応関係を調べてください。

状態遷移：ラベルのない課題は通常、最初に 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行の概要を表示します。メンテナーに選んでもらいます。

特定の issue をトリアージする

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

2. 推奨を提示します。 該当カテゴリと状態の推奨を、理由とともにメンテナーに伝えます。issue に関連するコードベースの概要も簡潔に添えます。指示を待ちます。

3. 再現します（バグのみ）。 質問攻めをする前に、再現を試みます。報告者の手順を読み、関連コードを追跡し、テストやコマンドを実行します。結果（コードパスを含む再現成功、再現失敗、または情報不足（強い needs-info の兆候））を報告します。再現が確認できれば、エージェント向けの依頼内容を大幅に充実させられます。

4. 質問します（必要な場合）。 issue の内容を具体化する必要がある場合は、利用可能であれば質問用スキルを使います。/grill-me がインストールされていれば呼び出し、利用できない場合は直接、掘り下げる質問をします。

5. 結果を適用します。

   • ready-for-agent — エージェント向けの依頼コメントを投稿します（上記の「エージェント向け依頼」セクションを参照）。
   • ready-for-human — エージェント向けの依頼と同じ構成にしますが、委任できない理由（判断が必要、外部アクセス、設計上の決定、手動テスト）を記載します。
   • needs-info — トリアージメモを投稿します（以下のテンプレートを参照）。
   • wontfix（バグ）— 丁寧に説明してから、クローズします。
   • wontfix（機能強化）— .out-of-scope/ に記録し、コメントからリンクしてから、クローズします（上記の「対象外ナレッジベース」セクションを参照）。
   • needs-triage — ロールを適用します。進捗が一部ある場合は、任意でコメントを投稿できます。

状態のクイック上書き

メンテナーが「#42 を ready-for-agent に移動して」と言った場合は、その指示を信頼し、ロールを直接適用します。実行する内容（ロールの変更、コメント、クローズ）を確認してから実行します。質問は省略します。質問セッションなしで ready-for-agent に移動する場合は、エージェント向けの依頼を作成するかどうか確認します。

Needs-info テンプレート

## Triage Notes

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

- point 1
- point 2

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

- question 1
- question 2

質問の過程で解決した内容はすべて「ここまでに確認できたこと」に記録し、作業の成果が失われないようにします。質問は具体的で実行可能なものにし、「詳細を教えてください」のような内容は避けます。

前回のセッションを再開する

issue に以前のトリアージメモがある場合は、それを読み、報告者が未回答の質問に答えているか確認してから、状況を更新して提示します。解決済みの質問を繰り返さないでください。