reflect | 把本次教訓整理成待核准的技能修訂
本頁以 pstack-claude 0.9.126 為基準。我們練習回顧一次文件修訂任務，將反覆漏寫驗收條件的經過整理成提案。練習只交付提案，不編輯技能。
定位與適用情境
reflect 從目前對話尋找可持續使用的教訓，再判斷該修改哪個技能。原文以判斷、工具與不同觀點三種角度平行審閱，再由另一個代理綜整。
不是每次失誤都適合加規則。對話太簡單、與任務無關、只是一次性問題，或既有技能已涵蓋且代理正確遵循時，可以略過。這次練習要分辨「文件技能少了一條指引」與「已有指引卻沒有照做」，不能預設結論一定是新增文字。
準備
先提供目前任務的可用對話紀錄，或依時間排序的中性摘要（digest）。摘要逐項記下使用者需求與修正、工具呼叫與結果，以及碰過的檔案。不先寫原因或責任判斷。
練習可以包含以下紀錄，但只能把實際發生的內容交給代理。
- 使用者最初要求操作教學附上驗收條件。
- 初稿沒有列出可觀察結果，使用者要求補寫。
- 第二輪同樣遺漏，之後才補上結果。
- 提供當時可用的技能原文，讓審閱者檢查是否已經有相關要求。
先核對環境是否支援子代理及所需來源存取。本頁不假設讀者已安裝相關工具，也不把本機過去的查核當作這次能力證明。
操作步驟
- 限定回顧範圍為目前任務。原文在 Claude Code 使用所附的尋找程式定位目前專案的對話，不可跨專案掃描。無法取得紀錄時，依原文允許的方式改交中性摘要。Codex 對應文件也指定使用摘要。
- 要求代理依判斷、工具與不同觀點展開三份唯讀審閱。各審閱者只取得紀錄或摘要，不附加主代理的診斷。預期先得到各自的發現，再交給綜整者。
- 檢查綜整的接受（Accepted）、拒絕（Rejected）與待辦（Backlog）完整清單。能用靜態檢查、腳本、中繼資料旗標或執行期檢查可靠強制的項目，從接受移到待辦，不再堆疊提醒文字。
- 查看每個接受項目的差異與目的地，先不要套用。原文要求明確核准，且不得編輯外掛快取內的技能。Claude Code 的候選目的地是專案
.claude/skills/<skill>/或使用者設定目錄下的skills/<skill>/。 - 只在你明確核准具體項目與目的地後進入編輯。小修訂由主代理處理。實質改寫、描述調校或新技能建立轉交技能開發流程，並在環境提供驗證器時檢查修改後的技能。
可直接使用的提示詞
用 pstack:reflect 回顧目前這次文件修訂任務。
我會提供按時間排序的中性摘要與當時使用的技能原文。
摘要只列需求、修正、工具結果與碰過的檔案，不含預設診斷。
只做唯讀審閱與提案，不讀取其他聊天或掃描本機聊天目錄。
先核對能否依技能進行三種角度審閱與綜整。
若能力不足，明說限制，不把單一代理分析說成三份獨立審閱。
交付完整 Accepted、Rejected、Backlog 清單。
每個 Accepted 項目附上可查證的紀錄位置、目的技能、差異與目的地。
可由結構性檢查強制的項目移到 Backlog。
不要改技能、複製技能、建立外部工單、開 PR 或推送。
任何技能編輯都等我明確核准具體項目與目的地。預期結果與驗收
預期結果可能是「沒有接受項目」。若原技能已清楚要求驗收條件，審閱者應說明為什麼再加一句提醒不會解決問題，而不是為了產出而硬改技能。
檢查下列結果。
- 每項發現連回本次可取得的紀錄，不引用其他專案私密對話。
- 接受、拒絕與待辦都有理由，拒絕項目沒有被默默省略。
- 提案顯示目的地與差異，但核准前沒有實際編輯。
- 無法取得來源或獨立審閱時，結果標明限制，不冒稱流程已完整執行。
限制與權限
技能變更會影響後續任務，因此原文明定先呈現完整綜整結果，再等明確核准。不要修改 plugins/cache/。其他執行環境應使用各自的技能位置，不能照搬 Claude Code 路徑。
原文對 Backlog 預設直接送到團隊開發體驗追蹤系統。本練習明確禁止建立外部工單，因此只保留本地提案清單並揭露未送出，不聲稱已建立紀錄。技能流程不能越過使用者限制。
延伸閱讀與來源
- correct 教學處理適合由架構或自動檢查防止的重複錯誤。
- 全部技能教學
- 版本與技能總覽
- 上游技能原文