关于 reflect
Reflect 是从对话中提炼长期有效经验并安排技能更新的技能。它通过并行审查与综合整理结果,并在应用已接受的修改前等待批准。
主要功能
- 01从对话中提取长期经验
- 02并行运行三种审查视角
- 03整理接受、拒绝与待办项
- 04检查经验是否适合结构化强制执行
- 05技能修改须经批准
适用场景
- 01从会话中提炼可复用经验
- 02将发现分配给现有或新技能
- 03区分可执行修改与待办事项
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ ericlitman/ open-pstack --skill reflect安装后在 Claude Code 中输入/reflect确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/divergent-reviewer.mdjudgment-reviewer.mdsynthesizer.mdtooling-reviewer.md详细介绍
反思
从当前对话中提取持久有效的经验,并将其用于调整技能。
调度约定。 通过 provider-dispatch.md 解析每个已配置的角色。审查者需要访问父级实时 MCP 工具集,因此默认且受支持的可移植路由是 inherit-parent(或其别名 auto)。传入对话记录或摘要,以及任何必需的证据路径。在 Codex 上,通过 codex-tools.md 解析剩余的 Claude 工具名称。
当用户说“reflect”或“/reflect”时调用。如果对话无关紧要、偏离主题,或已有技能已涵盖且父级正确遵循,则跳过。偶发事件不算经验。
1. 定位当前对话记录
启动并行任务前,通过当前对话记录映射解析并验证本次对话的记录;否则传入简明的会话摘要。
2. 并行启动三名审查者
通过提供方调度,在同一轮并行阶段启动全部三个只读审查通道。审查者需要 MCP 访问权限,以便查找对话记录中提到的工单、聊天线程和可观测性追踪,因此应使用与父级相同的原生环境。提示词禁止写入文件;由父级应用编辑。根据 poteto-mode 技能的 Subagents 部分,为每个子 Agent 选择合适的工作量。
| 视角 | 模型描述符 | 提示词模板 |
|---|---|---|
| 判断 | reflect tooling, judgment, divergent, synthesizer 描述符(默认 inherit-parent) | references/judgment-reviewer.md |
| 工具使用 | reflect tooling, judgment, divergent, synthesizer 描述符(默认 inherit-parent) | references/tooling-reviewer.md |
| 发散思考 | reflect tooling, judgment, divergent, synthesizer 描述符(默认 inherit-parent) | references/divergent-reviewer.md |
原样传入每个模板,并在标记处替换为对话记录路径或摘要。审查者会在 Agent 响应正文中返回发现。
3. 综合
使用 reflect tooling, judgment, divergent, synthesizer 描述符(默认 inherit-parent)调度一个通道。该通道会通过 MCP 对引用进行抽查验证,因此请保留相应访问权限。原样传入 references/synthesizer.md,并在标记处内嵌每位审查者的完整输出。它会返回 Accepted / Rejected / Backlog 列表。
4. 结构化约束检查
将任何可通过 lint 规则、脚本、元数据标记或运行时检查更可靠地强制执行的 Accepted 项移入 Backlog。参见 encode-lessons-in-structure 原则技能。
5. 应用
完整呈现综合结果中的 Accepted / Rejected / Backlog 输出,并等待用户明确批准后再应用任何 Accepted 编辑。用户会选择要采用的子集,也可以重新指定路由。技能变更会影响组织中的每个未来 Agent。不得自动应用。
无需等待,将每个 Backlog 项登记到团队的 devex 或待办事项跟踪系统。只有 Accepted 列表需要等待批准。
严格遵循每个已批准条目的 Routing:
- 对现有技能进行简单编辑(一条项目符号、收紧一句话、修正过时信息):由父级直接处理。
- 对现有技能进行实质性编辑(新增章节、新增模式表、超过约 10 行):交给 plugin-dev:skill-development 技能,并执行其起草 / 测试 / 迭代流程。
tune description: <skill path>(技能已存在,但在应触发时未触发):交给plugin-dev:skill-development,并执行其描述优化流程。new skill via plugin-dev:skill-development: <kebab-name>:交由plugin-dev:skill-development创建。不要临时自行设计结构。
如果环境提供 SKILL.md 验证器,在宣布完成前对每个已修改的技能运行验证。
6. 为用户总结
简短列表,不要写引言:
- 已应用的编辑:
<skill path>。每项更改用一行说明。 - 新建的技能:
<skill path>。每项用一行说明(少见)。 - 已提交到 devex 跟踪器的待办事项:
<issue title>(<tags>)。每项用一行说明。 - 已舍弃:每项未采纳的发现及综合器给出的原因各用一行说明。