会话回顾
回顾AI代理会话,寻找改进机会。回顾通过交互式对话进行——观察所发生的事件,与用户讨论发现,然后提出可操作的建议。
目标是提高用户的AI协作效率:更好的提示词、更好的文档、更好的工具、更好的工作流。
快速开始
我们来回顾一下这个会话
/retro
从这个会话中我能改进什么?
会话回顾——寻找优化机会
何时使用
- 在工作会话结束时进行反思并捕捉经验
- 在遇到摩擦、修正或变通方案的会话之后
- 当想要改进代理指令、技能、钩子或工作流时
- 当好奇哪些社区技能可以帮助解决会话中看到的模式时
- 定期进行以保持健康的开发实践
工作原理
以下流程是典型指导——根据对话自然调整。并非每个会话都需要所有步骤;一个简短且没有问题的会话只需快速观察并继续即可。
观察
回顾会话对话,自由识别任何值得注意的点。不要将自己限制在预定义的类别中——让观察结果根据实际发生的情况自然浮现。
对于每个观察,提供一行结论和一个初步的可操作建议。即使用户不深入探讨,每个观察也应提供有用的收获。
在开放式扫描之后,使用 dimensions.md 中的15个维度作为安全检查清单——扫描开放式观察可能遗漏的内容。仅标注真正值得注意的额外发现。
包括:
- 反应性发现:出错或已修正的事项
- 前瞻性发现:运行正常但未文档化的事项,或可被编码化的良好实践
交互式深度探讨
逐一呈现观察结果,并附进度指示(例如 [2/6])。对每个观察,给出初步建议并询问用户是否想深入探讨。
用户可能:
- 说“是”——标记为深入探讨
- 说“否”——继续(初步建议仍然有效)
- 补充上下文或进行修正
- 提出AI遗漏的观察
- 说“够了”以跳过剩余内容并继续
在完成所有观察的浏览后,如果用户选择了任何需要深入探讨的项,评估哪些项真正需要子代理研究,哪些项足够清晰可以直接处理。在生成子代理之前,呈现此评估并请用户确认。
每个子代理遵循 subagent-guide.md 中的周期:彻底研究观察内容、分析根本原因、设计具体解决方案,并呈现带有建议的发现。
结果与讨论
逐一呈现每个子代理的结果并附进度。用户可以:
- 讨论结果并提出后续问题
- 接受推荐的选项
- 请求修改
- 跳过下一个结果
行动建议
在讨论完所有结果后,将确认的行动编译成建议摘要。对每个行动,呈现要做什么以及为什么。如果用户要求持久化(例如“写下来”),在聊天中输出Markdown摘要——不要写入文件。
显式关闭回顾:告知用户回顾已完成,建议的行动由用户在准备好时自行发起。
指南
要做的
- 让观察结果从实际会话内容中浮现,而不是从固定模板中产生
- 对每个观察都给出可操作的收获,即使没有深入探讨
- 尊重用户的时间——如果会话很干净,直接说明并保持简短
- 在生成子代理之前请求许可
- 对于修正事项:调查根本原因是缺少约定、文档不清晰还是技能需要改进
- 对于良好实践:建议在遗忘之前将其编码化
- 在分析技能时:先检查所有权(自行维护 vs 社区维护)以提供恰当建议
- 呈现建议时附带推荐和理由
不要做的
- 执行任何操作(例如提交、推送、修改文件)。此技能仅用于分析和建议
- 将用户的同意(例如“是”、“听起来不错”、“继续”)解释为执行请求。此类回应仅为确认
- 在回顾明确关闭之前根据任何指令行动。只有在回顾结束后出现的新、具体的指令才是有效的行动请求
- 强制使用僵化的阶段顺序——适应对话
- 过度分析问题极少的会话
- 未经用户许可生成子代理
- 不解释原因就推荐变更
- 在呈现选项时省略“不做任何事/跳过”选项
- 对用户的提示词或工作流做出评判——保持建设性
参考文件
- dimensions.md — 作为安全检查清单的15个分析维度
- subagent-guide.md — 子代理如何研究、分析和呈现发现
备注
- 这15个维度是检查清单,而非评分标准。大多数会话仅会在少数几个维度上有信号。
- 如果用户想要回顾多个会话,可以进行跨会话模式分析——在开始时如有疑问请询问范围。
- 回顾后用户可能会单独调用的相关工具:hookify、claude-md-management、skill-creator、brainstorming。回顾不会直接调用这些工具。