用途:在 Sourcegraph 索引的代码库中搜索代码模式、示例,并理解系统运作方式。当遇到实现问题、调试,或需要弄清“X 如何工作”时使用。
工具选择逻辑:已知确切符号或模式用 keyword_search;只知概念而非具体代码用 nls_search;需要理解“如何/为何”用 deepsearch 后再 deepsearch_read;追踪符号用法用 find_references;需要完整实现用 go_to_definition 后 read_file;了解某用户参与过哪些代码库用 get_contributor_repos。其他工具包括 list_files、list_repos、commit_search、diff_search、compare_revisions。
作用域限定(应始终执行):repo:^github.com/ORG/REPO$ 精确仓库;repo:github.com/ORG/ 组织下所有仓库;file:..ts$ 仅 TypeScript;file:src/api/ 指定目录;file:..test.ts$ -file:mocks 测试且排除 mock。先缩小范围,结果为空时再扩展。可组合过滤,如 repo:^github.com/myorg/backend$ file:src/handlers lang:typescript。
典型工作流:实现新功能前先搜索既有相似实现并阅读测试;调试错误时先从堆栈或构建输出提取符号或错误码,定位出错点后用 find_references 追踪调用链,并用 diff_search 与 commit_search 检查近期变更;理解陌生系统时用 deepsearch 与 deepsearch_read。参考工作流文件包括 workflows/implementing-feature.md、understanding-code.md、debugging-issue.md、fixing-bug.md、code-review.md。
效率规则:逻辑串联搜索(search → read → references → definition);有精确词时优先 keyword_search;已知目标仓库时不要搜索全部仓库;简单“查找全部”勿用 deepsearch;不要重复读取已看过的文件。
限制:官方文本未提供该技能的许可、价格、平台支持范围及安装方式等信息,暂未提供。