前言¶
给 Agent 做代码问答或影响面分析时，常见做法是让模型直接 grep 或读仓库文件。目录一多，grep 只能拿到文本命中，拿不到”谁调用了谁”“这个符号被哪些模块引用”这类图关系，模型也容易在无关文件里迷路。relay-knowledge-cli 走的是另一条路：在本地提供一套 repo 命令，先给仓库建知识图谱索引，之后按 kind 查询符号、定义、引用、调用关系、导入依赖、软件依赖和 SBOM，把结果交给 Agent 使用。
这是什么¶
relay-knowledge-cli 是一个面向 Agent 的本地 CLI 知识后端，用来为仓库提供知识图谱与 GraphRAG 能力。它由 SkillHub 上的社区发布者 user_15292d5a 维护，坐标为 @user_15292d5a/yjkj-relay-knowledge-cli，当前版本 1.0.0，分类 dev-programming，来源 community。
解决的问题是：Agent 在理解一个代码库时，缺乏结构化的符号级和依赖级信息。该 Skill 把这类信息组织成可查询的图谱接口，而不是让 Agent 逐文件翻读。
核心功能¶
下面按 Skill 简介列出已核实的能力。
仓库查询。通过 repo query 命令按 –kind 指定查询类型，支持 hybrid、symbol、definition、references、callers、callees、imports、sbom 等。对应的使用场景包括用户代码查询类型、图关系、调用关系、导入依赖、definitions、references、usage 和 impact。
软件信息查询。通过 repo software 命令按 –kind 指定 dependencies、sdks、files、topics、relationships、build、iac、design、all 等类别，用于获取软件依赖、SDK/API、代码地图等信息。
特性开关与配置门控。支持 feature flags 与 config gates 的查询，用于判断某个开关或配置在仓库中的影响范围。
索引与诊断。提供 indexing、impact、setup、install/upgrade diagnostics 等命令，覆盖索引任务状态、影响分析和安装升级诊断。
安装与启用¶
Skill 页面未提供可直接核实的安装命令，这里不猜测。可确认的信息如下：
- 坐标：@user_15292d5a/yjkj-relay-knowledge-cli
- 版本：1.0.0
- 来源：community
- 标签：requires_api_key=false，即不需要 API Key
- 官方页面：https://api.skillhub.cn/user_15292d5a/yjkj-relay-knowledge-cli
启用方式按 SkillHub 上该 Skill 的页面指引操作。它基于通用 SKILL.md 格式，可用于支持该格式的 Agent 环境。Cursor、Codex CLI、Claude Code 三者是否有分别的配置差异，资料中没有说明，这里不写。
典型用法¶
以下命令形式取自 Skill 简介，具体参数和输出格式以本机 CLI 帮助为准。
查询某个符号的定义与引用：
repo query --kind definition <symbol>
repo query --kind references <symbol>
查询调用关系与导入依赖：
repo query --kind callers <symbol>
repo query --kind callees <symbol>
repo query --kind imports <symbol>
查询软件依赖与 SDK：
repo software --kind dependencies
repo software --kind sdks
查看仓库索引状态：
repo status <alias>
大仓库冷启动索引¶
这是该 Skill 明确给出注意事项的场景。对大型冷仓库做索引时，CLI 超时不代表任务失败，不要据此判断索引没有启动。正确的处理顺序是：
1、repo index 命令返回任务 ID 时，先记录下来。
2、如果没拿到 ID，用 repo status
3、让服务自行消化仍在执行的任务，不要重复提交。
4、对仍处于 queued 或 retrying 的任务，可以有限度地执行 repo index-worker 尝试推进。
判断索引是否生效时，依据 repo update 或 index refresh 的返回结果，以及状态诊断命令的输出，而不是自己假设任务 ID 存在。
适用场景与注意¶
适合需要符号级或依赖级代码理解的 Agent 场景：调用链分析、影响面评估、依赖梳理、SBOM 查询、配置开关影响分析。
查询策略上，Skill 建议优先使用图谱 CLI，而不是 grep、ripgrep、rg 或纯文本搜索。只有在图谱不可用、仓库无法索引、查询需求无法用图谱表达，或确实需要原生正则时，才退回文本搜索。
明确不适用的范围：MCP 配置与工具、ACP 适配器、协议层的 Agent 接入。这些不在该 Skill 的职责内。
结尾¶
relay-knowledge-cli 的价值在于把仓库知识图谱和 GraphRAG 封装成一套本地 repo 命令，让 Agent 拿到结构化的符号、调用和依赖关系，而不是在文件堆里做文本匹配。它不解决 Agent 的接入协议问题，只解决”代码库知识从哪来、怎么查”这一层。
官方地址：https://api.skillhub.cn/user_15292d5a/yjkj-relay-knowledge-cli
