Session Retro
回顧 AI 代理會話,找出改善機會。回顧透過互動式對話進行 — 觀察發生的事情、與使用者討論發現、然後提出具體可行的建議。
目標是提升使用者與 AI 協作的效率:更好的提示、更好的文件、更好的工具、更好的工作流程。
快速開始
讓我們回顧這次會話
/retro
我可以在這次會話中改進什麼?
會話回顧 — 找尋優化機會
使用時機
- 工作階段結束時,進行反思並記錄所學
- 遇到摩擦、修正或替代方案後的會話
- 想改善代理指令、技能、鉤子或工作流程時
- 好奇社群技能是否能協助處理會話中出現的模式時
- 定期執行,以維持健康的開發實務
運作方式
以下是典型的引導流程 — 請根據對話自然調整。並非每次會話都需要每個步驟;簡短且無問題的會話只需快速觀察即可繼續。
觀察
回顧會話對話,自由識別任何值得注意的事項。不要限制自己於預設分類 — 讓觀察從實際發生的事情中自然浮現。
對於每個觀察,提供一行摘要和初始可行的建議。即使使用者不深入探討,每個觀察都應提供有用的見解。
在開放式掃描之後,使用 dimensions.md 中的 15 個維度作為安全網檢查清單 — 掃描開放式觀察可能遺漏的部分。僅提出真正值得注意的額外發現。
包括:
- 反應性發現:出錯或已修正的事項
- 主動性發現:做對但未記錄的事項,或可編寫成規範的良好實務
互動式深入探討
逐一呈現觀察結果,並顯示進度指標(例如 [2/6])。對於每個觀察,給予初始建議,並詢問使用者是否想深入探討。
使用者可能:
- 回答「是」— 記錄為需深入探討
- 回答「否」— 跳過(初始建議仍然有效)
- 提供背景資訊或更正
- 提出 AI 遺漏的觀察
- 說「夠了」以跳過剩餘項目並繼續
在走完所有觀察後,如果使用者選擇了任何深入探討的項目,評估哪些項目確實需要子代理研究,哪些項目可以直接明確行動。呈現此評估,並在使用者確認後再啟動子代理。
每個子代理遵循 subagent-guide.md 中的循環:徹底研究觀察結果、分析根本原因、設計具體解決方案,並提出發現與建議。
結果與討論
逐一呈現每個子代理的結果,並顯示進度。使用者可以:
- 討論結果並提出後續問題
- 接受建議選項
- 要求修改
- 跳至下一個結果
行動建議
在討論所有結果後,將確認的行動編譯成建議摘要。對於每個行動,說明要做什麼以及為什麼。如果使用者要求記錄(例如「寫下來」),在對話中輸出 markdown 摘要 — 不要寫入檔案。
明確結束回顧:告知使用者回顧已完成,建議的行動由使用者自行決定何時啟動。
指引
應做
- 讓觀察從實際會話內容中浮現,而非固定模板
- 為每個觀察提供可行的見解,即使不深入探討
- 尊重使用者時間 — 如果會話很順利,就直接說明並保持簡短
- 在啟動子代理前先請求許可
- 對於修正:調查根本原因是缺少慣例、文件不明確,還是技能需要改進
- 對於良好實務:建議在使用者忘記之前先將其編寫成規範
- 分析技能時:先檢查所有權(自行維護 vs 社群提供),以給予適當建議
- 提出發現時附上建議和理由
不應做
- 執行任何動作(例如提交、推送、修改檔案)。此技能僅用於分析和建議
- 將使用者的同意(例如「是」、「聽起來不錯」、「繼續」)解讀為執行請求。此類回應僅為確認
- 在回顧明確結束前,對任何指令採取行動。只有在回顧結束後的新特定指令,才是有效的行動請求
- 強制執行僵化的階段順序 — 根據對話靈活調整
- 過度分析問題極少的會話
- 未經使用者許可啟動子代理
- 在未說明原因的情況下推薦變更
- 在呈現選項時省略「什麼都不做 / 跳過」選項
- 對使用者的提示或工作流程做出批判性評價 — 保持建設性
參考文件
- dimensions.md — 15 個分析維度,作為安全網檢查清單
- subagent-guide.md — 子代理如何研究、分析並呈現發現
備註
- 15 個維度是檢查清單,而非評分標準。大多數會話只會在少數維度產生信號。
- 如果使用者想檢視多個會話,可進行跨會話模式分析 — 若範圍不明確,請在開始時詢問。
- 使用者在回顧後可能另外呼叫的相關工具:hookify、claude-md-management、skill-creator、brainstorming。回顧本身不會直接呼叫這些工具。