用途:reflect 用于把一次复杂任务中产生的经验沉淀为可复用的技能改动。触发场景包括用户说出 reflect 或 /reflect;一个复杂任务(5 次以上工具调用)刚顺利完成且流程值得保留;代理走过死路后找到可推广的正确路径;用户在任务中途纠正了代理做法;出现了尚未被任何技能记录的非平凡工作流。若对话琐碎、跑题,或已有技能已正确覆盖,则跳过;一次性事项不算经验。
主要能力:先定位当前活动的对话记录文件,需处理三种布局——旧版扁平(<id>.jsonl)、当前嵌套(<id>/<id>.jsonl)和子代理(<parent>/subagents/<child>.jsonl)。资料给出的命令为: ls -t <agent-transcripts>/.jsonl <agent-transcripts>//.jsonl <agent-transcripts>//subagents/*.jsonl 2>/dev/null | head -10 对每个候选读取首行 JSONL,检查 message.content[0].text 是否包含会话的开头用户提示,以确定匹配路径;若无法解析,则写一份紧凑的会话摘要替代。
随后在一条消息中发出三个并行审查子代理(subagent_type 为 generalPurpose,各自指定模型,agent mode readonly: false),分别从判断、工具、发散三个视角审查,使用 references/judgment-reviewer.md、references/tooling-reviewer.md、references/divergent-reviewer.md 模板,逐字传入并替换标注处的记录路径或摘要。再发出一个综合子代理,使用 references/synthesizer.md,返回结构化的 Accepted / Rejected / Backlog 列表。
经过结构强制检查后,把更适合由 lint、脚本、元数据标记或运行时检查强制执行的项从 Accepted 移入 Backlog。应用前须先向用户展示完整的 Accept/Reject/Backlog 输出并等待明确批准,因为技能改动会影响组织内所有未来代理;Backlog 项自动提交到团队的 devex/backlog 追踪器。获批的 Accepted 项按 Routing 字段执行:琐碎的现有技能编辑由父代理直接完成;实质性编辑交给 Cursor 内置的 create-skill 技能走其草稿/测试/迭代循环;描述调优交给 create-skill 运行描述优化循环;新技能同样交给 create-skill。若环境附带 SKILL.md 校验器,需在完成前对每个被改动的技能运行。最后向用户给出简短汇总,包括已应用编辑、新建技能、提交到追踪器的 Backlog 项和被丢弃项及原因。
限制:资料未提供该技能的定价、平台依赖细节、具体支持的模型名称范围以外信息;默认输出要求只返回结果、阻塞项和必要证据,省略前言、过程叙述、重复上下文、置信度分数和后续提议,除非必需产物或 schema 需要更多,否则最多五条要点。