用途：通过 Qodo 的只读工具理解代码、历史改动与跨仓库耦合，然后把带引用的发现交回，用于回答问题、规划代码变更、调试回归或界定修复范围。它可访问本地磁盘上没有的仓库，并跨越仓库边界；只调用读取工具，不向代码托管平台写入。
前提：所需工具通过已连接的 QAR 托管工具 MCP 服务或 Qodo CLI 提供；工作区需暴露只读的 Codebase、pull-request 或 cross-repo 工具；当前会话需加载提供方所属的 Qodo 技能包。
使用方式：优先走 MCP——使用宿主提供的工具描述、inputSchema 与 readOnlyHint，只调用只读工具，需要时显式传 repo（MCP 不像 CLI 那样推断本地 Git origin），使用前检查 isError。代表性调用名包括 litegit-search-repos、litegit-grep、litegit-read-file、pull-request-similar、cross-repo-relations，实际名称与参数以已连接目录为准。CLI 路径示例：qodo --version（兼容性探测，最先运行），qodo read codebase search-repos --query "payments" --json，qodo read codebase grep --repo owner/repo --pattern "chargeCard" --json，qodo read codebase read-file --repo owner/repo --path src/pay.py --json，qodo read pull-request similar --repo owner/repo --query "retry failed charge" --json，qodo read cross-repo relations --repo owner/repo --json。技能要求 Qodo CLI 1.6.0 或更高；版本过低时不应执行 whoami、login 或托管工具，应说明技能比运行时新，并给出 qodo update。
工具分组：当前代码用 qodo read codebase；历史与先例用 qodo read pull-request；影响与耦合用 qodo read cross-repo。做法是先廉价发现再取回：search-repos、pull-request stats、cross-repo relations 定向，再用 grep、find、blame、list-commits、pull-request similar/by-file 定位，最后才 read-file（可用 --start-line/--limit-lines）、get-pr、patch 取回细节。
适用场景：定位定义与调用点、查找过去如何实现某类改动、判断改动影响范围与仓库依赖、结合提交与 PR 追查回归原因。
限制：只读，禁止调用 approve、post-comment、set-labels、update-description 等写入工具；不要猜测仓库 slug、路径、PR 号或 SHA，需先解析；pull-request 仅含已合并 PR，不含开放或草稿；cross-repo 边可能处于 pending 或 not_found；空或截断结果应缩小范围重试一次，仍无则如实报告未找到。来源不一致时先比较仓库、分支与修订；本地文件代表当前工作树，远程 read-file 代表抓取的修订，不代表本地改动或部署行为。MT-TOOL-LOOP 错误应停止并改变方法而非重试。引用需给出仓库、path:line、PR 号、commit SHA；无法定位来源的事实应明说而不编造。认证、工具不可用、限流等错误应保留原始错误码与信息，不得替换为猜测的仓库事实。其他如具体收费、价格或平台信息暂未提供。