mcpField
T
triage

triage

github.com/coleam00開発23.8k283 回インストール1 日前に更新
リポジトリ

triage について

triageは、GitHubリポジトリのissue内容に基づいてラベルを付ける分類スキルです。現在のラベル体系を取得し、未ラベルのissue、すべてのオープンissue、指定番号や番号範囲を処理できます。

主な機能

  1. 01対象範囲によるissueの選択
  2. 02ラベルとissue詳細の取得
  3. 03種類、作業量、優先度、領域による分類
  4. 04既存ラベルの保持と不足分の追加
  5. 05適用ラベルと理由の要約

活用シーン

  1. 01新規の未ラベルissueの分類
  2. 02オープンissueの一括トリアージ
  3. 03指定issueのラベル確認と補完

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/coleam00/archon --skill triage

インストール後、Claude Code で/triageを入力して読み込まれたか確認します。

同梱ファイルworkshop-guide.md

詳細

GitHub イシューをトリアージする

適切なラベルを付けて、このリポジトリのイシューをトリアージします。

リポジトリのコンテキスト

  • 現在のリポジトリ: !gh repo view --json nameWithOwner -q .nameWithOwner 2>/dev/null || echo "unknown"
  • オープン中のイシュー: !gh issue list --state open --json number --jq 'length' 2>/dev/null || echo "?"
  • 既存のラベル: !gh label list --json name -q '.[].name' 2>/dev/null | head -20 || echo "none found"

対象範囲

引数に基づいてトリアージするイシューを決定します: $ARGUMENTS

引数動作
(空)ラベルが付いていないイシューのみ(デフォルト)
unlabeledラベルが1つも付いていないイシューのみ
allすべてのオープン中のイシュー
N特定のイシュー(例: 67)
N-M指定範囲のイシュー(両端を含む、例: 60-67)

手順

  1. 利用可能なラベルを取得する — gh label list --json name,description を実行し、ラベルの分類を確認します。ラベルは種類、作業量、優先度、領域のカテゴリに分類されています。

  2. 対象のイシューを取得する — 上記の対象範囲に基づきます。各イシューの本文全体を取得します。

    gh issue view {number} --json number,title,body,labels
    
  3. 各イシューについて:

    • タイトルと本文全体を注意深く読みます
    • 必要に応じて、コードベース(Glob、Grep、Read)を調べ、影響を受けるコードを把握します
    • 分類します: 種類を1つ、作業量を1つ、優先度を1つ、領域を1つ以上
    • 他のイシューとの関係(重複、関連、ブロック)を記録します
    • ラベルを適用します:
      gh issue edit {number} --add-label "type,effort/level,P#,area.domain"
      
    • ラベルがすでにすべて付いているイシュー(種類+作業量+優先度+領域)はスキップします
    • 一部のラベルが付いているイシューには、不足しているカテゴリのラベルのみを追加します
  4. トリアージの概要を出力します:

    ## Triage Summary
    
    | Issue | Title | Labels Applied | Reasoning |
    |-------|-------|----------------|-----------|
    | #67 | ... | bug, effort/low, P1, core.config | ... |
    
    **Totals:**
    - Issues triaged: X
    - Already labeled (skipped): Y
    - By priority: P0(n), P1(n), P2(n), P3(n)
    
    ## Relationships Discovered
    
    | Issues | Relationship | Notes |
    |--------|--------------|-------|
    | #61, #62 | Related | Both involve config/logging UX |
    

ルール

  • ラベルをハードコードしない — ラベルは変更される場合があるため、必ず最初に最新のラベルを取得します
  • 既存のラベルを尊重する — ラベルは削除せず、不足しているものだけを追加します
  • イシューの本文を確認する — タイトルだけではコンテキストが不十分です
  • コードベースを活用する — モジュール間のつながりを確認しないと関係性を把握できない場合は、コードを調べます
  • 不確かな場合は記録する — 推測するのではなく、曖昧なイシューを概要で指摘します

コメント