Communitygithub.com

VdustR/skills

VdustR 開發的可重複使用代理技能

skills 是什麼?

Session Retro 是一個 AI 代理技能,專為協助使用者回顧會話、辨識改進機會而設計。它透過互動式對話進行—觀察對話內容、與使用者討論發現、並提出具體可行的建議,最終目標是提升使用者與 AI 協作的效率,包括更好的提示、文件、工具和工作流程。此技能支援 Claude、Cursor、Codex 等主流平台,可於工作階段結束、遇到摩擦或錯誤時、或想改善代理指令時使用。其運作流程涵蓋開放式觀察(搭配 15 個維度檢查清單確保無遺漏)、互動式深入探討(逐步呈現觀察結果、允許使用者選擇是否深究)、子代理研究(需使用者許可後才啟動)、結果討論,最後彙整行動建議。重點在於僅提供分析與建議,不執行任何檔案修改或提交動作,確保安全性與可控性。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add VdustR/skills

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Session Retro

回顧 AI 代理會話,找出改善機會。回顧透過互動式對話進行 — 觀察發生的事情、與使用者討論發現、然後提出具體可行的建議。

目標是提升使用者與 AI 協作的效率:更好的提示、更好的文件、更好的工具、更好的工作流程。

快速開始

讓我們回顧這次會話

/retro

我可以在這次會話中改進什麼?

會話回顧 — 找尋優化機會

使用時機

  • 工作階段結束時,進行反思並記錄所學
  • 遇到摩擦、修正或替代方案後的會話
  • 想改善代理指令、技能、鉤子或工作流程時
  • 好奇社群技能是否能協助處理會話中出現的模式時
  • 定期執行,以維持健康的開發實務

運作方式

以下是典型的引導流程 — 請根據對話自然調整。並非每次會話都需要每個步驟;簡短且無問題的會話只需快速觀察即可繼續。

觀察

回顧會話對話,自由識別任何值得注意的事項。不要限制自己於預設分類 — 讓觀察從實際發生的事情中自然浮現。

對於每個觀察,提供一行摘要和初始可行的建議。即使使用者不深入探討,每個觀察都應提供有用的見解。

在開放式掃描之後,使用 dimensions.md 中的 15 個維度作為安全網檢查清單 — 掃描開放式觀察可能遺漏的部分。僅提出真正值得注意的額外發現。

包括:

  • 反應性發現:出錯或已修正的事項
  • 主動性發現:做對但未記錄的事項,或可編寫成規範的良好實務

互動式深入探討

逐一呈現觀察結果,並顯示進度指標(例如 [2/6])。對於每個觀察,給予初始建議,並詢問使用者是否想深入探討。

使用者可能:

  • 回答「是」— 記錄為需深入探討
  • 回答「否」— 跳過(初始建議仍然有效)
  • 提供背景資訊或更正
  • 提出 AI 遺漏的觀察
  • 說「夠了」以跳過剩餘項目並繼續

在走完所有觀察後,如果使用者選擇了任何深入探討的項目,評估哪些項目確實需要子代理研究,哪些項目可以直接明確行動。呈現此評估,並在使用者確認後再啟動子代理。

每個子代理遵循 subagent-guide.md 中的循環:徹底研究觀察結果、分析根本原因、設計具體解決方案,並提出發現與建議。

結果與討論

逐一呈現每個子代理的結果,並顯示進度。使用者可以:

  • 討論結果並提出後續問題
  • 接受建議選項
  • 要求修改
  • 跳至下一個結果

行動建議

在討論所有結果後,將確認的行動編譯成建議摘要。對於每個行動,說明要做什麼以及為什麼。如果使用者要求記錄(例如「寫下來」),在對話中輸出 markdown 摘要 — 不要寫入檔案。

明確結束回顧:告知使用者回顧已完成,建議的行動由使用者自行決定何時啟動。

指引

應做

  • 讓觀察從實際會話內容中浮現,而非固定模板
  • 為每個觀察提供可行的見解,即使不深入探討
  • 尊重使用者時間 — 如果會話很順利,就直接說明並保持簡短
  • 在啟動子代理前先請求許可
  • 對於修正:調查根本原因是缺少慣例、文件不明確,還是技能需要改進
  • 對於良好實務:建議在使用者忘記之前先將其編寫成規範
  • 分析技能時:先檢查所有權(自行維護 vs 社群提供),以給予適當建議
  • 提出發現時附上建議和理由

不應做

  • 執行任何動作(例如提交、推送、修改檔案)。此技能僅用於分析和建議
  • 將使用者的同意(例如「是」、「聽起來不錯」、「繼續」)解讀為執行請求。此類回應僅為確認
  • 在回顧明確結束前,對任何指令採取行動。只有在回顧結束後的新特定指令,才是有效的行動請求
  • 強制執行僵化的階段順序 — 根據對話靈活調整
  • 過度分析問題極少的會話
  • 未經使用者許可啟動子代理
  • 在未說明原因的情況下推薦變更
  • 在呈現選項時省略「什麼都不做 / 跳過」選項
  • 對使用者的提示或工作流程做出批判性評價 — 保持建設性

參考文件

備註

  • 15 個維度是檢查清單,而非評分標準。大多數會話只會在少數維度產生信號。
  • 如果使用者想檢視多個會話,可進行跨會話模式分析 — 若範圍不明確,請在開始時詢問。
  • 使用者在回顧後可能另外呼叫的相關工具:hookify、claude-md-management、skill-creator、brainstorming。回顧本身不會直接呼叫這些工具。

相關技能