jpskill.com
🛠️ 開発・MCP コミュニティ

triage

Triage issues through a state machine driven by triage roles. Use when user wants to create an issue, triage issues, review incoming bugs or feature requests, prepare issues for an AFK agent, or manage issue workflow.

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux 
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o triage.zip https://jpskill.com/download/19635.zip && unzip -o triage.zip && rm triage.zip
🪟 Windows (PowerShell) 
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/19635.zip -OutFile "$d\triage.zip"; Expand-Archive "$d\triage.zip" -DestinationPath $d -Force; ri "$d\triage.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して triage.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → triage フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動
⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-18
取得日時
2026-05-18
同梱ファイル
1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

トリアージ

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

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

> *This was generated by AI during triage.*

参考ドキュメント

役割

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. Unlabeled — まだトリアージされていない。
  2. needs-triage — 評価中。
  3. needs-info with reporter activity since the last triage notes — 最後のトリアージノート以降に報告者の活動があったため、再評価が必要。

件数と各課題の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 に移動する場合、エージェントブリーフを作成したいかどうかを尋ねます。

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

質問中に解決されたすべてのことを「これまでに確立されたこと」の下に記録し、作業が失われないようにします。質問は具体的で実行可能である必要があり、「詳細を提供してください」のようなものであってはなりません。

以前のセッションの再開

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

📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Triage

Move issues on the project issue tracker through a small state machine of triage roles.

Every comment or issue posted to the issue tracker during triage must start with this disclaimer:

> *This was generated by AI during triage.*

Reference docs

Roles

Two category roles:

  • bug — something is broken
  • enhancement — new feature or improvement

Five state roles:

  • needs-triage — maintainer needs to evaluate
  • needs-info — waiting on reporter for more information
  • ready-for-agent — fully specified, ready for an AFK agent
  • ready-for-human — needs human implementation
  • wontfix — will not be actioned

Every triaged issue should carry exactly one category role and one state role. If state roles conflict, flag it and ask the maintainer before doing anything else.

These are canonical role names — the actual label strings used in the issue tracker may differ. The mapping should have been provided to you - run /setup-matt-pocock-skills if not.

State transitions: an unlabeled issue normally goes to needs-triage first; from there it moves to needs-info, ready-for-agent, ready-for-human, or wontfix. needs-info returns to needs-triage once the reporter replies. The maintainer can override at any time — flag transitions that look unusual and ask before proceeding.

Invocation

The maintainer invokes /triage and describes what they want in natural language. Interpret the request and act. Examples:

  • "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

Query the issue tracker and present three buckets, oldest first:

  1. Unlabeled — never triaged.
  2. needs-triage — evaluation in progress.
  3. needs-info with reporter activity since the last triage notes — needs re-evaluation.

Show counts and a one-line summary per issue. Let the maintainer pick.

Triage a specific issue

  1. Gather context. Read the full issue (body, comments, labels, reporter, dates). Parse any prior triage notes so you don't re-ask resolved questions. Explore the codebase using the project's domain glossary, respecting ADRs in the area. Read .out-of-scope/*.md and surface any prior rejection that resembles this issue.

  2. Recommend. Tell the maintainer your category and state recommendation with reasoning, plus a brief codebase summary relevant to the issue. Wait for direction.

  3. Reproduce (bugs only). Before any grilling, attempt reproduction: read the reporter's steps, trace the relevant code, run tests or commands. Report what happened — successful repro with code path, failed repro, or insufficient detail (a strong needs-info signal). A confirmed repro makes a much stronger agent brief.

  4. Grill (if needed). If the issue needs fleshing out, run a /grill-with-docs session.

  5. Apply the outcome:

    • ready-for-agent — post an agent brief comment (AGENT-BRIEF.md).
    • ready-for-human — same structure as an agent brief, but note why it can't be delegated (judgment calls, external access, design decisions, manual testing).
    • needs-info — post triage notes (template below).
    • wontfix (bug) — polite explanation, then close.
    • wontfix (enhancement) — write to .out-of-scope/, link to it from a comment, then close (OUT-OF-SCOPE.md).
    • needs-triage — apply the role. Optional comment if there's partial progress.

Quick state override

If the maintainer says "move #42 to ready-for-agent", trust them and apply the role directly. Confirm what you're about to do (role changes, comment, close), then act. Skip grilling. If moving to ready-for-agent without a grilling session, ask whether they want to write an 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

Capture everything resolved during grilling under "established so far" so the work isn't lost. Questions must be specific and actionable, not "please provide more info".

Resuming a previous session

If prior triage notes exist on the issue, read them, check whether the reporter has answered any outstanding questions, and present an updated picture before continuing. Don't re-ask resolved questions.