SuperAPI AI 工具集

retro

编程与开发

查看项目

更新于 10-16 06:15

技能介绍

用途:对已发生的错误或需要强制执行的新约定做复盘,找出失败模式与根因,并提出可落地的预防方案。触发场景包括事后复盘(出了问题、防止复发)和约定推行(新增基础设施、工具或规则,如何让他人无法违反)。

使用方式:调用 /retro 并附上发生了什么或要执行的规则描述;也可仅输入 /retro,由技能向用户询问上下文。

工作流分五步。一、理解:读取相关代码、git 历史、CI 日志与报错信息,回答发生了什么、根因是什么、是否为重复模式(用 git log、grep 检索类似历史)。二、分析:将失败模式分类为错误 API 使用、缺失校验、约定违反、配置漂移、集成缺口、知识缺口,并在代码库中查找可能存在同样潜在问题的类似代码,报告影响面。三、提出预防:按严格优先级排序——优先级1 让错误无法表达(编译/类型层面、API 设计、删除已弃用接口);优先级2 静态分析(自定义 lint 规则、编译器标志、vet/staticcheck、pre-commit 钩子);优先级3 自动化测试(复现失败的单测、属性/模糊测试、集成测试、CI 门禁);优先级4 运行时守卫(入口断言、校验中间件、安全默认值的功能开关);优先级5 流程与评审(PR 模板清单、CODEOWNERS、指定评审人);优先级6 文档(AGENTS.md/CLAUDE.md 规则、README 警告、代码注释)。四、实施:对每项预防给出具体实现(如实际规则代码而非只说“加个 lint 规则”),评估影响范围,先呈现计划并取得确认后再实施,优先落地可行的最高优先级方案。五、记录:保存简要条目,含模式、根因、预防措施与优先级层级,并考虑是否应沉淀为记忆、AGENTS.md 规则或已实现的 lint 规则/测试。

风格:直接说明因何出错、如何使其不可能发生;以可复制粘贴的代码代替空泛描述;高优先级方案不可行时须先说明原因再降级;语言与用户一致。

限制:资料未说明具体支持的代码库语言范围、依赖或安装方式;实际实施效果取决于项目可用的工具链,暂未提供相关保证。