Menú
調查 Bug 過程中隨時將 log、SQL、判斷、截圖更新到該 Bug 的 Notion 頁面，並支援重新開啟已結案 Bug。當使用者提到 /bug-update、「更新 bug 頁面」、「補充 bug 資訊」、「reopen bug」、「bug 復發」時觸發此 Skill。
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
CREW 環境健診 —— 一次性檢查 CREW 所有必要與選配依賴（Node/Git/Notion MCP/Agent Teams/瀏覽器 MCP/config/專案註冊/CLAUDE.md），列出綠黃紅燈與修法。當使用者提到 /crew-doctor、「CREW 環境健診」、「CREW 為什麼不能用」時觸發此 Skill。
瀏覽與探索已有的 .spec/ 規劃文件 —— 深度閱讀、跨任務比較、模式搜尋。當使用者提到 /plan-browse、「瀏覽 .spec 規劃」、「看之前的規劃設計」時觸發此 Skill。
從 .spec/{slug}/plan.md 以 Agent Teams leader-delegate 模式產生程式碼，含退出驗證與錨點有效性檢查，Leader 只協調不寫 code。當使用者提到 /plan-build、「從 spec 產生程式碼」、「plan-build 產碼」時觸發此 Skill。
結案前先跑文件漂移硬關卡（FAIL 擋、WARN 需明示放行），通過後蓋章 verified_at_commit、提交 Git、批次同步 plan.md 與 deploy.sql 到 Notion。當使用者提到 /plan-close、「feature 結案」、「同步 spec 到 Notion 並結案」時觸發此 Skill。
智慧推薦 CREW 當前任務下一步 —— 呼叫 crew-state.py 讀 state.json 算出下一個 /plan-* 指令並轉成人話。當使用者提到 /plan-next、「CREW 下一步指令」、「這個 spec 接下來做什麼」時觸發此 Skill。
CREW 規劃 —— spec / db / arch 三個 pass 把決策與驗收條件寫進 .spec/{slug}/plan.md，DB 設計另產 deploy.sql（零 Notion 呼叫）。當使用者提到 /plan、「CREW 完整規劃」、「一次跑完 spec/db/arch」時觸發此 Skill。
| name | bug-update |
| description | 調查 Bug 過程中隨時將 log、SQL、判斷、截圖更新到該 Bug 的 Notion 頁面，並支援重新開啟已結案 Bug。當使用者提到 /bug-update、「更新 bug 頁面」、「補充 bug 資訊」、「reopen bug」、「bug 復發」時觸發此 Skill。 |
在調查 Bug 期間，將關鍵 Log、SQL 查詢、初步判斷、問題描述補充等資訊，即時寫入 Notion「任務追蹤工具」的 Bug 頁面對應區塊。
也支援將已結案（測試中/已完成）的 Bug 重新開啟（reopen），適用於上線後發現問題未完全修復的情境。
/bug-start 建立 Bug 條目前置檢查：參照 plugin 根目錄
references/prerequisites.md（相對 SKILL.md 為../../references/）執行完整前置檢查（CLAUDE.md + 設定檔 + 專案註冊）。
根據使用者輸入判斷是「一般更新」還是「重新開啟」：
reopen、重新開啟、復發、退回 → Reopen 模式（跳至步驟 1-B）參照 plugin 根目錄 references/locate-bug.md（相對 SKILL.md 為 ../../references/）。選定後，使用 notion-fetch 取得頁面完整內容，以便後續 update_content 操作。
Reopen 模式需要定位「測試中」或「已完成」的 Bug。
Step 1 — 解析使用者輸入
| 使用者輸入 | 判斷 |
|---|---|
包含 Notion URL（notion.so/ 或 notion.site/） | → 直接定位模式：以 URL 中的 page_id 定位頁面 |
| 包含非 URL 文字 | → 關鍵字搜尋模式：在「任務追蹤工具」Data Source 中搜尋「測試中」+「已完成」的 Bug，以關鍵字匹配標題 |
什麼都沒提供（僅 reopen） | → 互動式清單模式 |
Step 2 — 互動式清單模式（無參數時）
當使用者只輸入 /bug-update reopen，不帶任何參數時：
notion-search 搭配 data_source_url: collection://{任務追蹤工具 Data Source ID}，搜尋狀態為「測試中」或「已完成」且所屬專案匹配的 Bug（按建立時間降序，最多顯示 10 筆）偵測到 Git Repo：ORG01P2401/sample-app
以下為該專案近期已結案的 Bug：
1. [2026-03-15] 訂閱推播開封數欄位與點擊率公式不一致
2. [2026-03-12] customAggregationUnits 含連字號導致 LINE API 400 錯誤 ⭐ 推薦（符合當前分支）
3. [2026-03-10] 傳送數重複計算與 API 回應格式處理
請選擇要重新開啟的 Bug：
• 輸入編號（如 1）
• 輸入關鍵字搜尋更多
• 貼上 Notion 頁面連結
Step 3 — 定位失敗處理
若以上方式都找不到目標 Bug：
找不到符合條件的已結案 Bug，請嘗試：
1. 貼上 Notion 頁面連結（在 Notion 找到該 Bug 頁面，複製連結）
2. 提供更精確的關鍵字
3. 切換到當初的修復分支後重試
定位成功後，執行 Reopen 操作：
notion-update-page 將狀態從「測試中/已完成」改回「進行中」notion-update-page 的 update_content，在「驗證」區塊之前插入「復發紀錄」區塊：---
## 🔄 復發紀錄
### [{日期} 復發] {使用者提供的復發說明，若無則留空待補}
- **復發環境**：{若使用者有提供則填入，否則留空}
- **復發現象**：{若使用者有提供則填入，否則留空}
- **前次修復為何無效**：
---
- [ ]）Bug 已重新開啟，後續可使用：
• /bug-update <調查內容> — 補充新的調查資訊
• /bug-close — 二次修復完成後結案
根據使用者輸入的內容，自動判斷應更新哪個區塊：
| 使用者輸入特徵 | 目標區塊 | 說明 |
|---|---|---|
| 包含「通報」、「回報」、「反映」、機關名稱 | 問題描述 > 通報來源 | 補充通報來源 |
| 包含重現步驟描述（「先...再...然後...」） | 問題描述 > 重現步驟 | 填入具體步驟 |
| 包含「預期」、「應該」 | 問題描述 > 預期行為 | 填入預期行為 |
| 包含 log、stacktrace、Exception、ERROR | 調查過程 > 關鍵 Log | 以 code block 格式貼入 |
| 包含 SQL、select、update、insert | 調查過程 > 相關 SQL 查詢 | 以 sql code block 格式貼入 |
| 包含「判斷」、「推測」、「可能是」、「初步」 | 調查過程 > 初步判斷 | 寫入判斷內容 |
| 使用者明確指定區塊 | 指定區塊 | 依使用者指示 |
若無法自動判斷，詢問使用者要更新哪個區塊。
/bug-update 關鍵 log：NullPointerException at PushService.java:235
其他區塊寫法同理（通報來源：、初步判斷：…），完整範例見下方「快捷用法彙整」。
使用者可直接貼入多行 log 或 SQL：
/bug-update
然後 Claude Code 會詢問「請貼上要更新的內容」，使用者貼入後自動判斷類型並更新。
/bug-update log /opt/tomcat/logs/catalina.out
讀取指定 log 檔案的最後 50 行，擷取 ERROR/Exception 相關內容，寫入「關鍵 Log」。
使用 notion-update-page 的 update_content 指令：
原則：
[HH:mm] 時間標記，方便追溯調查過程向使用者回傳：
/bug-update 通報來源：公共運輸處窗口 → 更新問題描述
/bug-update 預期行為：應正常顯示使用者列表 → 更新問題描述
/bug-update 重現步驟：1.登入後台 2.點選使用者管理 3.搜尋「嵇南淩」 → 更新問題描述
/bug-update <直接貼 stacktrace> → 更新關鍵 Log
/bug-update <直接貼 SQL> → 更新相關 SQL 查詢
/bug-update 初步判斷：employees 表 status=99 → 更新初步判斷
/bug-update log /path/to/catalina.out → 從檔案擷取 ERROR 寫入關鍵 Log
/bug-update reopen → 顯示該專案近期已結案 Bug 清單，互動式選擇
/bug-update reopen SSO登入找不到使用者 → 用關鍵字搜尋已結案 Bug
/bug-update reopen https://www.notion.so/abe41af9... → 直接指定 Notion 頁面連結
/bug-update reopen SSO登入 正式環境仍出現相同錯誤 → 關鍵字 + 復發說明一起提供
更多範例（Log 貼入、SQL 查詢記錄、初步判斷、Reopen 復發紀錄的完整輸入輸出對照）見 examples/update-patterns.md（相對 SKILL.md 同層目錄）。
sync 組 —— 本 skill 只更新「單一 bug 頁面」；.spec 任務的中途同步與結案同步不在此列。
/bug-close/plan-sync/plan-close/bug-startnotion-update-page 的 update_content 對同一區塊寫入時會覆蓋該區塊內容。多次寫同一區塊時，必須先 notion-fetch 取得現有內容，串接新內容後再寫回，否則會覆蓋之前的調查紀錄。to_do block，用 update_content 改 checked 狀態即可；用 replace_content 會意外刪除使用者手動新增的內容。[HH:mm] 標記要用 24 小時制本地時區。Claude 預設 UTC，需用 date 指令取本地時間（如 date +%H:%M）再填入。/bug-setup 完成初始設定... (省略 N 行) ... 替代