用途：在排错、报告 bug 前查重、寻找变通方案、追踪功能请求或了解历史决策时，快速查询和搜索 GitHub 仓库的 issues。
主要能力：支持关键词全文搜索（匹配标题和正文）；可按状态（open/closed/all）、标签（多个标签为 AND）、指派人和作者过滤；可查看单个 issue 的正文与评论；支持紧凑、表格、详细三种输出格式。
使用方式：优先使用 GitHub CLI（gh）。示例：gh issue list --repo owner/repo --search "keyword" --state all；gh issue list --repo owner/repo --label "bug" --state open；gh issue view 11984 --repo owner/repo --comments；gh issue view 11984 --repo owner/repo --json title,body,comments。可选安装 gh（https://cli.github.com/），私有仓库需运行 gh auth login。gh 不可用时回退到网页方式，例如 WebSearch 搜索 site:github.com/owner/repo/issues keyword，或直接访问 https://github.com/owner/repo/issues?q=keyword。
适用场景：根据错误信息排查已知问题；报告 bug 前搜索重复 issue；从已关闭 issue 的讨论中寻找变通方案；搜索功能请求及其状态；回顾解释过往决策的已关闭 issue。
限制：gh CLI 为推荐而非必需，未安装时可用网页回退，但公开仓库无需认证即可用网页方式；未认证请求的 API 速率限制较低，认证后更高（每小时 5000 次对 60 次），遇到速率限制需等待约 60 秒重试；搜索无结果时建议扩大关键词、移除过滤条件或改用 --state all。安装命令：macOS 可用 brew install gh，Windows 可用 winget install --id GitHub.cli。