SuperAPI AI 工具集

codebase-exploration

智能体与模型

查看项目

更新于 10-15 22:41

技能介绍

用途:在陌生仓库中定位与理解结构时,避免因逐个打开文件而把大量源码塞进主上下文。该技能主张先委派侦察、后读源码,让主上下文保持干净,只读真正关键的文件。

主要能力:把 2-4 个相互独立、只读的侦察切片交给各自子智能体,例如功能接线、构建与测试布局、改动符号的调用点、配置与数据模型所在位置。子智能体返回紧凑的“路径 → 一句话职责”表,并附 1-2 句关联说明;调用点给出 file:line,并说明未找到的内容。汇总成关键文件地图后,再在主上下文读取 3-5 个确认相关的文件。可选:为常访问的仓库持久化结构索引,注明日期,供下次直接读取。

用法:先写出 2-4 个定向问题,每个问题可独立回答且覆盖不同区域;每个问题启动一个只读子智能体,明确禁止扩大范围,要求返回表格而非叙述;相互独立的切片应同时启动。得到地图后再读取负载关键的文件。

限制与注意:不要让编排者自行“顺便看一眼”,否则主上下文仍被污染;切片重叠会重复读取并浪费预算;地图在编辑后会过期,只是起始阅读清单而非实时事实来源,行动前需重新 grep 可能失效的条目,持久化索引要标日期;子智能体返回长篇叙述时应要求改回表格;小仓库过度委派成本更高,已知道路径或一两次 grep 即可确定时直接查看。侦察智能体只读,不应编辑或重构代码。