用途:在组织内多个仓库间规划功能、界定改动范围或设计实现,尤其适合改动跨越仓库契约边界(API 参数、请求/响应结构、事件负载)或相关代码未在本地克隆的情况。
主要能力与工具路由:查找涉及哪些仓库用 repo_search;在仓库内按符号或正则查找代码用 remote_grep;按文件名或 glob 查找文件用 remote_file_search。所有搜索必须走 Baz 工具,禁止用读取或 shell 工具做目录列举、递归树抓取、代码爬取;读取工具只用于打开已知文件路径,Baz 没有整文件读取工具。
推荐流程:先用宽泛关键词调用一次 repo_search 定位仓库,结果非 LLM 排序需自行判断;结果为空则按名称选一个仓库进入下一步,结果过大则加 domains 过滤再调一次。随后用 remote_grep 或 remote_file_search 定位代码,remote_file_search 的模式必须含命名 token,不能只写扩展名。拿到具体路径后再读取文件,最后产出计划:需改动的文件(仓库+路径)、改动顺序、跨仓库协调事项、需用户回答的开放问题。
搜索预算:每次 MCP 搜索约 3 秒。同一(仓库, 路径)对超过 3 次搜索后必须先读取至少一个匹配文件才能进行第 4 次;整个规划运行最多 10 次搜索,达到上限应停止搜索并读取已有最有希望的文件。新增枚举值、接口实现、分发分支等用例时,应对已有同类标识符做一次全仓库搜索,找出所有注册点(枚举、工厂、switch、路由表、配置)并在计划中逐一处理。
限制与注意:不要要求用户克隆仓库;不要用改写关键词重复调用 repo_search;不要把探索委托给仅本地的通用子代理;若派生子代理且工作涉及本地检出之外的代码,须在提示中要求其使用 Baz MCP 工具。调用时需传入上下文注入的 sessionId(始终必需),以及条件提供的 sessionRepository 和 agentVendor,不得自行猜测。本技能仅覆盖搜索,计划撰写与是否上传属于 plan-with-baz 技能。