Agent Skills › YARlabs/hyperspace-db › hyperspacedb-query-planner

hyperspacedb-query-planner

GitHub

用于优化企业RAG工作流,通过查询规划器解析意图、拆分复合问题及澄清歧义,并利用Tribunal机制数学验证LLM生成内容,防止幻觉。

integrations/hyperspacedb-skills/skills/hyperspacedb-query-planner/SKILL.md YARlabs/hyperspace-db

触发场景

query planner intent clarity split questions clarify intent verify generation anti-hallucination tribunal verification trust score

安装

npx skills add YARlabs/hyperspace-db --skill hyperspacedb-query-planner -g -y
更多选项

非标准路径

npx skills add https://github.com/YARlabs/hyperspace-db/tree/main/integrations/hyperspacedb-skills/skills/hyperspacedb-query-planner -g -y

不安装直接使用

npx skills use YARlabs/hyperspace-db@hyperspacedb-query-planner

指定 Agent (Claude Code)

npx skills add YARlabs/hyperspace-db --skill hyperspacedb-query-planner -a claude-code -g -y

安装 repo 全部 skill

npx skills add YARlabs/hyperspace-db --all -g -y

预览 repo 内 skill

npx skills add YARlabs/hyperspace-db --list

SKILL.md

Frontmatter
{
    "name": "hyperspacedb-query-planner",
    "description": "Query planning, intent disambiguation, and geometric anti-hallucination verification for HyperspaceDB. Use this skill whenever an agent needs to: pre-evaluate a raw user query, split multi-part questions into parallel vector searches, ask clarifying questions for ambiguous intents, or mathematically verify an LLM draft against source context chunks (Tribunal Verification). Trigger on: \"query planner\", \"intent clarity\", \"split questions\", \"clarify intent\", \"verify generation\", \"anti-hallucination\", \"tribunal verification\", \"trust score\"."
}

HyperspaceDB Query Planner & Tribunal Verification

In enterprise RAG and autonomous agent workflows, naive vector searches on raw user queries lead to poor recall, missed sub-questions, and ungrounded hallucinations.

HyperspaceDB solves this with a two-phase architecture:

  1. Pre-Retrieval Intent Planning: hyperspace_query_planner evaluates clarity and splits compound questions into parallel queries before hitting the index.
  2. Post-Generation Tribunal Verification: verify_generation mathematically verifies if the LLM's draft breaks the topological or geometric boundaries of the source context chunks.

1. Pre-Retrieval: Query Planner & Intent Disambiguator

Before querying HyperspaceDB, run the query planner to evaluate clarity and split compound questions.

TypeScript / Node.js

import { evaluateQueryLocally, clarifyAndSplitIntent } from 'hyperspace-memory-ts';

const plan = evaluateQueryLocally({
  raw_user_query: "Compare HIPAA vs GDPR retention limits and how do we encrypt records?",
  collections: ["compliance_policies", "security_docs"],
  max_sub_queries: 5
});

if (plan.status === "clarification_needed") {
  // Agent prompts the user with multiple-choice clarification
  console.log("Ask user:", plan.clarification?.question);
  console.log("Options:", plan.clarification?.options);
} else {
  // Execute parallel searches
  console.log("Parallel sub-queries:", plan.search_queries);
  // [
  //   "Compare HIPAA vs GDPR retention limits",
  //   "how do we encrypt records"
  // ]
}

Python

from hyperspace_memory import evaluate_query_locally, clarify_and_split_intent

plan = evaluate_query_locally(
    raw_user_query="How is performance?", # Vague pronoun
    collections=["system_benchmarks"]
)

if plan["status"] == "clarification_needed":
    print("Ask user:", plan["clarification"]["question"])
    print("Options:", plan["clarification"]["options"])

MCP Tool Usage (mcp-hyperspacedb & mcp-hyperspace-memory)

Both MCP servers expose hyperspace_query_planner:

{
  "name": "hyperspace_query_planner",
  "arguments": {
    "raw_user_query": "What are our travel budget limits and what is the reimbursement process?",
    "collections": ["hr_policies", "finance_docs"]
  }
}

2. Post-Generation: Tribunal Hallucination Verification

Once the LLM drafts an answer using retrieved context chunk IDs, mathematically verify that the answer respects the topological boundaries of the context chunks.

Geometric calculations are treated as an opaque server-side operation.

Python SDK

from hyperspace import HyperspaceClient

client = HyperspaceClient("localhost:50051", api_key="sk_...")

result = client.verify_generation(
    llm_answer="The company reimburses up to $75/day for meals without receipts.",
    context_ids=["doc_hr_meals_12", "doc_finance_rules_04"],
    collection="hr_policies"
)

print(f"Trust Score: {result.trust_score:.2f}")
print(f"Is Hallucination: {result.is_hallucination}")
print(f"Details: {result.details}")

if result.is_hallucination:
    # Reject or trigger regenerative critique
    raise ValueError(f"Generation broke geometric context boundaries: {result.details}")

TypeScript SDK

import { HyperspaceClient } from 'hyperspace-sdk-ts';

const client = new HyperspaceClient('localhost:50051', 'sk_...');

const verification = await client.verifyGeneration(
  draftAnswer,
  ['context_chunk_1', 'context_chunk_2'],
  'policies_collection'
);

if (verification.is_hallucination) {
  console.warn(`Untrusted generation (${verification.trust_score}): ${verification.details}`);
} else {
  console.log(`Verified valid response (Trust: ${verification.trust_score})`);
}

Rust SDK

use hyperspace_sdk::Client;

let mut client = Client::connect("http://localhost:50051".to_string(), Some("sk_...".to_string()), None).await?;

let res = client.verify_generation(
    &draft_answer,
    &["chunk_1".to_string(), "chunk_2".to_string()],
    "hr_policies",
).await?;

assert!(!res.is_hallucination);
println!("Trust Score: {}", res.trust_score);

版本历史

  • b520a65 当前 2026-10-19 11:05

同 Skill 集合

integrations/hyperspacedb-skills/skills/hyperspacedb-cognitive/SKILL.md
integrations/hyperspacedb-skills/skills/hyperspacedb-core/SKILL.md
integrations/hyperspacedb-skills/skills/hyperspacedb-depin/SKILL.md
integrations/hyperspacedb-skills/skills/hyperspacedb-graph/SKILL.md
integrations/hyperspacedb-skills/skills/hyperspacedb-mcp/SKILL.md

元信息

文件数
0
版本
b520a65
Hash
ac790c3c
收录时间
2026-10-19 11:05

首页 - Wiki
Copyright © 2011-2026 iteam. Current version is 2.156.0. UTC+08:00, 2026-11-19 00:39
浙ICP备14020137号-1