SuperAPI AI 工具集

reflect

智能体与模型

查看项目

更新于 10-16 16:27

技能介绍

Reflect 是一个技能(skill),用于从当前对话中挖掘可长期保留的经验,并将这些经验路由到对技能的编辑中。

用途

当用户说出“reflect”或“/reflect”时调用。当对话内容琐碎、跑题,或已被父级正确遵循的现有技能覆盖时跳过。一次性事件不算经验。

主要能力

  • 定位当前对话的活跃记录(transcript)。
  • 并行启动三个审查子代理,分别从判断、工具、发散三个视角审查。
  • 通过综合子代理汇总为 Accepted / Rejected / Backlog 列表。
  • 做结构性强制检查,把更适合由 lint 规则、脚本、元数据标志或运行时检查强制执行的项移入 Backlog。
  • 在用户明确批准后,按路由应用编辑;待办项直接提交到团队的 devex 或 backlog 跟踪器。

使用方式

  1. 定位活跃记录:在项目中用 t3_thread_search 搜索对话开头用户提示中的独特短语,不要传入其他项目的 projectId。对每个候选用 t3_thread_read 读取其第一条用户消息,取第一条消息等于对话开头用户提示的 threadId;若无匹配,则传入本次会话的紧凑摘要。
  2. 并行启动三个审查者:一个回合内发起三个 delegate_task 调用,每个标题标明其视角与目标。审查者需要 MCP 访问权限,以查询记录中引用的工单、聊天线程和可观测性追踪。
  3. 综合:发起一个 delegate_task 调用,标题为 Reflect synthesizer,通过 MCP 抽查引用,返回 Accepted / Rejected / Backlog 列表。
  4. 结构性强制检查:把可采纳项中更适合由 lint 规则、脚本、元数据标志或运行时检查强制执行的项移入 Backlog。
  5. 应用:先展示综合器的完整 Accepted / Rejected / Backlog 输出,等待用户明确批准后再应用任何可采纳编辑。用户选择子集,并可重定向路由。技能变更会影响组织内所有未来的代理,不要自动应用。待办项无需等待,直接提交到团队的 devex 或 backlog 跟踪器。
  6. 向用户总结:简短列表,无前言,包括已应用的编辑、新建的技能、已提交到 devex 跟踪器的待办项、被丢弃的项及原因。

路由规则

  • 琐碎的现有技能编辑(一行要点、收紧的句子、更正过时事实):由父级直接完成。
  • 实质性的现有技能编辑(新章节、新模式表、超过约 10 行):交给 skill-creator 技能,运行其 draft / test / iterate 循环。
  • tune description: <skill path>(技能存在但未在应触发时触发):交给 skill-creator,运行其描述优化循环。
  • new skill via skill-creator: <kebab-name>:把创建交给 skill-creator,不要临时发明形态。

若未安装 skill-creator,则在任何路由指向它的地方遵循 Authoring-a-skill playbook。若环境提供 SKILL.md 校验器,在声明完成前对每个被触及的技能运行它。

适用场景

适用于需要从对话中提炼可复用经验并沉淀到技能库的场景,尤其是团队希望把一次对话中的教训固化为未来代理可用的技能时。

限制

  • 大多数 pstack 技能是用户专用的,技能工具无法加载它们。
  • 每个 delegate_task 调用遵循 ../poteto-mode/SKILL.md 中 Subagents 部分的默认值。
  • 每个审查者和综合器在 ~/.config/pstack/pstack-models.md 中指定角色行;若无文件或无该行,角色在父模型上运行,并建议 /setup-pstack。若 orchestrator_capabilities 未列出已配置条目,该角色在父模型上运行并说明。
  • 技能变更影响组织内所有未来代理,因此不自动应用,必须等待用户明确批准。
  • 关于收费、价格、平台、效果等具体信息,资料中暂未提供。