SuperAPI AI 工具集

retro

编程与开发

查看项目

更新于 10-26 18:53

技能介绍

用途:在每次会话结束、最终状态答复之前运行一次回顾,重点不是仪式,而是发现本次会话暴露、但交付物未覆盖的问题:工具缺口、重复机制、被忽略的债务。

主要能力(清单内容):

  1. 收尾检查:git status 是否干净;PR 是否已合并、已关注或已移交;bd in_progress 是否为 0 或有合理说明。会话结束时脏工作树意味着工作丢失,未关注的 PR 同理。
  2. 手工机制转为 codemod 候选:本次会话写过的临时脚本、jq 管道或多步 shell 单行命令都是信号;若机制具有通用性,应归属 bro 自身。可提交 bd 缺口项(标题写明缺失的命令,正文引用被迫发明的单行命令),若接口已存在则直接实现。文中示例:手写 agents.json 清理脚本对应 bro-k7a1(bro fleet agents prune 缺失)。
  3. 调用经济性:统计重复同一模式的调用次数,如 N 次 bd 关闭、N 次 gh api 获取、N 次状态轮询;若一个 bro 命令能批量完成,就是同类缺口项。
  4. 经验教训:持久化本次会话所学,仅干跑不存储任何内容。bro self learn capture --dry-run 可预览完成产物会提炼出什么;capture 没有会话过滤器,若计划全是本次会话内容,重跑裸 capture 即可存储;否则用 bro self learn add --lesson "…" --on … --evidence … 只存本次会话洞察,使下一次会话开始更聪明。
  5. 债务清扫:本次合并的 PR 用 bro review debt collect 收集评审者未解决的发现,不要任其腐烂。
  6. 状态断言:从权威检查验证而非记忆:gh pr view 查合并、git worktree list 查清理、bd show 查 beads。watcher 退出是需要检查的状态,而不是沉默。

使用方式与策略:按会话规模伸缩。未触及任何内容的一次性问答用一行跳过,回顾是审查不是忙工;写了代码、合并 PR 或生成代理的会话做完整检查。发现以 bd 项落地,绝不写成需要用户自行转换的段落。retro-on-stop 守卫只负责一行提醒,本清单才是“运行回顾”的实际含义。

适用场景:使用 theplenkov/bro 进行开发会话结束时的自检与债务整理。

限制:资料未提供安装命令、收费与价格、平台支持、效果数据;具体命令行为以项目实际为准。