/close — 結案

/close — 結案

寫 closing comment，然後關閉 issue。三分鐘的紀錄，省三十分鐘的考古。

核心原則

沒有 closing comment 就不關 issue。沒有例外。

Execution

Step 1: 檢查前置條件

gh issue view $NUMBER --repo $GITHUB_REPO --json state,title,body

確認：

• Issue 是 open 狀態
• 有相關的 commit 引用 #NNN

git log --oneline --grep="#$NUMBER" | head -10

如果沒有相關 commit，警告使用者：「找不到引用 #NNN 的 commit。確定要關嗎？」

Step 2: 寫 Closing Comment

根據 issue body、diagnosis、commits 自動生成：

## Closing Summary

### Problem
{問題是什麼，影響範圍}

### Root Cause
{為什麼會發生（bug）/ 需求背景（feature）}

### Solution
{改了什麼，關鍵邏輯}

### Verification
{怎麼驗證的：verify 結果、測試、截圖}

### Changes
{相關 commit 列表}

Step 3: 確認

將 closing comment 顯示給使用者確認。

Step 4: 發佈並關閉

gh issue comment $NUMBER --repo $GITHUB_REPO --body "$CLOSING_COMMENT"
gh issue close $NUMBER --repo $GITHUB_REPO

數學公式格式：GitHub 支援 $...$（inline）和 $$...$$（display）。含底線的程式變數名不放 math mode，改用 backtick code。

Step 5: 回報

✓ Issue #NNN closed
  Closing comment: {URL}
  Commits: {list}

Closing Comment 的價值

沒有 closing comment	有 closing comment
三個月後：「這個 issue 改了什麼？」→ 翻 git log 猜	三個月後：直接看 closing comment
類似 bug 再出現：「上次怎麼修的？」→ 不知道	類似 bug 再出現：參考上次的 root cause + solution
新人接手：「為什麼這段 code 長這樣？」→ 沒人知道	新人接手：issue 裡有完整的脈絡

Auto-Update

Close 完成後，自動執行 idd-update 更新 issue body 的 Current Status（phase → closed）。

鐵律

• 不跳過 closing comment。即使是小 fix 也要寫。
• Closing comment 要有 Root Cause。「改了 X」不夠，要寫「因為 Y 所以改了 X」。
• 列出所有相關 commit。讓 issue 成為這次改動的完整入口。