用途：从 GitHub 获取真实世界的代码示例与实现模式，回答“别人如何实现 X”“某库的用法示例”“某框架的架构模式”等问题。
主要能力：脚本负责单次查询——用 gh CLI 令牌认证、调用 Octokit API 搜索并分页、按星标/新鲜度/代码结构排序、并行抓取前 10 个文件、提取导入与语法模式等事实数据，返回含代码、元数据和 GitHub URL 的 markdown。Claude 负责编排：生成 3-5 条针对性查询（考虑语言、文件扩展名、具体函数名与签名），顺序执行并按中间结果调整，聚合去重（按 repo+path），分析常见导入与架构风格，输出含权衡、建议和全部文件 GitHub URL 的总结，并保存到 docs/research/github/<时间戳>-<查询slug>.md。
使用方式：前置条件为 gh CLI 已安装并认证（gh auth login --web）、Node.js + pnpm；验证用 gh auth status。命令：cd plugins/knowledge-work/skills/gh-code-search；pnpm install（仅首次）；pnpm search "your query here"。
适用场景：查找 React hooks、Express 错误处理中间件、XState 状态机、GitHub Actions 配置等真实实现与最佳实践。
限制：GitHub API 认证后每小时 5000 次请求，多轮搜索消耗更多配额；每次调用仅取前 10 条结果；跳过大于 100KB 的文件；顺序执行较慢（每查询 10-30 秒，完整流程 30-150 秒）；只提供事实数据，结论由 Claude 解读；去重按精确路径匹配。错误处理包括认证失败提示重新登录、限流时优雅停止并返回部分结果、网络失败继续并标注失败查询。具体收费与价格暂未提供。