Debrief 是一个 Claude Code 技能，旨在从会话记录和自动记忆中提取持久经验，并将其写入代理下次会读取的指令文件。工作流分为五个阶段，前三个阶段连续运行，第四阶段有一个需要用户确认的关卡。
用途 Debrief 用于捕获用户在 Claude Code 会话中做出的修正，以及代理在多个会话中重复出现的自我修正，判断哪些经验具有跨任务价值，并按照规则将其路由到合适的位置（项目 CLAUDE.md、个人 CLAUDE.md、技能 SKILL.md 或权限设置），从而持续改进代理行为。
主要能力
- 阶段一：收集。根据参数确定扫描的会话范围（当前会话、时间窗口、指定仓库或全部仓库），运行脚本提取候选修正。候选类型包括修正（拒绝、中断、回退、中途引导、后续提示）、工具错误（代理自行修正的错误）和记忆条目（自动记忆中的条目）。输出为 JSONL 文件，每行一个候选。
- 阶段二：分类。判断每个候选是否构成“经验”：必须修正代理的工作方式，且具有跨任务持久性。非经验包括新请求、事实修正、仅限当前任务的偏好等。信号强度作为证据，但最终由内容决定。用户明确陈述的规则可直接作为规则处理。
- 阶段三：路由。为每条经验指定唯一目标：项目（写入对应仓库的 CLAUDE.md 或其链接文档，或 .claude/rules/ 文件）、个人（写入 ~/.claude/CLAUDE.md）、技能（写入技能 SKILL.md，若在插件目录内则改为覆盖写入 CLAUDE.md 并通知插件作者）、设置（写入 permissions.deny 或 permissions.ask，并保留散文规则）、代码（仅报告需修改的文件）。
- 阶段四：关卡。逐条阅读目标文件，给出判定（添加、吸收、丢弃），并以编号列表展示每条经验的证据、目标路径、判定和确切文本。用户逐条决定，仅应用批准的条目。
- 阶段五：报告。汇总扫描的候选数量、提出的经验、每次写入的路径、丢弃原因以及代码修复和插件作者的备注，并列出收到写入的仓库。
使用方式 参数 $ARGUMENTS 控制扫描范围：空参数表示仅当前会话（--session ${CLAUDE_SESSION_ID}）；可指定时间窗口（如 14d 或日期，通过 --since <window>）、仓库（通过 --project <path>，或 --all-projects 表示全部仓库）。脚本路径为 node ${CLAUDE_SKILL_DIR}/scripts/extract-corrections.mjs，输出到临时文件。候选超过 100 条时，先写入索引文件并分片读取，超过 2000 条时要求用户缩小窗口。
适用场景 需要将 Claude Code 会话中的临时修正沉淀为长期规则，或希望系统化梳理代理行为改进点的开发者；管理多个仓库并希望统一用户级规则的用户；需要将重复出现的工具错误转化为指导的团队。
限制 工作流依赖 Claude Code 的会话记录和自动记忆数据，仅在这些数据存在时有效。某些目标（如插件内的技能文件）可能被后续更新覆盖，需要采用覆盖方案。权限规则只能匹配明确形式，可能遗漏其他写法。条目写入前必须经过用户逐条确认，不能自动应用。