用途：该技能用于把 gitquarry 当作工具来驱动，而不只是选用某个基准搜索预设。先加载与已安装 CLI 版本匹配的指南：gitquarry skills get gitquarry，gitquarry agent 是同一核心指南的简写。
工作流：把任务归类为 auth、search、inspect、compare、tree、code、recipe、mcp、config 或 scripting；先确认有效主机；用能解决问题的最窄命令；优先原生搜索，仅在确需更广覆盖、重排、README 证据或解释输出时启用 discover 模式；优先结构化标志而非把 GitHub 限定符塞进自由文本查询；脚本、CI 和智能体运行优先 json 或 compact 加 --progress off。
命令选择：auth login|status|logout 处理凭证；search 做仓库发现与排序；inspect <owner/repo> 检查已知仓库；compare <owner/repo>... 并列对比已知仓库；tree <owner/repo> 免克隆查看路径；code <owner/repo> <pattern> 免克隆远程代码搜索；recipe run <file> 可复现执行 TOML 搜索配方；mcp 仅用于 MCP 客户端把 gitquarry 启动为 stdio 服务器；config path|show 查看有效配置。
tree 与 code：路径够用时优先 tree；有界字面量或正则搜索优先 code，可加 --path、--depth、--limit、--max-file-bytes、--reference，仅需正则语义时用 --mode regex，默认为字面量搜索。
搜索：先 gitquarry search "<query>"，加 --language、--topic、--org、--user、星标范围、日期窗口等结构化过滤，再升级到 discover；--mode discover 用于更广候选收集、本地重排、README 感知重排或解释驱动分析，未指定 rank 时默认 blended；更安全的高级预设为 --mode discover --depth balanced --rank quality --explain；--readme 作显式第二遍；调试用 --plan；--probe-path、--probe-code 提供免克隆证据，结合 --probe-limit 等保持有界。
对比与 recipe：compare 仅用于已知仓库，不发现候选也不计算信任分；--tree-summary 与 --readme 按需添加。recipe run 用于共享、已评审的仓库、文档、CI 或事件手册流程；不要在 recipe 中放凭证，用主机作用域认证或令牌环境变量；CLI --host 优先级高于 recipe host。
MCP：gitquarry mcp 是面向 MCP 客户端的 stdio JSON-RPC 服务器，勿当交互命令运行；注册示例：codex mcp add gitquarry -- "$(command -v gitquarry)" mcp；GitHub Enterprise 用 gitquarry --host https://ghe.example.com mcp；工具返回 JSON 文本内容。可用工具为 gitquarry_search、gitquarry_inspect、gitquarry_tree、gitquarry_code、gitquarry_compare、gitquarry_skill。
输出：pretty 供人阅读，json 供自动化，compact 供管道或日志，csv 供扁平导出；非交互运行优先 --progress off。
主机与认证：凭证按主机作用域处理；非默认主机用 --host；多主机脚本用 GITQUARRY_TOKEN_GITHUB_COM 等主机专用环境变量；用 GITQUARRY_CONFIG_DIR 隔离状态；除非显式设置 GITQUARRY_ALLOW_INSECURE_STORAGE=1，不要假设允许不安全凭证回退。
失败处理：discover 专属标志需配合 --mode discover；原始限定符与结构化标志冲突时去掉一侧；inspect 与 compare 输入须为 owner/repo；recipe 报 E_RECIPE_INVALID 时修正未知键、TOML 或搜索标志映射；tree 或 code 过宽先用 --path、--depth、--limit 收窄；认证失败先核对令牌、主机与解析顺序。
参考文档仅在需要时阅读，包括 references/benchmark-operator-playbook.md 与各命令文档。