knowledge-retrieval-agent

knowledge-retrieval-agent is an agent for Claude Code from ZTE-AICloud/Co-OmniSpec. It costs 98 tokens per session (641 once invoked), scanned A, original, MIT.

A read-only search agent for a project's private knowledge base, meaning internal documents and records. It returns structured findings with file locations or record identifiers as sources.

In plain words
What is it for?
Use it to search requirements or change descriptions, identify related documents and graph relationships, and return relevance judgments with source references.
Why use it?
It helps developers find relevant project decisions and examples without bringing the entire knowledge base into the main working context. It also reports clearly when nothing matches.

Agent for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the omni-dsdd plugin — 40 skills, 16 agents, 1 hook shipped together

Good fit Use it to search requirements or change descriptions, identify related documents and graph relationships, and return relevance judgments with source references.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/zte-aicloud/co-omnispec/knowledge-retrieval-agent
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/ZTE-AICloud/Co-OmniSpec

Made for: Claude Code.

Or install omni-dsdd, the plugin that ships this one along with the rest of its 40 skills, 16 agents, 1 hook.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for knowledge-retrieval-agent

README.md
[![agentmods](https://agentmods.dev/badge/agents/zte-aicloud/co-omnispec/knowledge-retrieval-agent.svg)](https://agentmods.dev/agents/zte-aicloud/co-omnispec/knowledge-retrieval-agent)
Your own site
<a href="https://agentmods.dev/agents/zte-aicloud/co-omnispec/knowledge-retrieval-agent"><img src="https://agentmods.dev/badge/agents/zte-aicloud/co-omnispec/knowledge-retrieval-agent.svg" alt="Measured on agentmods" height="20"></a>
Per session 98 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 641 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00098 $0.00641
Opus 5 $0.00049 $0.00320
Sonnet 5 $0.00020 $0.00128
Haiku 4.5 $0.00010 $0.00064

Measured 8d ago against content hash 832a806e4177, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

knowledge-retrieval-agent scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

omni-dsdd/agents/knowledge-retrieval-agent.md · 35 lines

What it actually says

唯一职责:执行知识检索并返回带来源的结构化结果

你被派发来做一件事——在项目执行目录下完成一次知识检索,然后只返回检索结论。 你的上下文从空白开始,没有父对话历史,本 prompt 里给你的信息就是全部输入。

输入(由父 agent 调用方 在 prompt 中提供)

  • 检索意图文本(必填):功能/需求或变更描述原文
  • 已提取要素(若父 agent 调用方已提取,直接给,不要重新提取): 功能目标 / 用户类型 / 关键概念 / 关键词列表

执行

  1. 加载 knowledge-retrieval skill,按其工作流执行:
    • 阶段 0 config-info 探测 mode 与产物状态;
    • 按 mode(enhance/baseline,默认为baseline)走渐进检索(vector-search + 使用 graphify CLI 执行graphify query/path/explain);
  2. 产物缺失(vector/graph 未构建)时,不自动代跑 build,在返回里如实标注。

返回(只返回以下内容,保证父 agent 调用方可直接引用来源)

  • 命中文档/实例列表:每条给出 source_file + location(baseline) 或实例 id/type/name(enhance),以及命中片段摘要。
  • 图谱关联(若走了图谱):节点 label / source_file / 关系边。
  • 关联度判断:每条相关性高/中/低,便于父 agent 打分筛选。
  • 零结果:未命中时明确输出「未找到相关文档」,不臆造。

禁止

  • 检索基本只读;图查询会写检索路径记录缓存(graphify save-result/reflect)以增强后续检索, 除此之外不写任何产物。(原"不要写任何文件"改为此条。)
  • 不要返回 knowledge-retrieval / graphify 的内部工作流日志、中间推理。
  • 不要臆造来源;所有条目必须带真实 source_file/location 或实例 ID。
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 35 lines · 98 tokens per session scan A 832a806e4177

Subscribe to this mod's changes

knowledge-retrieval-agent is an agent published in the GitHub repository ZTE-AICloud/Co-OmniSpec (54 stars, last pushed 1mo ago), licensed MIT. It adds 98 tokens to every session and 641 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other agents, from other repositories

wiki-qa-probe

A single retrieval probe — explores ONE facet of a question deep through the knowledge graph, embeddings, and source files, and returns grounded findings with exact citations for the hypervisor to fuse.

bearlike/Assistant · 43 tokens

qdrant-expert

Configure and operate the vector store in production. TRIGGER WHEN: creating Qdrant collections, tuning HNSW, quantization, dense plus sparse hybrid search, payload indexing, multi-tenancy, or Qdrant performance troubleshooting. DO NOT TRIGGER WHEN: end-to-end RAG design, or another vector database such as Pinecone…

acaprino/daodan · 91 tokens

FAI LangChain Expert

LangChain framework specialist — LCEL expression language, chains, agents with tool use, retrievers, memory, callbacks, LangSmith tracing, and production RAG pipeline patterns.

frootai/frootai · 41 tokens

rag-evaluator

Run retrieval regression gates (hitgate) against the current repo state. Compares Hit@5, MRR, and per-intent metrics to detect whether a change helped, regressed, or held steady. Use for shipping retrieval code changes, validating retuning before merge, or measuring refactor impact on search quality.

LucasSantana-Dev/sharekit · 68 tokens

ai-platform-architect

Use this agent when working on AI/ML agent platform architecture, designing agent systems, implementing multi-agent orchestration, building RAG pipelines, optimizing LLM inference, designing memory systems, implementing streaming protocols, or making any architectural decisions related to . This includes agent…

asiflow/claude-nexus-hyper-agent-team · 778 tokens

llm-integrator

LLM integration specialist in RAG, embeddings, prompt engineering. Use PROACTIVELY for LLM features.

dotclaude/marketplace · 28 tokens