SuperAPI AI 工具集

research-after-failure

编程与开发

查看项目

更新于 10-16 07:05

技能介绍

用途

这是一个面向开发过程的技能(skill),用于在同一个问题连续两次解决失败后中断“盲目重试”,转而为下一次尝试做有依据的研究。资料给出的核心原则是:重复同样的做法却期待不同结果是不合理的。

主要能力

  • 触发识别:当某个问题连续两次尝试失败时触发;触发时应公开宣告“我已经失败两次。我停下来先研究,再继续尝试”。
  • 失败与进度的区分:资料列出属于失败的情形(测试不通过、构建失败、功能不生效、同一错误反复出现、没有进展)和不属于失败的情形(修复了轻微语法错误、更正拼写、IDE 自动补全问题、出现不同错误表示有进展、有部分进展)。
  • 研究协议:文档给出 7 个步骤:1)记录失败(记录每次尝试的做法、结果、错误以及失败的共同模式);2)查阅仓库文档(README、docs 目录、CONTRIBUTING、用 grep 搜索相关文档);3)检索现有代码库(搜索相似模式、用 git log 搜索相关提交、在测试文件中寻找用法示例);4)在线研究(搜索精确错误信息、库文档、Stack Overflow、GitHub Issues);5)综合发现(从仓库文档、代码库、在线来源归纳,并形成新方案);6)更新 Issue(用 gh issue comment 发布研究结论);7)以新知识恢复尝试。
  • 升级机制:若研究之后的第三次尝试仍然失败,考虑升级给人工,并给出升级说明的模板(尝试过什么、研究过什么、当前理解、阻塞性问题),并将 Issue 标记为 Blocked。
  • 研究优先级:错误信息 → 本地文档 → 现有代码 → 库文档 → 在线搜索。
  • 时间盒:本地文档 5 分钟,代码库搜索 10 分钟,在线搜索 15 分钟,研究总计最多 30 分钟;30 分钟无突破则升级。
  • 反模式对照:不要继续重复同一做法、不要无限期研究、不要忽略错误信息、不要跳过本地文档、不要靠猜。

使用方式

资料给出的触发方式是连续两次失败后启动该技能;技能由 issue-driven-development 的 Step 8(验证循环)触发,并会调用 issue-lifecycle(发布研究发现)与 memory-integration(存储发现以供后续参考)。研究过程建议按上述 7 步执行,并在时间盒内完成。资料同时给出若干命令示例,例如查看 README、列出 docs 目录、按关键词 grep、用 git log 搜索、按错误信息在线搜索、用 gh issue comment 更新 Issue 等。

适用场景

适用于开发与问题排查流程中反复尝试仍无法解决、需要从文档、代码库和在线资源中寻找依据后再继续的场景,尤其适合与 Issue 驱动的开发流程配合使用。

限制

资料未提供该技能的安装方式、平台限制、收费或价格信息;也未说明在自动化环境中的具体执行细节。研究时间盒与优先级为资料中的建议,不代表已验证效果。