用途:reflect 用于在会话结束后分析本次对话,找出技能使用中哪些有效、哪些无效以及发现的边缘情况,并据此提出对技能文件的改进建议。
主要能力:识别信号,包括纠正(高置信度,如用户说“不对”“我指的是”)、成功(中置信度,如“完美”“正是这样”)、边缘情况(技能未预料的问题、需要变通方案的场景、未覆盖的功能)以及跨会话累积的偏好。随后按高/中/低优先级提出具体修改建议,并给出提交信息。
使用方式:在会话后运行 /reflect 或 /reflect [skill-name]。若未提供技能名,会询问要分析哪个技能。确认后读取 .claude/skills/[skill-name]/SKILL.md,用 Edit 工具应用修改,并执行 git add、git commit、git push origin main。若拒绝,可询问是否将观察结果追加到 OBSERVATIONS.md。
开关命令:/reflect on 启用会话结束自动反思,/reflect off 关闭,/reflect status 查看状态。状态保存在 ~/.claude/reflect-skill-state.json,以便跨插件升级持久化。
限制与注意:应用前必须展示确切改动,未经用户明确批准不得修改技能;提交信息应简洁;仅在提交成功后推送。技能仓库需在 .claude/skills 初始化并配置远程 origin。终端输出使用符合 WCAG AA 对比度的颜色,避免纯红配黑、红配绿。