用途:当需要了解其他团队如何使用某个内部 API、库或代码模式时,可跨仓库搜索使用示例。若请求中未指明具体的 API、库或模式,应先向用户确认再继续。
主要能力:按多个检索阶段查找使用情况、不同用法变体以及相关文档;对找到的每个示例从质量、时效、上下文和相关性四个维度进行评估,区分可收录、需谨慎和应拒绝的示例;识别反模式信号,例如吞掉错误的大段 try/catch、被注释掉的代码、TODO 注释、位于 /deprecated/、/old/、/legacy/ 路径的文件、跳过的测试或完全没有测试、以及仓库近期无提交。
使用方式:先用 code_search 搜索导入或引用、使用示例、实现方式等;再搜索配置、测试等变体;随后用 search 查找使用指南、入门文档和最佳实践。评估时可参考的时效判断为:6 个月内、6 至 12 个月可能过时、12 个月以上且无活动。最终按摘要表格、官方文档、推荐示例、有注意事项的示例、观察到的常见模式、可复用的共享库和可咨询人员等结构呈现结果。若未找到高质量示例,应说明匹配数量及其问题,并建议查阅官方文档、在相关渠道询问或思考该用法为何不普及。
适用场景:为采用内部 API 或库寻找可参考的现有实现,或判断某个代码模式在组织内的通行做法。
限制:全部操作依赖组织内的代码搜索与文档搜索能力,具体实现细节和权限范围暂未提供;是否支持某些仓库或语言也暂未提供。