SuperAPI AI 工具集

retro

编程与开发

查看项目

更新于 10-15 17:32

技能介绍

用途:retro 负责会话复盘建议。它读取一次 Pi 编码会话,返回针对智能体环境(指针、检查、标准、steering 文件、工具)的排序改进项,让后续运行更顺畅。改编自 mattpocock/skills 的上游 retro。

主要能力:只读,只提出建议,绝不编辑 steering 文件、设置或代码;应用建议属于另一项工作,经由 ask-skills 处理。内联工作,不使用子智能体。

使用方式:先选定会话,默认当前会话 PI_SESSION_FILE,否则用用户指定的会话;Pi 在 ~/.pi/agent/sessions/<encoded-cwd>/ 下每个会话保存一个 JSONL 文件,只读取该用户的本地日志。然后在本技能目录运行 python -B scripts/session_digest.py [SESSION.jsonl] 生成摘要,输出已脱敏的轮次与调用计数、成本、工具错误、最贵轮次、重复相同调用和最大工具结果;仅在摘要指向的行附近打开原始日志。提出任何检查前,先阅读仓库自身的检查命令与 CI(package 脚本、测试与 lint 配置、工作流),把已存在但未接线或损坏的检查作为发现,而非重新发明。

建议类别:导航(智能体长时间搜索文件或事实,提出它本会首先查看的导航指针)、自动检查(本可被 linter、类型检查、测试或文件检查捕获的错误;无任何护栏的仓库本身就是发现)、编码标准(先分类:机械性违规用确定性检查,真正需要判断的用文字标准并在评审时执行)、steering 文件(过长、从不改变行为的 no-op、或应改为检查或指向文档的常加载指令)、工具经济(昂贵或重复调用、可批量的单调用轮次、过大的工具结果、错误 shell 或路径形式导致的错误)、信息访问(智能体需要但无法获取的事实,提出最窄的只读访问)。

输出格式:按严重程度排序,每项包含标题与类别、Severity(high/medium/low)、Evidence(会话行或摘要条目,已脱敏)、Proposed change(一个具体改动及其位置),然后停止。完成标准:每个候选都引用会话证据并指明一个具体改动,且未编辑任何内容。

限制:只读,不修改代码或配置;只读取本地日志;需脱敏,仅引用命令、输出或日志行中承载信号的部分,将凭据、令牌、cookie、密码或个人标识替换为 <REDACTED>,不打印环境值或整条日志。资料未提供安装方式、收费与平台信息。