retro 是一个会话回顾技能,用于在复盘或总结一次 Claude Code 工作会话时,自动生成结构化的回顾报告。
用途:针对当前会话输出一份人类可读的回顾,按 IMRaD(引言、方法、结果、讨论)结构组织,帮助总结目标、过程与成果。
主要能力:
- 只提取人类可读内容,即用户消息与助手散文式回复(type 为 text 的块)。
- 过滤工具调用、工具结果、thinking 块、<system-reminder> 标签、进度事件和文件历史快照。
- 报告包含:引言(目标与背景)、方法(做法、工具、工作流模式)、结果(已完成、部分完成、未开始)、讨论(效率回顾、英文纠错、待深入学习的概念、CLAUDE.md 改进建议)。
- 附带 Python 脚本 extract_conversation.py,解析 Claude Code 的 JSONL 日志,支持 markdown、json、plain 输出,自动检测最新会话,无外部依赖(仅标准库)。
用法:运行同伴脚本获取干净转录文本: python3 ~/.dotfiles/claude.symlink/skills/retro/extract_conversation.py --timestamps --stats 可指定项目: python3 ~/.dotfiles/claude.symlink/skills/retro/extract_conversation.py --project-dir /path/to/project --timestamps --stats 输出 JSON: python3 ~/.dotfiles/claude.symlink/skills/retro/extract_conversation.py --format json 列出会话: python3 ~/.dotfiles/claude.symlink/skills/retro/extract_conversation.py --list-sessions 若脚本失败或找不到会话文件,则回退为手动浏览会话历史并过滤工具调用与结果。
适用场景:需要复盘 Claude Code 会话、改进提示词效率、纠正英文表达或沉淀 CLAUDE.md 约定时。
限制:会话过短时可缩减报告,不必强制填充各节;英文无错时应如实说明,不得编造纠错。收费、价格与平台支持等信息暂未提供。