Retro — Session 回顧

SkillAI & models

Session retrospective report: extracts key decisions, completed items, and improvement suggestions from this conversation. Best used before ending a session or before /compact.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Retro — Session 回顧 skill

What this skill tells your AI

The instructions your AI receives, as published by zeuikli/claude-code-workspace in .claude/skills/retro/SKILL.md and read by ahel’s review.

觸發條件

  • Session 即將結束,需要產出可存入 Auto Memory 的摘要
  • /compact/clear 前,確保關鍵決策不遺失
  • 週期性審視工作效率(每週一次)

摘取原則

只保留人類可讀的內容

  • ✅ 使用者的 prompt / 指令
  • ✅ Claude 的說明、決策推理、摘要
  • ❌ 工具呼叫(Bash 指令、檔案讀寫、搜尋查詢)
  • ❌ 工具回傳結果(命令輸出、檔案內容)
  • ❌ 系統訊息與 <system-reminder> 標籤

報告格式(IMRaD 結構)

# Session Review — [日期] — [主題/目標]

## Introduction(目標與背景)
- **Goal**: 本次 session 要達成什麼?
- **Context**: 相關背景(專案名稱、任務階段、已知阻塞點)

## Methods(工作方式)
- **Approach**: 達成目標的高層次步驟
- **Tools/Technologies**: 主要用到的工具、語言、框架
- **Workflow Pattern**: 對話流程類型(線性 / 迭代 / 探索 / debug 迴圈)

## Results(產出成果)
- **Completed**:
  - [項目 1]
  - [項目 2]
- **Partially Completed**:
  - [項目 — 剩餘工作]
- **Not Started / Deferred**:
  - [項目 — 原因]

## Discussion

### 效率審查
本次 session 哪裡可以更有效率:
- **[問題]**:[發生什麼] → **建議**:[更好的做法]

### CLAUDE.md 改善建議
本次 session 發現哪些摩擦點應該寫進 CLAUDE.md:
- **新增**:`[建議內容]` — [原因:可以預防什麼摩擦]
- **修改**:`[現有段落]` → `[建議改動]` — [原因]

### 待追蹤項目
- [ ] [下次 session 要繼續的工作]
- [ ] [需要進一步研究的主題]

執行步驟

  1. 掃描本次對話,過濾掉工具呼叫和工具結果
  2. 識別 session 目標(從最初幾條 user 訊息推斷)
  3. 整理完成事項(實際產出:新增檔案、修復 bug、做的決策)
  4. 分析效率:找出可以批次處理的重複任務、需要多次釐清的模糊 prompt
  5. 提出 CLAUDE.md 改善建議:本次有哪些重複給的指示應該寫進去
  6. 用上面的模板產出報告

與 Auto Memory 的整合

回顧報告的「待追蹤項目」和「完成事項」適合用 /memory 加入 Auto Memory,確保跨 session 持久化。關鍵決策也應同步更新。

Gotcha

  • 若 session 很短或瑣碎,縮短報告即可,不要強塞每個段落
  • CLAUDE.md 建議要具體且可操作,不要寫「增加更多文件」這類空泛建議
  • 效率審查應建設性,聚焦在下次可改善的具體模式

Signals

GitHub stars
156
Forks
38
Last commit
Sep 2026
Hacker News mentions
20
Advanced
Catalog kind
skill
Gateway key
retro-zeuikli
Source
github.com/zeuikli/claude-code-workspace