triage-issues

注：ローカルに mcporter がインストールされている場合は、MCP ツールを直接呼び出すのではなく、mcporter を使って呼び出してください。mcporter CLI は、より便利なインターフェースと優れたエラー処理を提供します。

Gitee MCP を使った Issue のトリアージ

リポジトリの Issue を一括処理します。優先度の分類、ラベルの追加、重複の特定を行い、明確なアクションリストを作成します。

前提条件

• Gitee MCP サーバーが設定済みであること（ツール：list_repo_issues、get_repo_issue_detail、update_issue、create_comment（resource_type: issue））
• ユーザーが指定する必要がある情報：リポジトリのオーナー、リポジトリ名
• 任意：フィルター条件（バグのみ／未割り当てのみ／特定のマイルストーンなど）

手順

ステップ 1：Issue の一覧を取得する

list_repo_issues を使用して、オープン中の Issue を取得します。

• state：open（オープン中の Issue のみ）
• Issue が多い場合はページネーションを行います（1 ページあたり 20 件）

ステップ 2：一括分析

各 Issue をすばやく評価します。

種類の分類（ラベルを使用）

種類	ラベル	説明
バグ	bug	何かが正常に動作しない、エラーが発生する、またはクラッシュする
機能	feature	新しい機能のリクエスト
機能改善	enhancement	既存機能の改善
質問	question	使用方法に関する質問
ドキュメント	docs	ドキュメント関連
重複	duplicate	既存の Issue と同じ内容

よく使用される追加ラベル

ラベル	用途
help wanted	外部からの貢献が必要
wontfix	対応しない
invalid	無効またはスパム
security	セキュリティ関連
performance	パフォーマンス関連
ui/ux	ユーザーインターフェースの改善
backend	バックエンド関連
frontend	フロントエンド関連

優先度の評価

• P0 - Critical：中核機能に影響する、本番環境のバグ、セキュリティ脆弱性
• P1 - High：重大な機能上の不具合、多数のユーザーに影響する
• P2 - Medium：一般的な改善、回避策がある
• P3 - Low：あると便利な機能、外観上の改善

ステータスの評価

• 再現手順が十分かどうか（バグの場合）
• 追加情報が必要かどうか
• すでに対応中の PR があるかどうか

ステップ 3：トリアージレポートを作成する

構造化されたレポートを出力します。

## Issue Triage Report
Repository: [owner/repo]
Date: [date]
Total open issues: [N]

---

### 🔴 P0 Critical (needs immediate attention)
| # | Title | Type | Labels | Note |
|---|-------|------|--------|------|
| #N | [title] | bug | bug, security | [one sentence explaining urgency] |

### 🟠 P1 High Priority
| # | Title | Type | Labels | Note |
|---|-------|------|--------|------|

### 🟡 P2 Medium Priority
| # | Title | Type | Labels | Note |
|---|-------|------|--------|------|

### 🟢 P3 Low Priority
| # | Title | Type | Labels | Note |
|---|-------|------|--------|------|

---

### Needs More Information
- #N [title]: [what information is missing]

### Possible Duplicates
- #N may be a duplicate of #M: [explanation]

### Recommended for Closure
- #N [title]: [reason, e.g., long inactive / already resolved another way]

ステップ 4：Issue のラベルを更新する（ユーザーの確認が必要）

ラベルと優先度を自動的に更新するか、ユーザーに確認します。

確認後、update_issue を使用して次の操作を行います。

• 種類のラベルを追加します（bug、feature、enhancement、question、docs、duplicate）
• 状況に応じて追加のラベルを付けます（help wanted、security など）
• 優先度の表示を追加します（リポジトリでサポートされている場合）

ラベルの割り当て例：

• バグ報告 → bug ラベルを追加
• 説明が十分な機能リクエスト → feature ラベルを追加
• 機能改善の提案 → enhancement ラベルを追加
• 簡単な質問 → question ラベルを追加
• 外部からの協力が必要 → help wanted を追加

追加情報が必要な Issue には、create_comment（resource_type: issue）を使用して、次のように質問します。

Thanks for submitting this issue!

To help us address it more effectively, could you please provide:
- [Missing reproduction steps]
- [Environment and version info]
- [Expected behavior vs. actual behavior]

Thank you!

注意事項

• トリアージでは分類と整理に重点を置き、各 Issue の技術的な詳細を深く掘り下げる必要はありません
• 意図しない変更を防ぐため、一括更新を行う前に必ずユーザーに確認してください
• Issue が 50 件を超える場合は、複数のバッチに分けて処理するか、特定のラベルで絞り込むことを検討してください
• コントリビューターが関心のある Issue を見つけやすいよう、一貫したラベルを使用してください
• まずリポジトリに既存のラベルがあるか確認してください。プロジェクトによっては、独自のラベル名を使用している場合があります