mcpField
R
reflect

reflect

github.com/mariusflorescuAgent 工作流1288 次安装4 天前更新
代码仓库

关于 reflect

用于从对话中提炼可复用经验，并将其分流到技能修改或待办事项。流程包含三个并行评审视角、综合整理，以及应用已接受修改前的审批步骤。

主要功能

  1. 01定位当前对话记录
  2. 02并行运行三个评审视角
  3. 03整理接受、拒绝和待办项
  4. 04技能修改前要求审批
  5. 05按修改范围分配已批准事项

适用场景

  1. 01从对话中提炼可复用经验
  2. 02判断经验应进入技能还是待办
  3. 03准备技能修改并等待明确审批

安装

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

$npx skills add https://github.com/mariusflorescu/pstack-t3 --skill reflect

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

包含的文件

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

agents/
openai.yaml
references/
divergent-reviewer.md
judgment-reviewer.md
synthesizer.md
tooling-reviewer.md

详细介绍

Reflect

粗体或反引号标记的技能名称，或以 /<name> 运行的技能，是此技能目录旁 ../<name>/SKILL.md 中的文件；不带前缀的原则名称对应 ../principle-<name>/SKILL.md。读取该文件并遵循其中的要求。大多数 pstack 技能仅供用户使用，因此你的技能工具无法加载它们。每次 delegate_task 调用都遵循 ../poteto-mode/SKILL.md 中 Subagents 一节的默认设置。

从当前对话中挖掘可长期参考的经验，并将其整理到技能编辑中。

当用户说“reflect”或“/reflect”时调用。如果对话无关紧要、偏离主题，或父级已遵循现有技能且处理正确，则跳过。一次性事件不算经验。

1. 定位当前对话记录

在并行委派之前，找到本次对话的线程。使用 t3_thread_search 搜索此项目，查询当前对话开场用户提示中的独特短语。不要传入其他项目的 projectId。那会越过工作区边界，读取其他项目中的私人聊天。

对于每个候选线程，使用 t3_thread_read 读取第一条用户消息。选择第一条消息与当前对话开场用户提示一致的 threadId。如果没有匹配项，则传入一份简明的会话摘要。

2. 并行启动三位审阅者

在一轮中调用三次 delegate_task，每次调用的 title 都应注明审阅视角，target 则取自下方对应的角色行。审阅者需要 MCP 访问权限，以便查找记录中提及的工单、聊天线程和可观测性追踪数据。

每位审阅者和综合者都应在 ~/.config/pstack/pstack-models.md 中指定一个角色行。如果文件不存在或没有对应行，则该角色使用父级模型运行。请说明这一点并建议运行 /setup-pstack。如果 orchestrator_capabilities 中没有列出已配置的条目，则该角色使用父级模型运行，并说明这一点。根据 poteto-mode 技能中的 Subagents 一节，按任务选择每个子代理的推理级别以及快速或标准速度。

视角角色行提示模板
判断reflect judgment, divergent, synthesizerreferences/judgment-reviewer.md
工具reflect toolingreferences/tooling-reviewer.md
发散reflect judgment, divergent, synthesizerreferences/divergent-reviewer.md

将每份模板原样作为任务说明传入，并在标记处填入线程 ID 或摘要。审阅者会将发现作为任务结果返回。

3. 综合

调用一次 delegate_task，标题为 Reflect synthesizer，target 取自 reflect judgment, divergent, synthesizer 这一行。它会通过 MCP 抽查引用。原样传入 references/synthesizer.md，并在标记处填入每位审阅者的完整输出。它会返回 Accepted / Rejected / Backlog 列表。

4. 结构化强制检查

将任何可由 lint 规则、脚本、元数据标记或运行时检查更可靠地强制执行的 Accepted 项移至 Backlog。请参阅 encode-lessons-in-structure 原则技能。

5. 应用

完整展示综合器输出的“接受 / 拒绝 / 待办”，并在应用任何已接受的编辑前等待明确批准。用户选择要应用的子集，也可以重新指定路由。技能变更会影响组织中的所有未来 Agent。不要自动应用。

将每条待办列入团队的 devex 或待办跟踪系统，无需等待。只有“接受”列表需要等待批准。

严格遵循每一行指定的路由：

  • 对现有技能进行简单编辑（添加一条单行项目符号、精简一句话、修正过时事实）：由父级直接处理。
  • 对现有技能进行实质性编辑（新增章节、新增模式表、超过约 10 行）：交由 skill-creator 技能处理，并执行其起草 / 测试 / 迭代流程。
  • tune description: <skill path>（技能存在，但在应该触发时未触发）：交由 skill-creator 处理，并执行其描述优化流程。
  • new skill via skill-creator: <kebab-name>：交由 skill-creator 创建。不要临时自行设计技能结构。

如果环境中未安装 skill-creator，则对于指定该技能的路由，遵循技能编写手册（../poteto-mode/playbooks/authoring-a-skill.md）。

如果环境中提供 SKILL.md 验证器，则在宣布完成前，对所有修改过的技能运行验证器。

6. 向用户总结

简短列出，不要写引言：

  • 已应用的编辑：<skill path>。每项用一行说明变更内容。
  • 新建的技能：<skill path>。每项用一行说明（少见）。
  • 已提交至 devex 跟踪系统的待办：<issue title>（<tags>）。每项一行。
  • 已舍弃：每条被拒绝的发现各用一行说明 + 综合器给出的理由。

评论

支持 Markdown