用途:Reflect Skills 是 reflect 家族的“组合管理器”。reflect 从单次会话学习,而它跨多次会话历史寻找反复出错的地方,并把已安装技能当作修复面:安装、编写、打磨或删除技能。
主要能力与用法:
- 发现并扫描会话日志。用自带扫描器查找近期记录:python3 scripts/scan_sessions.py --days 14。它会搜索标准本地位置(Claude Code 的 ~/.claude/projects/*/,Codex 的 ~/.codex/sessions、~/.codex/archived_sessions),也支持传入 --root,并跨会话聚合工具错误计数、重复错误签名和最嘈杂的工具。输出当作地图,只在确认模式时打开具体记录。
- 聚类为失败模式。把扫描结果归为带计数的命名模式,例如“Agent 手写 PDF 文本提取、失败、重试——4 个会话”。一个模式至少需要 2–3 次独立出现,单次事件回到 reflect 的观察台账。
- 通过技能组合解决每个模式,按成本从低到高:修复现有本地技能(触发不足通常是描述模糊,触发过度需要“不要用于……”排除项);安装生态技能,先搜索 npx skills find <pattern keywords>,匹配则提议 npx skills add owner/repo@skill;创建新技能(目录 + SKILL.md,描述含症状);移除或合并反复误触发、重复或针对已不存在工具的技能。若修复是规则、命令或脚本而非技能,交给 reflect 分类法。
- 记录并报告。结果写入 .reflect/applied.md(项目级)或 ~/.reflect/applied.md(用户级)。安装和移除默认需提议,除非用户预先批准。
限制与边界:会话日志敏感,只在本地读取、总结模式、丢弃细节,绝不把记录内容发往外部;生态搜索查询只用关键词,不用日志摘录。安装和移除技能会改变未来每次会话的运行内容,需带证据提议、经批准后应用。修改 reflect 家族此前创建的技能描述可以,修改手写或第三方技能仅限提议。若资料未提供具体收费、平台或效果信息,则暂未提供。