用途:reflect 用于在活跃对话记录上生成三个并行评审子代理,从当前会话中挖掘可长期保留的经验,并把每条经验路由为对已有技能的具体修改。
触发时机:用户说出 reflect 或 /reflect;一个复杂任务(5 次以上工具调用)刚顺利完成且其做法值得保留;代理走过死路后找到可泛化的可行路径;用户在中途纠正了代理做法;出现了任何地方都未记录的非平凡工作流。对话琐碎、跑题,或已由父级正确遵循的现有技能覆盖时应跳过。一次性事件不算经验。
主要流程:1)定位活跃对话记录,按宿主的活跃历史资源、显式转录目录、$PSTACK_TRANSCRIPTS_DIR 的顺序解析,不得扫描其他工作区或全局厂商历史树;未能解析时改用会话摘要。候选文件需读取首行 JSONL 并核对开场用户提示。命令示例:ls -t <agent-transcripts>/.jsonl <agent-transcripts>//.jsonl <agent-transcripts>//subagents/*.jsonl 2>/dev/null | head -10。支持旧式扁平、当前嵌套、子代理三种布局。2)通过宿主任务设施并行启动三个评审子代理,分别按 Judgment、Tooling、Divergent 视角,授予读取转录及上下文查找所需工具权限,但禁止写入文件;宿主无法兼顾只读与外部工具时保留工具访问并在简报中禁止写入,由父级应用编辑。3)启动一个综合子代理,返回结构化 Accepted/Rejected/Backlog 列表。4)执行结构性强制检查,可将更适合由 lint 规则、脚本、元数据标志或运行时检查强制执行的条目从 Accepted 移入 Backlog。5)应用前必须向用户展示完整结果并等待明确批准,用户自选子集,技能变更影响组织内所有未来代理,不得自动应用;Backlog 条目自动提交到团队 devex/待办跟踪器。按 Routing 字段执行:琐碎的现有技能编辑由父级直接完成;实质性编辑使用宿主技能创作设施运行其草稿/测试/迭代循环;description 调优与新技能创建同样使用该设施或按包约定直接创作;若环境提供 SKILL.md 校验器,须在每个改动的技能上运行。6)向用户做简短总结:应用的编辑、创建的新技能、提交的 Backlog、被丢弃项及原因。
限制:不得扫描其他工作区或全局厂商历史树;子代理禁止写文件;不得自动应用技能变更;未提供定价、平台支持等更多信息。