SuperAPI AI 工具集

code-exploration

编程与开发

查看项目

更新于 10-15 21:52

技能介绍

用途:当用户需要了解本地仓库之外的内部代码时,用 Glean 的代码搜索在整个组织范围内探索代码。适用于:某功能在其他仓库如何实现、某系统或服务的代码在哪里、谁在维护某代码库、组织内相似实现、内部 API 或库的用法示例、其他团队采用的代码模式。

主要能力:通过 Glean MCP 工具检索代码与文档。工具命名参见 glean-tools-guide 技能,遵循 mcp__glean_[server-name]__[tool] 模式,服务器名称为动态。工具选择:按内容、模式或文件查找代码用 code_search;查找相关设计文档或规格用 search;识别代码负责人或贡献者用 code_search 加 employee_search;读取完整文件内容用 read_document。

使用方式:Glean 代码搜索支持自然语言,可用过滤条件提高精度,例如:code_search "authentication middleware"、code_search "owner:"John Smith" billing service"、code_search "from:me updated:past_week"、code_search "after:2024-01-01 payments API"、code_search ".proto user service"。探索某系统的推荐流程:先用 code_search 找代码,再筛选质量与时效,然后用 search 找设计文档,用 code_search "owner: [system] updated:past_month" 找相关人员,最后用 read_document 读取通过筛选结果的详情。也可引导使用相关斜杠命令:/glean-code:codebase-context、/glean-code:find-examples、/glean-code:code-owners、/glean-code:similar-code。

限制与注意事项:结果需审查,按质量(是否清晰、有测试、活跃维护)、时效(近三个月有提交为活跃,三到十二个月为放缓,超过十二个月可能过时)、相关性(直接回答、相关但语境不同、仅关键词匹配)判断。应过滤 /deprecated/、/old/、/legacy/ 路径下的代码、已废弃仓库、原型或实验代码、含大量 TODO/FIXME 的代码。质量优先于数量,三个好例子胜过十个平庸例子。与本地 grep、glob 的差别在于可跨组织全部仓库搜索。若未找到优质代码,应说明已执行的查询与被过滤匹配项及原因,并建议查外部库、在相关频道询问或从头构建,不要用弱结果充数。费用、平台、安装方式等信息暂未提供。