用途:在 Claude Code 会话结束时运行 /debrief(无参数),扫描已在上下文中的会话内容,识别项目特有摩擦,即项目规则与项目知识,并提出工程师可批准的 CLAUDE.md 修改建议。它属于 Orbitant 工程的 bottom-up 部分,与尚未构建的 /ground-control(top-down)解耦。
主要能力:仅处理两类摩擦。项目规则指显式纠正、表明项目级约定的内容,例如“不要用 moment.js”“API 字段用 snake_case”“测试统一用 Vitest”。项目知识指 Claude 缺少、由工程师主动补充的代码库事实,例如“API 在 /api/v2/”“认证 token 在 tokens 表”“编辑 schema 后跑 npm run gen”“开发服务器需要 .env.local 中的 DATABASE_URL”。每条候选须满足:若写入 CLAUDE.md 是否会改变本次会话中 Claude 的行为;并须有至少一条引用的用户消息或具体知识缺失时刻作为证据。
使用方式:会话结束时输入 /debrief,或 /debrief <hint> 聚焦特定领域。若会话没有真实工程工作,会提示没有可总结的活跃会话内容。流程包括读取现有 CLAUDE.md(含子目录 CLAUDE.md)去重、扫描会话、套用门槛与排除项、要求证据、输出提案或“会话干净”。存在提案时返回固定格式,每条含 Type、Evidence、Proposed CLAUDE.md addition,并询问应用哪些。应用时仅追加到项目根 CLAUDE.md,不修改或删除现有内容,不暂存、不提交。
排除项:工程师中途改变主意、一次性 bug 修复、一次纠正即可的风格提示、通用编程常识、已被现有 CLAUDE.md 覆盖的内容。技能执行过程中出现的纠正同样计入。
限制:只提出 CLAUDE.md 编辑,不提出新技能、子代理、hook、slash 命令或设置;假设完整会话已在上下文中,不从磁盘重读;仅编辑项目根 CLAUDE.md,不针对子目录;无证据不提案;偏向零提案,干净会话是成功结果。