用途：retro 是一个自我改进循环技能，回答“发生了什么、学到什么、下次如何避免同样错误”。它面向下一个任务及后续任务，而非当前任务。它做结构化质量分析与固化，不是代码审查、不是结果验证，也不是 Claude Code 内置的 /insights 跨会话用量分析。
主要能力：首先收集上下文，用单独 Bash 命令依次获取：Claude 会话 id（printenv CLAUDE_CODE_SESSION_ID）、当前分支（git branch --show-current）、最近提交（git log --oneline -5）、工作树状态（git status --porcelain，最多读前 20 条）、变更文件（git diff --name-only HEAD）。任一命令失败按未知值继续。随后执行模式：session、codify、trends、quick 四种，各对应 context/ 下的说明文件，由 $ARGUMENTS 指定或按上下文推断。会话数据位于 ~/.claude/projects/<project-slug>/，转录为 <session-id>.jsonl，解析脚本为 scripts/parse_transcript.py（仅标准库，Python 3.10+）。可借助 --chain-from 沿 previous_handoff 指针回溯多个会话，跨整个会话链聚合指标。
使用方式：会话结束、裸 /retro 或合并后用 session 模式做完整五阶段分析；要求“codify”“save learnings”时做定向固化；问“trends”“scores”时查看跨会话得分历史；上下文用量超过 75% 或已压缩时优先 quick。回顾结束后按模式给出交接建议。
限制：不运行构建或测试，不审查代码质量，不向消费方仓库写入分数或报告（插件状态留在 ${CLAUDE_PLUGIN_DATA}），仅用户批准的固化内容会落到外部；五个评分维度为固定插件属性，不可替换评分标准。Phase 4 是交互检查点，未经用户明确批准不得持久化固化内容。缺少资料的部分暂未提供。