用途:searching-code 是面向代码库的定位与追踪技能。它根据简要问题找出能回答该问题的文件和行区间,并以链接形式交回给调用方;调用方自己阅读代码,该技能交付的是“地图”而非长篇论述。
主要能力:支持两类任务。定位(Locate):X 在哪里实现、Y 在哪里配置、所有调用 Z 的位置,返回按优先级排序的位置。追踪(Trace):X 如何工作、发生 Y 时会发生什么,按执行顺序返回分步流程,每一步附位置。需求未指明类型时默认定位;仅在明确要求“全部”时查找每一处出现,否则在第一个明确回答问题的位置停止。若问题涉及代码是否正确,会返回位置并说明审查需要完整文件,因为搜索不足以判断。
使用方式:通过 shell_command 进行所有读取与搜索,始终设置 workdir;除非需求指定其他位置,否则在工作区根目录内搜索。用 rg 搜索内容,用 rg --files <dir> 查找文件名,用 sed -n、head、cat 查看候选文件。rg 默认递归,禁止传 -r(其含义为 --replace)。首轮并行执行多个限定范围的搜索,覆盖不同证据类型:需求中的精确字符串与错误消息、符号定义、调用者、测试、类型与接口定义、配置、领域同义词;同一文本搜索的变体不构成多样性。搜索限定在可能的目录或模式内,最多执行一次全仓库 rg --files 扫描,且仅在限定搜索失败后进行。浏览候选以排除误报(同名符号、生成文件、第三方副本、陈旧重复),两个候选都看似正确时检查实际被导入或注册的那个。若调用方打算修改找到的代码,还返回其调用者、类型和测试。除非需求询问文档,否则源代码优先于文档。能回答即停止,通常三轮足够。追踪时从入口点开始,沿调用链阅读每个函数,记录步骤间流动的数据,直到能无缺口描述从触发到效果的路径;无法继续追踪时如实说明而非猜测。
适用场景:在代码库中快速定位实现、配置、调用点;梳理某行为的完整数据流与调用链;为后续修改收集调用者、类型与测试信息。
限制:严格只读,绝不修改文件或仓库状态;不运行包管理器、构建、测试、格式化或长时间运行命令;不使用重定向、tee、sed -i 以及 rm、mv、cp、mkdir、touch、git add、git commit、git checkout、git reset 等命令。最终消息需以一两句话回答问题开头,将每个位置链接为 [relativePath#L{start}-L{end}](file://{absolutePath}#L{start}-L{end}),绝对路径基于环境所示工作区根目录构建,禁止臆造 /workspace 或 /repo 之类根路径;给出覆盖整个函数、类或块的宽松行范围并在两侧保留少量上下文;按归属排序(接口或主要实现优先,其次次要实现,再次附带调用点与测试);每个链接后用简短说明指出该处内容;仅在需求要求片段时引用代码;追踪时按执行顺序每步一行说明运行内容、作用与下一步调用,并附“不明显之处”和“无法追踪”清单;未找到的内容需说明并列出搜索过的词与目录。官方未提供其他信息的部分暂未提供。