reflect 用于从当前对话中挖掘可长期保留的经验,并将这些经验转化为对技能的修改。
用途:当用户在对话中输入 reflect 或 /reflect 时调用。对话过于简单、跑题,或已有技能正确覆盖时跳过;一次性事件不算经验。
使用方式:
- 定位当前会话的记录。优先使用宿主提供的当前会话 API;否则调用 /recall 列出本仓库最近的 Codex 与 Claude Code 会话并读取候选。不要遍历 ~/.claude/projects/*/ 或所有 Codex 会话,以免跨工作区读取无关项目的私聊。按最新优先读取候选的首条用户提示及宿主注入的上下文(如 Codex 记录为第一条用户消息的 AGENTS.md 指令),选择首条用户提示包含本次对话开头提示的会话;若无匹配,则传入该会话的精简摘要。
- 通过 /swarm 并行启动三个审查者(判断、工具、发散),均作为保留会话 MCP 与连接器工具的原生子代理,分别按 references/judgment-reviewer.md、references/tooling-reviewer.md、references/divergent-reviewer.md 模板执行,并将记录路径或摘要填入指定位置。
- 由同一类子代理担任综合者,按 references/synthesizer.md 执行,通过 MCP 抽查引用,输出接受/拒绝/待办清单。
- 结构强制检查:若某条“接受”项可通过 lint 规则、脚本、元数据标记或运行时检查更可靠地强制,则移入待办。
- 应用:先展示综合者的完整清单,等待用户明确批准后再应用;用户可选择子集并调整路由。技能修改会影响组织内所有未来代理,不得自动应用。待办项在用户已有授权时可立即提交到团队 devex 或待办跟踪器,否则作为提案列出。修改应在技能源头(/pstack-setup 记录的仓库或安装来源仓库)进行,而非已安装副本;批准前展示每个技能的目标位置;不得创建 PR 或推送。按批准行的路由执行:琐碎修改由父代理直接完成;实质性修改(新章节、新模式表、超过约 10 行)需用 /writing-for-agents 起草并在代表性案例上验证;描述未触发时交给 /writing-for-agents 调整描述;新技能交给 /writing-for-agents 创建。若环境提供 SKILL.md 校验器,需在完成前对每个改动技能运行。
- 向用户简要汇总:已应用的修改、新建技能、已提交待办、被拒绝项及原因,每条审查发现只出现在其中一类。
适用场景:对话结束后沉淀经验、改进技能触发与内容。限制:依赖会话记录与 MCP 工具;一次性事件不算经验;所有技能修改需人工批准。