Communitygithub.com

VdustR/skills

可复用的AI代理技能,由VdustR维护

skills 是什么?

该技能名为“会话回顾”(Session Retro),旨在帮助用户通过交互式对话回顾AI代理会话,发现改进机会,提升AI协作效率。它支持Claude Code、Cursor、Codex等主流平台,通过观察会话中的关键点、与用户讨论发现,并提出可操作的建议来工作。核心功能包括:无预设模板的自由观察、基于15个维度的安全检查清单、交互式深度探讨、子代理研究(需用户许可),以及最终生成行动建议摘要。技能强调不做执行操作(如提交代码、修改文件),仅提供分析和建议,适用于工作会话结束、遇到摩擦或想改进代理指令时使用。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add VdustR/skills

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

会话回顾

回顾AI代理会话,寻找改进机会。回顾通过交互式对话进行——观察所发生的事件,与用户讨论发现,然后提出可操作的建议。

目标是提高用户的AI协作效率:更好的提示词、更好的文档、更好的工具、更好的工作流。

快速开始

我们来回顾一下这个会话

/retro

从这个会话中我能改进什么?

会话回顾——寻找优化机会

何时使用

  • 在工作会话结束时进行反思并捕捉经验
  • 在遇到摩擦、修正或变通方案的会话之后
  • 当想要改进代理指令、技能、钩子或工作流时
  • 当好奇哪些社区技能可以帮助解决会话中看到的模式时
  • 定期进行以保持健康的开发实践

工作原理

以下流程是典型指导——根据对话自然调整。并非每个会话都需要所有步骤;一个简短且没有问题的会话只需快速观察并继续即可。

观察

回顾会话对话,自由识别任何值得注意的点。不要将自己限制在预定义的类别中——让观察结果根据实际发生的情况自然浮现。

对于每个观察,提供一行结论和一个初步的可操作建议。即使用户不深入探讨,每个观察也应提供有用的收获。

在开放式扫描之后,使用 dimensions.md 中的15个维度作为安全检查清单——扫描开放式观察可能遗漏的内容。仅标注真正值得注意的额外发现。

包括:

  • 反应性发现:出错或已修正的事项
  • 前瞻性发现:运行正常但未文档化的事项,或可被编码化的良好实践

交互式深度探讨

逐一呈现观察结果,并附进度指示(例如 [2/6])。对每个观察,给出初步建议并询问用户是否想深入探讨。

用户可能:

  • 说“是”——标记为深入探讨
  • 说“否”——继续(初步建议仍然有效)
  • 补充上下文或进行修正
  • 提出AI遗漏的观察
  • 说“够了”以跳过剩余内容并继续

在完成所有观察的浏览后,如果用户选择了任何需要深入探讨的项,评估哪些项真正需要子代理研究,哪些项足够清晰可以直接处理。在生成子代理之前,呈现此评估并请用户确认。

每个子代理遵循 subagent-guide.md 中的周期:彻底研究观察内容、分析根本原因、设计具体解决方案,并呈现带有建议的发现。

结果与讨论

逐一呈现每个子代理的结果并附进度。用户可以:

  • 讨论结果并提出后续问题
  • 接受推荐的选项
  • 请求修改
  • 跳过下一个结果

行动建议

在讨论完所有结果后,将确认的行动编译成建议摘要。对每个行动,呈现要做什么以及为什么。如果用户要求持久化(例如“写下来”),在聊天中输出Markdown摘要——不要写入文件。

显式关闭回顾:告知用户回顾已完成,建议的行动由用户在准备好时自行发起。

指南

要做的

  • 让观察结果从实际会话内容中浮现,而不是从固定模板中产生
  • 对每个观察都给出可操作的收获,即使没有深入探讨
  • 尊重用户的时间——如果会话很干净,直接说明并保持简短
  • 在生成子代理之前请求许可
  • 对于修正事项:调查根本原因是缺少约定、文档不清晰还是技能需要改进
  • 对于良好实践:建议在遗忘之前将其编码化
  • 在分析技能时:先检查所有权(自行维护 vs 社区维护)以提供恰当建议
  • 呈现建议时附带推荐和理由

不要做的

  • 执行任何操作(例如提交、推送、修改文件)。此技能仅用于分析和建议
  • 将用户的同意(例如“是”、“听起来不错”、“继续”)解释为执行请求。此类回应仅为确认
  • 在回顾明确关闭之前根据任何指令行动。只有在回顾结束后出现的新、具体的指令才是有效的行动请求
  • 强制使用僵化的阶段顺序——适应对话
  • 过度分析问题极少的会话
  • 未经用户许可生成子代理
  • 不解释原因就推荐变更
  • 在呈现选项时省略“不做任何事/跳过”选项
  • 对用户的提示词或工作流做出评判——保持建设性

参考文件

备注

  • 这15个维度是检查清单,而非评分标准。大多数会话仅会在少数几个维度上有信号。
  • 如果用户想要回顾多个会话,可以进行跨会话模式分析——在开始时如有疑问请询问范围。
  • 回顾后用户可能会单独调用的相关工具:hookify、claude-md-management、skill-creator、brainstorming。回顾不会直接调用这些工具。

相关技能