🏷️ Issue Analysis with Label Inference

Version: 2.0.0 Last Updated: 2025-11-22 Priority: ⭐⭐⭐⭐ (P1 Level) Purpose: AI駆動のIssue分析と57ラベルシステムからの自動推論

📋 概要

Miyabiの57ラベルシステム（11カテゴリ）に基づいたAI駆動のIssue分析と 自動ラベル推論を実行します。

🎯 P0: 呼び出しトリガー

トリガー 例

ラベル質問 "what labels should I use?"

Issue分析 "analyze this Issue", "triage issue #270"

ラベル推論 "infer labels for this Issue"

Issue作成後 Issue作成後の自動処理

バックログ管理 "prioritize backlog"

🔧 P1: ラベルカテゴリ一覧

11カテゴリ・57ラベル

カテゴリ 数 必須/任意 用途

1 STATE 8 自動 ライフサイクル管理

2 AGENT 6 推奨 Agent割り当て

3 PRIORITY 4 必須 優先度管理

4 TYPE 7 必須 Issue分類

5 SEVERITY 4 条件 重大度（バグのみ）

6 PHASE 5 推奨 プロジェクトフェーズ

7 SPECIAL 7 条件 特殊フラグ

8 TRIGGER 4 自動 自動化トリガー

9 QUALITY 4 自動 品質スコア

10 COMMUNITY 4 推奨 コミュニティ

11 HIERARCHY 4 自動 Issue階層

🚀 P2: ラベル推論ルール

TYPE推論（必須・1個）

キーワード ラベル 例

"add", "implement", "create", "new" ✨ type:feature

新機能追加

"fix", "crash", "error", "broken" 🐛 type:bug

バグ修正

"docs", "README", "guide" 📚 type:docs

ドキュメント

"refactor", "cleanup", "reorganize" 🔧 type:refactor

リファクタ

"test", "coverage", "e2e" 🧪 type:test

テスト

"architecture", "system design" 🏗️ type:architecture

アーキテクチャ

"deploy", "CI/CD", "docker" 🚀 type:deployment

デプロイ

PRIORITY推論（必須・1個）

条件 ラベル SLA

セキュリティ、本番障害、データ損失 🔥 priority:P0-Critical

24時間

主要機能、重大バグ、性能劣化 ⚠️ priority:P1-High

3日

通常機能、標準バグ 📊 priority:P2-Medium

1週間

軽微改善、typo 📝 priority:P3-Low

なし

SEVERITY推論（条件付き・バグのみ）

条件 ラベル エスカレーション

本番停止、セキュリティ侵害 🚨 severity:Sev.1-Critical

Guardian + CISO

主要機能障害 ⚠️ severity:Sev.2-High

TechLead

部分的機能問題 📊 severity:Sev.3-Medium

Agent自動

軽微UI問題 📝 severity:Sev.4-Low

Agent自動

SPECIAL推論（条件付き）

キーワード ラベル アクション

"XSS", "SQL injection", "CVE" 🔐 security

CISO通知、Issue非公開

"Claude API", "high cost" 💰 cost-watch

予算監視

"depends on #", "blocked by" 🔄 dependencies

依存解決まで待機

"research", "investigate" 🎓 learning

SLA延長

"experiment", "POC" 🔬 experiment

失敗許容

COMMUNITY推論（推奨）

条件 ラベル

2時間以内、依存なし、明確な要件 👋 good-first-issue

外部専門知識が必要 🙏 help-wanted

HIERARCHY推論（自動）

条件 ラベル

親Issueなし 🌳 hierarchy:root

子Issueあり 📂 hierarchy:parent

親Issueあり 📄 hierarchy:child

子Issueなし（末端） 🍃 hierarchy:leaf

⚡ P3: 分析ワークフロー

Step 1: Issue内容読み取り

• タイトル
• 本文（説明）
• コメント（あれば）
• 関連Issue（リンク）

Step 2: キーワード抽出

• 技術キーワード: "security", "performance", "API"
• アクションキーワード: "add", "fix", "refactor"
• 緊急度キーワード: "urgent", "critical", "nice-to-have"

Step 3: 推論ルール適用

1. TYPE決定（必須、1個）
2. PRIORITY決定（必須、1個）
3. SEVERITY決定（バグ/インシデント時）
4. SPECIAL条件チェック
5. COMMUNITY適合性評価
6. HIERARCHY位置決定

Step 4: ラベルセット生成

{ "required": ["type:feature", "priority:P1-High"], "recommended": ["agent:codegen", "phase:planning"], "optional": ["security", "cost-watch"], "automatic": ["state:pending", "hierarchy:leaf"] }

📊 出力フォーマット

JSON形式

{ "issue_number": 270, "title": "XSS vulnerability in comment form", "analysis": { "type": "bug", "priority": "P0-Critical", "severity": "Sev.1-Critical", "estimated_time": "4-6 hours", "complexity": "medium", "agent_recommendation": "codegen + review", "escalation": "Guardian + CISO" }, "labels": { "required": ["type:bug", "priority:P0-Critical"], "recommended": ["severity:Sev.1-Critical", "security"], "automatic": ["state:pending", "hierarchy:leaf"] }, "rationale": { "type": "Keywords: 'vulnerability', 'XSS'", "priority": "Security issue with global impact", "severity": "Security vulnerability" } }

テキスト形式

🏷️ Issue Analysis Results

📋 Issue #270: XSS vulnerability in comment form

📊 Analysis:

• Type: bug (Keywords: 'vulnerability', 'XSS')
• Priority: P0-Critical (Security, global impact)
• Severity: Sev.1-Critical (Security vulnerability)
• Estimated: 4-6 hours
• Agent: codegen + review

🏷️ Labels: ✅ Required: type:bug, priority:P0-Critical 📎 Recommended: severity:Sev.1-Critical, security 🔄 Automatic: state:pending, hierarchy:leaf

⚠️ Escalation: Guardian + CISO (immediately)

🛡️ エラーハンドリング

キーワード検出失敗

デフォルトフォールバック

TYPE: type:feature (不明な場合) PRIORITY: priority:P2-Medium (不明な場合)

複数TYPE該当

優先順位で決定

bug > security > feature > docs > test > chore

コンフリクトするラベル

相互排他ラベルのチェック

state:pending ⊕ state:in-progress priority:P0 ⊕ priority:P1

✅ 成功基準

チェック項目 基準

TYPE推論 1個選択

PRIORITY推論 1個選択

SEVERITY推論 バグ時のみ

SPECIAL検出 該当時のみ

根拠提示 各ラベルに理由

エスカレーション 必要時に推奨

🔗 関連ドキュメント

ドキュメント 用途

docs/LABEL_SYSTEM_GUIDE.md

ラベルシステム詳細

.github/labels.yml

ラベル定義

agents/specs/coding/issue-agent.md

IssueAgent仕様

docs/ENTITY_RELATION_MODEL.md

エンティティ関係

📝 関連Skills

• Agent Execution: ラベル割り当て後のAgent実行

• Git Workflow: Issue解決後のコミット

• Rust Development: 実装品質チェック