批量整理舊有 GitLab Issue,補充標籤、建立關聯、重新分類。當使用者說「整理 issue」、「organize issues」、「清理 issue」、「整理舊 issue」時觸發。
批量智慧整理舊有 GitLab Issue。AI 分析所有 Issue 後,建議標籤補充、關聯建立、描述完善等改進方案,經確認後批量執行。
/issue-organize
/issue-organize --milestone="Sprint 60"
/issue-organize --labels=backend,performance
/issue-organize --state=all
參數說明:
--milestone(可選):限定特定里程碑的 Issue--labels(可選):限定特定標籤的 Issue--state(可選):opened(預設)/ closed / all--limit(可選):最多處理的 Issue 數量(預設來自 config 的 batchLimit)需要 .issue-config.json 存在。按以下優先順序搜尋:
./.issue-config.json~/.claude/.issue-config.json若均不存在,提示:「找不到 .issue-config.json,請先執行 /issue-init 建立設定。」
從搜尋到的 .issue-config.json 讀取(專案層級優先於使用者層級):
gitlab.defaultProjectPathdefaults.batchLimit(預設 50)defaults.dryRun(預設 true)organize.staleDays(預設 90)organize.autoLabels(預設 true)templates(用於分類參考)使用 mcp__GitLab_communication_server__list_issues 取得目標範圍的 Issue:
使用 mcp__GitLab_communication_server__list_labels 取得專案現有標籤。
顯示:
📋 已載入 47 個 Issue(開放狀態)
現有 Labels: bug, feature, task, backend, frontend, ...
AI 對所有載入的 Issue 進行分析,產生「變更計畫」:
分析面向:
a. 標籤缺失或不一致
b. 可建立關聯的 Issue
c. 描述不完整
d. 過期 Issue 標記
以結構化格式顯示建議的變更:
📋 變更計畫(共 12 項建議)
【標籤補充】 5 個 Issue
┌─────┬────────────────────────┬───────────────┬──────────────────┐
│ IID │ 標題 │ 現有 Labels │ 建議新增 Labels │
├─────┼────────────────────────┼───────────────┼──────────────────┤
│ #89 │ 表單送出後沒有回應 │ (無) │ bug, frontend │
│ #92 │ 新增匯出 CSV 功能 │ feature │ backend │
│ #95 │ 重構 API 路由結構 │ (無) │ task, backend │
└─────┴────────────────────────┴───────────────┴──────────────────┘
【建議關聯】 3 組
┌──────────┬──────────┬──────────────────────────┐
│ Issue A │ Issue B │ 關聯原因 │
├──────────┼──────────┼──────────────────────────┤
│ #89 │ #91 │ 相似問題:表單送出相關 │
│ #92 │ #96 │ #96 的描述提到 #92 │
└──────────┴──────────┴──────────────────────────┘
【過期標記】 4 個 Issue
#45, #52, #61, #68 - 超過 90 天未更新
使用 AskUserQuestion:
若選擇「逐項確認」,對每個變更逐一詢問。
dryRun 判斷邏輯:
若 defaults.dryRun 為 true:
若 defaults.dryRun 為 false(或使用 --execute 參數),依確認的變更計畫批量執行:
mcp__GitLab_communication_server__update_issue(更新 labels)mcp__GitLab_communication_server__create_issue_link(建立 relates_to)mcp__GitLab_communication_server__update_issue(新增 stale 標籤)每處理 10 個 Issue 回報一次進度:
⏳ 進度: 10/12 項變更已執行...
✓ Issue 整理完成!
執行摘要:
✓ 標籤補充: 5 個 Issue 已更新
✓ 關聯建立: 3 組關聯已建立
✓ 過期標記: 4 個 Issue 已標記 stale
跳過: 0 項(全部成功)
| 步驟 | 工具 | 用途 |
|---|---|---|
| 載入 Issue | list_issues | 批量取得 Issue 清單 |
| 載入標籤 | list_labels | 取得現有標籤 |
| 查詢關聯 | list_issue_links | 檢查既有關聯 |
| 更新 Issue | update_issue | 補充標籤、描述 |
| 建立關聯 | create_issue_link | 建立 Issue 間關聯 |
| 建立標籤 | create_label | 若需要的標籤不存在 |