用途:Retro 用于对当前 AI 智能体会话做系统性复盘,提取失败、险情与经验教训,并据此改进技能体系,降低同类问题再次发生的概率。适合在用户输入 retro、retrospective、lessons learned、improve skills、what went wrong 等指令时触发,也建议在较长或复杂的会话结束、发现“完成”其实未完成、出现现有技能未拦截的失败模式、以及上下文压缩前主动运行。
主要能力:先做对话审计,把问题归类为虚假完成、技能未加载、未查阅手册、过度工程、欠工程、钩子缺口、过时指引、范式不匹配、无价值开销等;再做根因分析,判断是缺少护栏、护栏不够具体、钩子未触发、验证步骤缺失、手册过时,还是架构本身的问题;随后修复技能文件、代理配置或记忆文件,并进行去重、单一事实来源、预提交钩子与测试等质量检查。还支持在修改后建议运行已配置的 T3_REVIEW_SKILL 做更系统的架构审查。
使用方式:依赖 rules 与 workspace 技能,并通过 ~/.teatree 变量配置,例如 T3_CONTRIBUTE、T3_MODE、T3_UPSTREAM、T3_PRIVACY、T3_REVIEW_SKILL。可编辑的技能直接改写,只读的则回退到仓库级代理指令、用户级代理配置或用户记忆文件。跨项目且可编辑的改动写入技能,项目专属的写入 overlay 或仓库级配置,环境或用户专属的写入相应记忆位置。修改后需通过隐私扫描,push 行为按模式决定:auto 直接推送并开 PR,interactive 本地提交并提示用户稍后运行 /t3:contribute。压缩前可用 t3-snapshot- 前缀的快照文件保存发现,恢复由钩子自动完成。
适用场景:任何类型会话均可使用,不限于 teatree 管理的项目;子代理不自行运行,而由编排者在会话层定期对累积的持久信号做综合。
限制:编辑性取决于技能是否位于 git 仓库;只读时只能写入回退位置。是否改进核心技能受 T3_CONTRIBUTE 控制。可编辑性或写入位置不确定时应询问用户。重复出现的行为问题应转为最小工具化强制措施,而不是重写同一条文字规则。具体平台文件与命令以文档说明为准,其余配置细节暂未提供。