Reflect

對話結束前的結構化反思。從本次對話中萃取值得長期保留的知識，避免同樣的坑踩兩次。

Step 0: 掃描對話

回顧完整對話歷史，標記以下事件：

任務清單

列出本次對話完成的所有任務：

任務描述（一句話）
結果：成功 / 部分成功 / 失敗
涉及的關鍵檔案

錯誤與阻塞

列出所有遇到的問題：

工具呼叫失敗
方向錯誤後修正
使用者否決的方案
重試或 workaround

使用者回饋

列出使用者的明確偏好表達：

「不要這樣做」「改用 X」
對產出品質的評價
工作流偏好

ARGUMENTS 過濾

如果 ARGUMENTS 指定了 focus，只深入分析對應類別。預設 all。

Step 1: 萃取學習

從 Step 0 的事件中萃取可複用的知識：

1A. 技術發現

工具/API 的非直覺行為
繞過限制的有效方法
效能觀察（什麼快、什麼慢）

1B. 模式識別

重複出現的工作流（值得自動化？）
本次對話中反覆使用的技巧
跨任務的共通解法

1C. 錯誤根因

每個錯誤的根本原因（不是表面症狀）
下次如何避免
是否為已知問題的新變體

1D. 使用者偏好

新發現的偏好（寫入 memory）
已知偏好的例外情況
溝通風格觀察

Step 2: 識別機會

2A. 新 Skill 機會

本次對話是否暴露了可做成 skill 的重複工作流？

判斷條件（至少符合 2 個）：

涉及 3+ 個步驟
未來可能重複使用
需要特定領域知識
目前沒有 skill 覆蓋

2B. 現有 Skill 改進

本次使用某個 skill 時是否遇到不足？

缺少的功能或參數
不準確的判斷規則
可精簡的流程步驟

2C. Memory 更新

哪些知識該寫入 MEMORY.md？

穩定的技術發現（跨多次互動確認）
使用者明確要求記住的偏好
專案架構的新理解

哪些 memory 該刪除或更新？

被本次發現推翻的舊記錄
已完成的待辦事項
過時的架構描述

Step 3: 呈現結果 + 互動執行

產出反思報告

## 對話反思

### 本次任務摘要
| 任務 | 結果 | 關鍵檔案 |
|------|------|---------|
| 建立 system-audit skill | ✅ 成功 | system-audit/SKILL.md |
| ... | | |

### 學習萃取
| # | 類別 | 洞察 | 建議動作 |
|---|------|------|---------|
| 1 | 技術發現 | hook 無法存取對話歷史 | 寫入 MEMORY.md |
| 2 | 使用者偏好 | 偏好合併相關 skill | 寫入 MEMORY.md |
| 3 | Skill 改進 | humanizer-tw 缺少 X | 開 task 追蹤 |

### 機會
- 🆕 新 skill：[描述]
- 🔧 改進 skill：[skill 名稱] — [改進項]
- 📝 Memory 更新：[新增/修改/刪除 項目]

AskUserQuestion 互動

用 multiSelect 讓使用者勾選要執行哪些動作：

寫入 memory：列出每條 memory entry 的內容預覽
改進 skill：列出要修改的 skill 和具體項目
建新 skill：列出 skill 名稱和核心功能描述
跳過：不執行任何動作

執行

使用者勾選的項目，逐一執行：

Memory → 用 Edit 工具更新 MEMORY.md
Skill 改進 → 開 task 或直接修改（視規模而定）
新 skill → 建立骨架 SKILL.md + 提示使用者後續完善

反思原則

只記穩定知識 — 單次對話的猜測不寫 memory，等多次確認
使用者明確要求除外 — 使用者說「記住這個」就直接記
根因優先 — 記錄為什麼出錯，不只是出了什麼錯
可行動 — 每條洞察都要有建議動作（寫 memory / 改 skill / 開 task）
不重複記錄 — 先查 MEMORY.md 有沒有類似條目，有就更新而非新增

Now Execute

從 Step 0 開始，回顧當前對話。

reflect