交叉比對智慧
wrapup 把多個來源的資料串起來：
- Git commit 與 筆記核取方塊 比對
- 決策 連到 程式碼變更
- bug 與 已修改的檔案 對應
- 循環狀態 整合進 任務進度
這種交叉比對拼出你整個會話的完整樣貌。
輸出區塊
| 區塊 | 說明 | 必填 |
|---|---|---|
| 完成 | 帶證據的已完成工作 | 是 |
| 決策 | 這次會話做的技術決策 | 有的話 |
| 變更 | 修改的關鍵檔案與程式碼區域 | 是 |
| 未完成 | 未完成的工作與剩餘項目 | 有的話 |
| 風險 | 真正辨識出的風險 | 有的話 |
| 後續 | 具體可執行的後續步驟 | 必填 |
「後續」區塊
這是最重要的區塊。它必須：
- 具體：「在
src/auth.ts:45加上 refresh token 邏輯」，而非「繼續 auth 工作」 - 可執行：新的會話只讀「後續」就該知道確切要做什麼
- 帶檔案參照：盡可能附上
file:line參照
品質標準：「哪個檔案、哪個函式、還剩什麼要做？」
風險偵測
風險區塊會標記真正的問題：
- 可能會遺失的未提交變更
- task loop 裡被擋住的任務
- 會話中發現的失敗測試
- 待解決的 merge conflict
泛泛的警告會被排除 — 只留具體、針對這次會話的風險。
智慧更新
搜尋目前會話是否已有 wrapup（不到 3 小時）。有的話就用新資料更新它，否則建立一則新的綠色筆記。這讓你的筆記保持乾淨 — 永遠是最新的摘要。
何時使用
在工作會話結束時執行 /note-wrapup，趁著：
- 切換到不同的專案前
- 休息前
- 交接給隊友前
- 一天結束前