teach | 把運作方式與理由講到能理解
本頁以 pstack-claude 0.9.126 為基準。teach 把系統是什麼、如何運作與為何如此連成一段易懂的說明，目標是理解而不是改程式。
定位與適用情境
你正在審查搜尋載入的變更，能閱讀元件程式碼，卻不熟悉索引初始化與快取。讓代理從你正在做的事出發，先講足以理解這次變更的機制，再依你的追問深入。
它不是一次交付完整教科書，也不以列出函式名稱代替教學。原文要求回覆就是解說本身，不是「我已完成三項調查」的工作報告。
準備
提供變更差異、要理解的子系統與你的目的。說明自己已懂什麼即可，不需先接受測驗。若你只想理解，不授權修改，請明確寫出。
Claude Code 可用 /pstack:teach。Codex 插件可從 $ 技能選單插入 $pstack:teach。先核對能否實際呼叫 how、why 及所需查閱工具；不能以口頭宣稱取代技能調查。
操作步驟
- 指定想理解的成果。例如看完後能說明第一次搜尋如何取得索引，以及後續搜尋重用什麼。
- 讓代理先讀程式定位，再依範圍呼叫
how與why。子系統通常兩者並行，小變更可能只需其中一項。若縮小歷史調查，要在需求中明說並保留來源缺口。 - 先看一至兩句完整解釋，再選擇要追問執行順序、設計理由或邊界情況。不要以一整頁前言替代答案。
- 涉及三個以上互動部分時，要求逐張增加一個部分的圖。核對圖中的名稱與程式碼一致，最後用原始輸入追蹤一次流程。
可直接使用的提示詞
用 pstack:teach 教我理解這次搜尋索引載入變更，先不要改程式。
我能讀元件，但不熟悉索引初始化與快取；我正在審查這個變更。
請先定位實作，實際使用 how 和 why 查運作及理由。
why 先限於授權的 git 與我提供的 PR 內容，列明未搜尋的來源與原因。
先用一兩句講清楚，再依我的問題深入，不測驗我，也不要一次列出所有函式。
若流程有三個以上部分，逐張增加一個部分；不把推測的理由說成事實。預期結果與驗收
第一段就應回答這個機制是什麼，以及它在此處解決什麼問題。後續可沿使用者操作連到資料流與歷史理由，並保留 why 結果中的「可能」「尚無證據」等限定。
你應能從圖或文字追蹤第一次與第二次搜尋的差異。若解說只剩檔案索引，或把所有部分一次塞進一張複雜圖，就未達原文的分層教學方式。這是理解檢查，不是要求讀者背誦或接受考試。
限制與權限
教學不授權修改實作。歷史查核仍受來源與存取權限限制，不能因想講得順就填補不存在的理由。小範圍調查不應包裝成完整歷史調查。
空間配置、捲動位置等問題，原文要求使用可用的圖像生成工具輔助說明。工具不存在時要揭露限制，不能假稱已生成或看過圖片。純流程可用合適的文字圖或圖表，單一簡單概念不必硬加圖。