跳到主內容

Theme / 0.9.130

Pstack

用可驗證的工作流程協作,從單一入口學會工程技能

Skills

how | 追蹤系統如何運作與責任歸屬

從程式碼追蹤執行流程、模組分層與責任邊界,依問題複雜度安排唯讀探索及解說。

how | 追蹤系統如何運作與責任歸屬

本頁以 pstack-claude 0.9.126 為基準。how 用程式碼解釋系統現在如何運作,建立足以接手維護的理解,不是逐行替原始碼加旁白。

定位與適用情境

你要維護搜尋功能,卻不知道查詢文字在哪裡正規化、索引由誰載入,以及結果如何進入畫面。提供入口與一組輸入,讓代理追蹤資料經過哪些模組。

「這段檢查屬於哪一層」也適用。若想知道當年為何選擇這種架構,改用 why,不要把目前的呼叫關係當成歷史動機。

準備

提供已授權的儲存庫、目前版本、入口路徑或符號,以及要追蹤的輸入。例如搜尋框輸入前後帶空白的關鍵字,詢問資料到結果顯示之間的流程。

Claude Code 可用 /pstack:how。Codex 插件可從 $ 技能選單插入 $pstack:how。先確認目前平台是否支援唯讀子代理(Subagent),以及模型設定中的探索與解說角色是否可用。

操作步驟

  1. 限定問題。單一函式採簡單路徑;跨搜尋介面、索引載入與結果渲染的問題才需要多角度探索。有歧義先說明採用的解讀。
  2. 簡單問題由一個解說代理自行探索並解釋,不額外派探索代理。複雜問題分成二至四個不重疊角度,同時唯讀查閱。
  3. 複雜問題等探索結果到齊後,交給一個解說代理統整。保留程式碼位置、資料轉換與責任邊界,不用猜測補齊缺失的服務。
  4. 對照解說走過一次指定輸入,確認能找到每個關鍵轉換的位置。要求將未讀到的外部實作標成缺口,不改檔案。

可直接使用的提示詞

用 pstack:how 解釋目前儲存庫的搜尋流程,先不要修改程式。
從搜尋框接收「  規格  」開始,追蹤文字處理、索引載入、查詢及結果顯示。
請先找實際入口,標出各層負責的資料轉換與檔案位置。
單一模組就採簡單路徑,跨模組才分角度探索。
若平台沒有子代理工具,請說明限制並明示改為順序查閱,不要假稱平行探索。
只解釋目前運作,不推測當初的設計動機。

預期結果與驗收

回覆可按概覽、關鍵概念、運作方式、程式位置與易錯處分段,不適用的段落可省略。你應能指出輸入在哪裡改變、誰擁有索引,以及結果由哪個元件呈現。

驗收時挑一項描述回查實際符號或呼叫端。若只有檔案清單而沒有順序與責任,就還不足以形成可用的心智模型(Mental model)。靜態查閱也不等於已執行端到端測試。

限制與權限

原文要求代理唯讀。探索權限不包含修正、提交、啟動服務或外部連線。工具缺失時只能明示受限的替代方式,不能把單一代理的多段文字報成多代理結果。

模型名稱依執行環境驗證,不能把原文 Claude 預設名稱保證為其他平台可用。程式碼能支持目前資料流,不能單靠它證明使用者需求、歷史原因或正式環境實際狀態。

延伸閱讀與來源