用途
pstack-reflect 用于从当前对话中挖掘可长期保留的学习点，再把它们归入对技能的修改。它的定位是对“纠正”的反思，以及对源技能的可评审改进。
触发方式：用户说“reflect”或“/pstack-reflect”时调用。以下情况跳过：对话琐碎、跑题，或已由现有技能覆盖且父级已正确遵循。一次性的偶发情况不算学习点。
使用流程
1. 定位当前转录
在分派任务前，先找到本次对话的转录。若宿主暴露了活动对话 API，就使用该 API；否则调用 /pstack-recall 列出本仓库最近的 Codex 和 Claude Code 会话，并读取候选记录。不要对 ~/.claude/projects/*/ 或每个 Codex 会话做通配扫描，因为这会跨越工作区边界，读取无关项目的私密聊天。
对每个候选（从新到旧）读取其第一条用户提示，以及宿主此前注入的上下文，例如 Codex 记录为第一条用户消息的 AGENTS.md 指令。选取第一条用户提示包含本次对话开场用户提示的会话。若没有匹配项，则传入该会话的紧凑摘要。完成标志：转录路径或摘要已确定。
2. 并行派出三名评审
使用 /pstack-swarm 在等待任何一个之前同时启动三者，作为保留本会话 MCP 与连接器工具的原生子代理。评审需要 MCP 访问，以查证转录中引用的工单、聊天串和可观测性追踪；受工具限制的评审将失去这些能力。/pstack-swarm 会按用户配置的角色设置每个子代理的模型与投入，否则沿用会话设置。
三种视角及其提示模板：
- 判断：references/judgment-reviewer.md
- 工具：references/tooling-reviewer.md
- 发散：references/divergent-reviewer.md
逐字传入每个模板，在标记处替换为转录路径或摘要。评审者在其结果中返回发现。完成标志：三名评审均已返回发现，或已披露缺失的那一位。
3. 综合
通过 /pstack-swarm 启动一个子代理，配备与评审相同的 MCP 与连接器工具，由它通过 MCP 抽查引用。逐字传入 references/synthesizer.md，并在标记处内联每位评审的完整输出。它返回“接受/拒绝/待办”清单。完成标志：综合者已返回该清单。
4. 结构性约束检查
凡是 lint 规则、脚本、元数据标志或运行时检查能更可靠地强制的“接受”项，移到“待办”。参见 /pstack-principle-encode-lessons-in-structure。完成标志：剩余的每个“接受”项都只能靠指令承载。
5. 应用
完整呈现综合者的“接受/拒绝/待办”输出，并在应用任何“接受”修改前等待明确批准。用户挑选子集，并可改变归类方向。技能改动会影响组织内未来所有代理，不要自动应用。
在用户现有授权涵盖归档时，立即把每个“待办”项提交到团队的 devex 或待办跟踪器，无需等待；否则在摘要中作为提议列出。只有“接受”清单需要等待批准。
在技能源头编辑每个技能，即 /pstack-setup 记录的仓库或该技能安装来源，绝不修改已安装副本。批准前展示每个技能的目标位置。绝不开 PR 或推送。
严格遵循每个已批准行中的归类（Routing）：
- 琐碎的现有技能修改（一行要点、收紧一句、更正过时事实）：由父级直接完成。
- 实质性的现有技能修改（新章节、新模式表、超过约 10 行）：用 /writing-for-agents 起草，在代表性案例上演练，修订至案例通过。
- tune description: <skill path>（技能存在但在应触发时未触发）：交给 /writing-for-agents 调整描述，即决定技能何时加载的指针。
- new skill via writing-for-agents: <kebab-name>：把创建交给 /writing-for-agents，不要临时臆造形态。
若环境提供 SKILL.md 校验器，在宣布完成前对每个被触及的技能运行它。完成标志：每个已批准修改均已应用并校验，其余“接受”项已记为拒绝。
6. 向用户总结
简短列表，不加前言：
- 已应用修改：<skill path>。每行说明改了什么。
- 新建技能：<skill path>。每行一条（少见）。
- 已归档到 devex 跟踪器的待办：<issue title>（<tags>）。每行一条。
- 放弃项：每条被拒发现一行，附综合者给出的原因。
完成标志：每条评审发现都恰好出现在上述某一行中。
适用场景与限制
适用于需要对对话中的纠正做复盘、并据此持续改进技能库的场景。限制包括：仅在用户显式触发时执行；不自动应用改动，需用户明确批准；不自动开 PR 或推送；不在无关项目间跨工作区读取转录；能否执行部分步骤取决于宿主是否提供活动对话 API，资料未说明其他环境下的完整替代方案。