issue-discuss

name	issue-discuss
description	將當前 LLM 對話討論轉為結構化 GitLab Issue，整合 issue-create 和 issue-split 功能。當使用者說「把討論建成 issue」、「discuss to issue」、「整理成 issue」、「從對話建立 issue」時觸發。

Issue Discuss

將當前與 Claude 的對話討論內容，智慧萃取並轉為結構化的 GitLab Issue。自動整合 /issue-create 和 /issue-split 的功能。

使用方式

基本用法（從當前對話萃取）

/issue-discuss

指定討論範圍

/issue-discuss 關於效能優化的部分

指定建立模式

/issue-discuss --mode=split 關於效能優化的部分

參數說明：

• 描述（可選）：限定要萃取的討論範圍，若未指定則分析整段對話
• --mode（可選）：
  • auto（預設）：AI 自動判斷該建立單一 Issue 或拆分多個
  • single：強制建立單一 Issue
  • split：強制拆分為多個 Issue

前置條件

需要 .issue-config.json 存在。按以下優先順序搜尋：

1. 專案目錄: ./.issue-config.json
2. 使用者目錄: ~/.claude/.issue-config.json

若均不存在，提示：「找不到 .issue-config.json，請先執行 /issue-init 建立設定。」

工作流程

1. 讀取設定

從搜尋到的 .issue-config.json 讀取所有相關設定（專案層級優先於使用者層級）。

2. 對話內容萃取

AI 分析當前對話上下文，萃取：

• 核心問題/需求：討論的主要議題
• 達成的共識：已確定的方向和決策
• 行動項目：需要執行的具體任務
• 技術細節：討論中提到的技術方案、限制、注意事項
• 未解決的問題：需要後續跟進的議題

3. 結構化分析

AI 根據萃取結果進行判斷：

單一需求（mode=single 或 auto 判斷為單一）：

• 生成一個結構化的 Issue
• 呼叫 /issue-create 的邏輯

複合需求（mode=split 或 auto 判斷為多個）：

• 識別多個獨立的子需求
• 先建立主 Issue，再呼叫 /issue-split 的邏輯拆分

判斷依據：

• 討論中提到的獨立行動項目數量
• 是否涉及多個模組/專案
• 是否有明確的階段性區分

4. 預覽萃取結果

使用 AskUserQuestion 展示萃取結果：

問題：「以下是從對話中萃取的 Issue 內容，請確認」

單一 Issue 模式：

📋 萃取結果（單一 Issue）

標題: [Feature] 實作使用者通知系統
專案: BizForm/Home
Labels: feature, backend, frontend

描述:
  ## 背景
  （從對話中萃取的背景說明）

  ## 討論摘要
  （關鍵決策和共識）

  ## 驗收條件
  - [ ] （從對話中萃取的行動項目）

  ## 技術備註
  （討論中提到的技術方案）

  ---
  > 📝 本 Issue 由 Claude Code /issue-discuss 從對話中自動產生

多 Issue 模式：

📋 萃取結果（多個 Issue）

主 Issue: 效能優化計畫 - 移除 pagesize=0
子 Issue：
  1. API 層移除 pagesize=0 預設值
  2. 前端分頁元件重構
  3. 資料庫查詢優化

選項：

1. 確認，建立 Issue
2. 修改萃取內容
3. 切換模式（單一 ↔ 拆分）
4. 取消

5. 建立 Issue

根據確認的模式執行：

單一模式：

• 使用 mcp__GitLab_communication_server__create_issue 建立 Issue
• 在描述末尾加入「本 Issue 由 Claude Code 對話自動產生」的標註

拆分模式：

• 先建立主 Issue
• 再逐一建立子 Issue
• 使用 mcp__GitLab_communication_server__create_issue_link 建立關聯

6. 完成訊息

單一模式：

✓ Issue 已從對話建立: #456 - [Feature] 實作使用者通知系統
  URL: https://gitlab.example.com/BizForm/Home/-/issues/456

拆分模式：

✓ 已從對話建立 1 個主 Issue + 3 個子 Issue：

  主 Issue:
  #456 - 效能優化計畫 - 移除 pagesize=0
    URL: https://gitlab.example.com/BizForm/Home/-/issues/456

  子 Issue:
  #457 - API 層移除 pagesize=0 預設值
  #458 - 前端分頁元件重構
  #459 - 資料庫查詢優化

GitLab MCP 工具使用

步驟	工具	用途
重複檢查	list_issues	搜尋相似 Issue
建立 Issue	create_issue	建立主 Issue / 子 Issue
建立關聯	create_issue_link	建立 Issue 間關聯

對話萃取品質保證

• 優先萃取明確的決策和行動項目，而非討論過程
• 技術細節以結論為主，不逐一列出所有討論的方案
• 若對話過長，聚焦在最近的討論內容
• 未解決的問題標記為 <!-- TODO: 需進一步討論 -->

注意事項

• 所有 Issue 描述末尾會加入來源標註
• 萃取結果需使用者確認後才建立
• 不會修改或刪除對話中的任何內容
• 若對話中沒有可萃取的行動項目，會提示使用者