SuperAPI AI 工具集

understand

编程与开发

查看项目

更新于 11-08 05:20

技能介绍

该技能用于帮助用户真正理解某个具体对象,而不是听一段解释。资料将其定位为苏格拉底方法中“诘问”(elenchus)的实用用法:不假装无知,不隐瞒已知信息,也不把每个问题都反弹成另一个问题。

主要能力与流程:

  1. 确定目标与用途。目标可以是 git 版本或路径、PR 编号或链接、工单或文档链接、粘贴的文本或 diff、用文字描述的功能。技能会先确认要理解什么,再询问用户接下来要用它做什么,例如评审、扩展、调试或接手。用途决定提问边界与结束标准。

  2. 先阅读再提问。技能会告知用户自己先阅读,然后并行启动子代理从三个角度收集事实:端到端做了什么、触及和被谁触及、哪里会让熟练读者感到意外。要求每项结论带可打开的文件与行号引用,并说明未覆盖的部分。技能强调以代码为事实依据,工单、SPEC 或 PR 描述只是意图声明,二者差距往往正是困惑来源。

  3. 先问用户已有看法。在揭示事实前,先问用户认为它做什么、怎么做,以及打算用它做什么。若用户完全没接触过,会建议先转用 /eli5 类解释方式,而不是在空白基础上盘问。若用户模型已正确,则直接进入收尾判断。

  4. 一次只问一个问题。每轮只问一个问题,且整轮发言不超过四句话。问题聚焦后果而非内容,例如并发、失败、空输入、第二个调用者、数据翻倍等边界,并根据第 1 步的用途选择相关边界。技能要求不询问未经验证的前提;用户答错时指向具体文件和行号让其自行推导,用户答对一半时指出成立的一半并追问不成立的一半,用户卡住时缩小问题或提供一个事实再问,用户反问时直接基于事实回答。

  5. 以能否预测作为结束标准。当用户能不经提示正确说出未讨论过的后果两次,即可结束;若约八个实质问题后仍未达到,也会停止并说明进展。收尾控制在十行以内,概括用户现在掌握的结构、因用途不需要而略过的内容,以及双方都无法确认的缺口。

适用场景:代码评审前理解变更、接手陌生模块、调试前建立模型、理解计费等功能需求。限制:资料未提供安装命令、价格或平台信息;当目标不在当前仓库时,提问将缺乏代码依据;过大的 diff(约超过 1500 行)需要缩小目标;没有子代理时只能基于限时浏览,效果较弱。