核心用法
overlap-check 是一个智能前置检查技能，在 AI Agent 尝试创建新 Issue、PR 或评论前自动触发。它通过调用 GitHub CLI (gh) 搜索目标仓库中可能重复的现有线程，帮助 Agent 判断是参与现有讨论还是创建新主题。
工作流程分为五步：首先识别目标仓库与主题关键词；然后并行执行 Issue 和 PR 搜索（去除停用词以提高匹配率）；接着评估搜索结果的相关性——查看标题、评论数、状态，并深入阅读高相关度线程；最后根据四种情境决策：完全重复则评论现有线程、已解决则引用链接、相关但不同则新建并引用、无匹配则正常创建。
显著优点
- 自动化拦截：在资源消耗前阻止重复劳动，减少社区噪音
- 低成本实现：仅需两次
gh search调用，不依赖复杂 NLP - 尊重用户主权：仅提供建议不强制阻断，用户坚持时可继续
- 上下文感知：能区分"完全重复""相关但不同""已解决"等 nuanced 场景
- 原生 GitHub 集成：直接利用 GitHub 搜索语法，无需额外 API 配置
潜在局限
- 关键词依赖：简单停用词过滤可能漏过语义相关但用词不同的线程
- 无向量语义匹配：无法处理同义词或概念相似性（如"clipboard paste" vs "paste from clipboard"）
- gh CLI 依赖：要求目标环境已安装并认证 GitHub CLI
- 公开仓库限制：私有仓库需额外权限配置
- 无自动决策：最终判断仍依赖 Agent/用户的阅读理解，可能产生误判
适合人群
- 高频与 GitHub 交互的 AI Agent 开发者
- 维护活跃开源项目的社区经理
- 需要批量处理 Issue/PR 的企业 DevOps 团队
- 追求低摩擦社区治理的技术写作者
常规风险
- 信息泄露：搜索关键词可能暴露敏感内容至 GitHub 搜索日志
- API 速率限制：高频调用可能触发 GitHub API 限流
- 误判风险：过度保守可能导致该创建的 Issue 被抑制，或该评论的线程被错过
- 权限不足：未认证的 gh CLI 调用会失败并暴露环境配置问题