技能介绍

它解决什么问题

relay-knowledge 把代码仓库检索从“先 rg 再猜”改成可诊断、可重试的图查询。面对大型仓库，冷启动索引可能在前台超时后仍在后台推进；普通命令行容易把这种情况当成一次性失败。这个技能要求用 repo index、repo status --format json、repo index-worker --task-id ... 显式观察任务状态，再决定是否重试，而不是无限等待或盲目重跑。

技能如何工作

二进制选择：优先使用包内匹配的 linux-x86_64 或 windows-x86_64 资产；仅在其缺失、不可执行、version --format json 失败、架构不匹配，或 Linux 主机不满足 glibc 基线时，回退到已发布安装路径。
索引诊断：将冷索引视为状态流，检查 active_task、checkpoint 计数器、freshness 和 lease_expires_at_ms；在没有托管服务消费队列时，执行有界的单轮 repo index-worker 尝试。
图查询：符号、定义、引用、callers、callees、导入和 SBOM 使用 repo query --kind；仓库级依赖、SDK、文件、主题、关系、构建、IaC、设计使用 repo software --kind。
特性开关：配置门、环境变量门、灰度开关使用 repo feature-flags，不把它当成普通 query kind。

适用边界

该技能面向已发布的 CLI 安装和仓库/知识图查询，不用于 MCP 配置，也不应用 source-checkout 构建产物代替安装路径。文本检索只是 CLI 不可用、目标范围无法索引，或用户明确需要正则匹配时的兜底。

截图预览

使用场景

排查某函数被谁调用、调用哪些下游时，用 `repo query --kind callers/callees` 逐步展开一跳调用边。
需要确认模块依赖、构建目标和 IaC 资源关系时，用 `repo software --kind relationships/all` 做仓库级切片。
梳理配置门、环境变量门和灰度开关对应的受保护代码时，用 `repo feature-flags` 读取已索引事实。
大型仓库冷索引超时或后台任务卡住时，用 `repo status --format json` 和 `repo index-worker` 检查租约与 checkpoint。