mcpField
R
reflect

reflect

github.com/ericlitmanAgent 工作流53846 次安装1 周前更新
代码仓库

关于 reflect

Reflect 是从对话中提炼长期有效经验并安排技能更新的技能。它通过并行审查与综合整理结果,并在应用已接受的修改前等待批准。

主要功能

  1. 01从对话中提取长期经验
  2. 02并行运行三种审查视角
  3. 03整理接受、拒绝与待办项
  4. 04检查经验是否适合结构化强制执行
  5. 05技能修改须经批准

适用场景

  1. 01从会话中提炼可复用经验
  2. 02将发现分配给现有或新技能
  3. 03区分可执行修改与待办事项

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/ericlitman/open-pstack --skill reflect

安装后在 Claude Code 中输入/reflect确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
divergent-reviewer.md
judgment-reviewer.md
synthesizer.md
tooling-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>)。每项用一行说明。
  • 已舍弃:每项未采纳的发现及综合器给出的原因各用一行说明。

评论

支持 Markdown