用途：面向具体工程问题，用 GitHub 作为证据与实现来源。适用于运行时、构建、测试、部署、打包、SDK、API、依赖、框架或集成错误；功能实现被边界情况、用法模式或 API 行为不明阻塞；本地问题疑似已被维护者或其他用户在 issue、PR、示例、代码或发布说明中解决；用户询问开源项目能否解决同一问题；需要成熟实现示例降低不确定性；需要比较合适仓库并说明如何本地适配。不适用于微小改动、文案修改、代码库本身已给出答案的纯本地重构，或明确禁止联网/GitHub 检索的请求；未经用户明确授权不得查看私有仓库。
主要能力：先本地界定问题（目标、症状、错误签名、复现路径、版本、运行时、依赖、约束、已尝试修复）；选择证据模式（错误/回归先查 issue、PR、发布与代码；能力/工具需求先找仓库候选；功能实现两者并用）；构造精确检索（错误原文、包/API 名、版本号、框架+症状、配置键、堆栈片段、失败命令）；评估子代理是否必要；按问题契合度排序，Star 仅作成熟度参考；深读最强项目与证据，提取项目基础、可复用面、根因或实现模式、版本约束、风险、适配边界与验证步骤；以最小适配转化为本地工作。
使用方式：默认使用 GitHub CLI（gh），优先 gh search repos、gh search issues、gh search prs、gh search code、gh repo view、gh issue view、gh pr view、gh api，而非浏览器抓取或自定义脚本。示例：gh search repos "<query>" --archived=false --sort stars --order desc --limit 10 --json fullName,url,description,stargazersCount,forksCount,language,license,pushedAt,isArchived,openIssuesCount；gh search issues "<query>" --repo owner/repo --sort updated --order desc --limit 10 --json title,url,state,updatedAt,commentsCount,repository,body；gh search prs "<query>" --repo owner/repo --merged --sort updated --order desc --limit 10 --json title,url,state,updatedAt,commentsCount,repository,body；gh search code "<query>" --repo owner/repo --limit 10 --json path,url,repository,sha；gh repo view owner/repo --json nameWithOwner,url,description,stargazerCount,forkCount,licenseInfo,primaryLanguage,pushedAt,repositoryTopics,homepageUrl；gh api -X GET search/repositories -f q='<query> archived:false' -f sort=stars -f order=desc。仅在命令因 403、429、私有仓库授权错误或明确未认证消息失败时才运行 gh auth status。
适用场景：错误与回归排查、能力或工具选型（需先框定为具体能力/阻塞/工作流/集成需求）、功能实现受阻、需要比较仓库并本地适配、公开平台数据需求（先找可复用公开端点、开源爬虫、归档数据集与 API 字段证据，再用最小真实请求验证）。
限制与边界：证据弱时须明说，不得把弱匹配包装成确定推荐；不得只给链接、Star 或热度排名；不得写无链接证据的“常见 GitHub 模式”；外部示例不得凌驾本地约束；安全、认证、支付、基础设施或生产运维需与当前官方文档交叉核对；优先复用公开接口而非复制代码，复制需检查许可证并保留归属义务；避免大段逐字摘录；不得保存或传递 token、cookie、私有仓库内容、凭据、敏感日志与生产数据；无网络时须说明无法检索并标记为仅本地建议。输出应包含本地问题画像、检索路径、子代理轨迹（如使用）、项目候选、关键证据、推荐方案、被拒或高风险选项、验证标准与置信度标签。