用途：围绕一个明确需求发现 GitHub 仓库、筛选候选，并对比开源方案。适合「找最适合某用途的开源 X」「为某技术栈筛选 GitHub 项目」「某仓库的替代方案」「对比某类仓库」等提问，也可用于先核实某个被点名仓库是否如预期。默认交付物是对话内的 Markdown 短名单，附仓库证据；深度对比、功能矩阵和 HTML 导出属于可选的末段分支，不是默认行为。
主要能力：按需触发验证优先流程，先用 gh search repos 'NAME' --limit 5 确认被点名对象所属类别；按生态成熟度设定 star 阈值（新兴领域如 AI agents、MCP 通常不需阈值，成熟生态用 stars:>500+）；首轮 3-6 个搜索角度，先按名称、描述、topics、星标、近期活动、归档状态、许可证做 Relevant/Maybe/Off-topic 分类表，再最多做一轮 1-4 条查询的细化；对入选仓库生成证据包。深度评估硬上限 5 个仓库，超过需说明理由。
使用方式：先运行 gh auth status 检查认证，建议使用 GH_TOKEN/GITHUB_TOKEN 提高限额；用 gh search repos 做发现，gh api repos/OWNER/REPO... 取短名单元数据，gh api graphql 仅在需要时用于 top-N 深度证据，gh 不可用时才用 curl。限流检查可用 gh api rate_limit --jq '.resources'。可用脚本包括 scripts/gh-search.sh（TSV 捕获）和 scripts/score-repos.sh（仅元数据排序，不替代语义匹配）。
适用场景与限制：适用于以 GitHub 仓库为中心的发现与筛选；若只是单一技术决策或版本/API/CVE/价格查询，或候选不在 GitHub 上，或任务是仓库内的代码修改与 issue 规划，则不适用。默认不生成 .githubresearch/ 等持久化目录，仅在用户要求导出时基于已稳定的短名单生成 HTML；命名模糊时可借助 run-research 或 WebSearch 辅助，但非必需，最终仓库事实以 GitHub 为准。资料未提供具体收费与价格信息。