triage について
triageは、GitHubリポジトリのissue内容に基づいてラベルを付ける分類スキルです。現在のラベル体系を取得し、未ラベルのissue、すべてのオープンissue、指定番号や番号範囲を処理できます。
主な機能
- 01対象範囲によるissueの選択
- 02ラベルとissue詳細の取得
- 03種類、作業量、優先度、領域による分類
- 04既存ラベルの保持と不足分の追加
- 05適用ラベルと理由の要約
活用シーン
- 01新規の未ラベルissueの分類
- 02オープンissueの一括トリアージ
- 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) |
手順
-
利用可能なラベルを取得する —
gh label list --json name,descriptionを実行し、ラベルの分類を確認します。ラベルは種類、作業量、優先度、領域のカテゴリに分類されています。 -
対象のイシューを取得する — 上記の対象範囲に基づきます。各イシューの本文全体を取得します。
gh issue view {number} --json number,title,body,labels -
各イシューについて:
- タイトルと本文全体を注意深く読みます
- 必要に応じて、コードベース(
Glob、Grep、Read)を調べ、影響を受けるコードを把握します - 分類します: 種類を1つ、作業量を1つ、優先度を1つ、領域を1つ以上
- 他のイシューとの関係(重複、関連、ブロック)を記録します
- ラベルを適用します:
gh issue edit {number} --add-label "type,effort/level,P#,area.domain" - ラベルがすでにすべて付いているイシュー(種類+作業量+優先度+領域)はスキップします
- 一部のラベルが付いているイシューには、不足しているカテゴリのラベルのみを追加します
-
トリアージの概要を出力します:
## 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 |
ルール
- ラベルをハードコードしない — ラベルは変更される場合があるため、必ず最初に最新のラベルを取得します
- 既存のラベルを尊重する — ラベルは削除せず、不足しているものだけを追加します
- イシューの本文を確認する — タイトルだけではコンテキストが不十分です
- コードベースを活用する — モジュール間のつながりを確認しないと関係性を把握できない場合は、コードを調べます
- 不確かな場合は記録する — 推測するのではなく、曖昧なイシューを概要で指摘します
コメント
Markdown 対応