Menu
查询 ewankb 知识库。默认图谱查询，也可指定 kb 或 deep 双路对比模式。查询结果自动穿透到源代码层，验证规格与实现的一致性。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
跨系统知识库查询枢纽。强制指定知识库名称查询，支持列出已有知识库。用法：/ewankb-hub list 列出知识库，/ewankb-hub <库名> [graph|kb|deep] <问题> 查询。
从 Java 后端代码 + Confluence 文档构建结构化业务知识库。
Commit and version knowledge base layers (source, knowledgeBase, graph) to git.
| name | ewankb-query |
| description | 查询 ewankb 知识库。默认图谱查询，也可指定 kb 或 deep 双路对比模式。查询结果自动穿透到源代码层，验证规格与实现的一致性。 |
| trigger | /ewankb-query |
/ewankb-query <问题> # 图谱查询（默认）
/ewankb-query graph <问题> # 图谱查询
/ewankb-query kb <问题> # 文档检索
/ewankb-query deep <问题> # 双路对比查询
ewankb preflight --query --dir .
解析 JSON：kb_dir 是知识库路径。
preflight 失败处理（仅关注查询相关 blocker）：
--query 模式时，no_llm_config 和 no_api_key 不会出现在 blockers 中（查询不需要 LLM）no_project_config → 不要立即停止，先检查全局知识库：
PYTHONIOENCODING=utf-8 python ~/.claude/skills/ewankb-hub/scan.py --json
当前目录下没有项目级知识库，但检测到以下全局知识库：
| 库名 | 名称 | 概述 |
|------|------|------|
| ... | ... | ... |
请使用 /ewankb-hub <库名> <问题> 查询全局知识库。
/ewankb init 初始化知识库，停止no_source / no_domains / no_knowledgeBase / no_graph → 知识库不完整，提示用户运行 /ewankb --build-graph，停止graph.exists: false 且需要 graph 查询 → 提示先运行 /ewankb --build-graph，停止自动拉取（消费者无需手动 pull）：
kb_dir 是 git 仓库，检查是否有 remote 配置：
cd "{kb_dir}"
git remote -v
git pull --rebase origin main 2>&1 || true
kb_dir 不存在但用户提供了 git 仓库地址，自动 clone：
git clone <仓库地址> "{kb_dir}"
如果 graph.exists: false 且需要 graph 查询，提示先运行 /ewankb --build-graph。
根据用户输入确定模式：
/ewankb-query <问题>（无子命令）→ 图谱模式（步骤 3A）/ewankb-query graph <问题> → 图谱模式（步骤 3A）/ewankb-query kb <问题> → kb 模式（步骤 3B）/ewankb-query deep <问题> → 双路对比模式（步骤 3C）ewankb query "用户问题" --json --dir "{kb_dir}"
如果 ewankb 命令不可用，请先运行 pip install ewankb。
解析 JSON 结果并解读：
matched_start_nodes 为空： → 告知用户图中未找到匹配节点，建议：
/ewankb-query kb "同一问题" 切换到文档检索matched_start_nodes 非空： → 基于 nodes 和 edges 用自然语言合成回答：
示例解读：
根据图谱分析：
- 找到 2 个与"预付款"相关的节点
- 预付款执行付款 → calls → 付款计划
来源：domains/收付款管理/README.md
这表明预付款流程和付款计划存在调用关系。但图中没有包含具体的额度计算逻辑，
可能需要查看 `/ewankb-query kb` 文档检索来获取更详细的计算规则。
回答末尾附建议："想看原文？试 /ewankb-query kb \"同一问题\""
ewankb query-kb "用户问题" --dir "{kb_dir}"
如果高分文档内容被截断，用 Read 工具读取完整内容后再回答。
关联代码为空时的处理： 如果高分文档的"关联代码"章节为空（如"（未找到直接对应的代码文件）"），不要把问题留给用户，而是自动触发代码穿透（步骤 3D）来查找对应的源代码文件。
回答末尾附建议："想看关联？试 /ewankb-query graph \"同一问题\"；想看代码实现？结果中已包含代码穿透"
用 Agent 工具并行启动两个 subagent（同一条消息）：
Subagent A（graph）：
执行
ewankb query "{问题}" --dir "{kb_dir}"，分析结果（涉及哪些节点、边、域）。从结果中提取技术术语（字段名、类名、API路径等），用于代码穿透。
Subagent B（kb）：
执行
ewankb query-kb "{问题}" --dir "{kb_dir}"，对高分文档用 Read 工具读取完整内容，分析结果。从文档内容中提取技术术语（字段名、类名、API路径、表名等），用于代码穿透。如果文档的"关联代码"为空，标记需要代码穿透。
对比 + 歧义处理：
代码穿透：Subagent A/B 完成后，汇总两路提取的技术术语，执行代码穿透（步骤 3D），重点比对规格描述 vs 实际实现的差异。
最终回答格式：
## 回答
[综合回答]
## 信息来源
- 图谱：[关键发现]
- 文档：[关键发现]
- 代码：[关键发现]（如有代码穿透结果）
## 代码验证（如有差异）
- [规格 vs 实现] {差异描述}
- 证据：{源文件路径}:{行号}
## 差异说明（如有）
无论哪种查询模式，在获得知识库/图谱结果后，执行代码穿透来验证规格与实现的一致性。
执行前提：
{kb_dir}/source/repos/ 目录存在且非空 → 执行代码穿透{kb_dir}/source/repos/ 目录不存在或为空 → 跳过，在回答中注明"无法执行代码穿透（源代码目录不可用）"步骤 1：提取技术术语
从知识库/图谱查询结果中提取可用于搜索源代码的技术关键词：
| 来源类型 | 可提取的术语 | 示例 |
|---|---|---|
| 接口文档 | API路径、请求参数名、响应字段名 | /contract/info/page, contractCode, createUserName |
| 需求文档 | 表名、字段代码、业务实体编码 | contract_archive_info, contract_code |
| 图谱节点 | source_file 中的路径片段、类名 | ContractInfoRest |
| 文档正文 | 任何明确提及的技术标识 | config.js, advanceUser |
同时从中文术语推断可能的技术命名：
contractManage、ContractInfo）searchContract、contractPage）步骤 2：搜索源代码
用提取的技术术语在 {kb_dir}/source/repos/ 中搜索：
*{module}*/config.*、*{module}*/Index.vue、*{module}*Api.**{Module}*Controller*、*{Module}*Service*、*{Module}*Rest*步骤 3：补充回答
将源代码搜索结果作为补充信息纳入回答：
步骤 4：代码穿透结果的呈现
在回答中新增可选章节：
## 代码验证
- [规格 vs 实现] {差异描述}（如有差异）
证据：{源文件路径}:{行号}
- [关联代码补充] {知识库文档中缺失的代码关联}（如关联代码为空）
来源：{源文件路径}:{行号}
严格模式约束：用户选择了哪种查询模式，就只用该模式的结果回答。禁止因为认为结果不理想而自动切换或追加其他模式的查询。如果某种模式返回结果较少或为空，如实告知用户结果有限，并建议用户自行尝试其他模式，而不是替用户切换。
代码穿透是所有模式的标配：代码穿透不是一种独立查询模式，而是每种模式回答后的验证步骤。即使严格模式约束下，代码穿透仍然执行，因为它不切换查询模式，而是在已有结果上做验证。