explainlisted
Install: claude install-skill wuchengwei1996/claude-skill-explain
# explain:先找理解斷點,再選橋
流程:1 前後文 → 2 缺口 → 3 概念 → 4 目標 → 5 方法 → 6 視覺 → 7 深度 →(比較任務加走 8)→ 產生說明 → 9 檢查 → 10 訊號(仍有落差→回 2 重定位、回 5 換方法)。
本檔只給流程、路由與檢查;路由命中的方法(Standard 亦然)必須讀 `references/` 取得執行順序與限制;沒有 session 證據時讀 `references/default-user.md`。
## 1. 前後文(Explanation Context Packet)
```yaml
explanation_context:
trigger:
type: proactive | explicit-explanation | comparison | confusion | re-pitch
user_words: "使用者實際表達"
target:
concept: "候選目標概念"
source_passage: "直接引發問題的內容"
task:
current_goal: "使用者正在完成什麼"
explanation_goal: "理解後需要做到什麼"
urgency: low | medium | high
stakes: low | medium | high
user_evidence:
demonstrated_knowledge: []
possible_gaps: []
preferences_observed: []
previous_attempts:
methods_used: []
what_failed: []
constraints:
desired_depth: micro | standard | deep | infer
preserve_terms: true
visual_allowed: true
```
**證據優先順序**:
1. 使用者這一輪的明確表達。
2. 直接引發問題的上一段內容或材料。
3. 當前任務與使用目的。
4. 本 session 已展現的理解與操作。
5. 前一次解釋使用的方法及失敗位置。
6. 預設使用者設定。
7. 一般「聰明但不熟悉此領域」假設。
**限制**:
- 不把使用術語本身當成理解該術語的證據。
- 不用舊推論否定使用者此刻明確表達的困惑。
- 不從語氣、拼字、語言流利度推論一般智力。
- 不把其他領域的專業程度直接轉移到當前領域。
- 不需要建立永久 common-ground ledger;只使用當前 session 可見證據。
## 2. 判斷器一:理解缺口定位
> 核心問題:使用者現在不能理解的確切內容是什麼?
| 缺口 | 判斷訊號 |
|---|---|
| 詞彙缺口 | 不知道名詞、縮寫或正式用語的意思 |
| 前置知識缺口 | 解釋依賴尚未建立的另一概念 |
| 結構缺口 | 知道零件,但不知道彼此關係 |
| 機制缺口 | 知道輸入與結果,不知道中間如何發生 |
| 因果缺口 | 不知道 A 為何導致 B |
| 邊界缺口 | 不知道何時成立、何時失效 |
| 比較缺口 | 知道個別定義,不知道差異維度與選擇含義 |
| 應用缺口 | 聽得懂,但不知道實際如何使用 |
| 數量直覺缺口 | 看得懂數字,不能