| name | oc-retro |
| description | Use when the session is ending, or when the user says '收工', 'session end', 'retro', 'takeaway', '記錄', '結束', 'bye', '先這樣', '今天到這', or signals session completion. |
oc-retro
回顧本次 session
先回顧對話歷史,整理以下 5 個面向:
- 完成項目 — 本次做了什麼(任務清單)
- 關鍵指令 — 執行的指令(標明 LOCAL 或 RPi4 環境)
- 遇到的問題 — 錯誤、踩坑、workaround
- 決策紀錄 — 為什麼選 A 不選 B(含 使用者 的判斷)
- 下次待辦 — 未完成的工作、需 使用者 手動處理的項目
輸出
Step 1: 寫入 session log
在 docs/session-logs/ 建立檔案,命名:YYYY-MM-DD-NN-<簡短主題>.md
序號 NN 從 01 起算,放在日期後、主題前,確保檔案按時序排列。
先 glob docs/session-logs/YYYY-MM-DD-* 取得當天最大序號,再 +1。
格式:
# Session YYYY-MM-DD — <主題>
## 完成項目
- ...
## 關鍵指令
| 指令 | 環境 | 用途 |
|------|------|------|
| `...` | LOCAL / RPi4 | ... |
## 遇到的問題
| 問題 | 原因 | 解法 |
|------|------|------|
| ... | ... | ... |
## 決策紀錄
| 決策 | 選項 | 原因 |
|------|------|------|
| ... | A vs B | ... |
## 學到的教訓
- ...
## 下次待辦
- [ ] ...
Step 2: 更新 MEMORY.md(條件性)
如果本次 session 有跨 session 需要持續記住的教訓(例如新發現的 SSH 地雷、config 陷阱),更新 MEMORY.md 對應段落。
不寫入一次性的 session 狀態(那些留在 session log 裡就好)。
Step 3: 向 使用者 摘要
在對話中輸出 session log 的摘要,讓 使用者 確認後再結束。