spectra-ask

Query openspec/documents with vector search to answer from current specs.

Updated Nov 24, 2024
One-click install
npx skills add https://github.com/dogwantfly/Nuxt3-training --skill spectra-ask-dogwantfly
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spectra-ask
Source: https://github.com/dogwantfly/Nuxt3-training/tree/main/.claude/skills/spectra-ask
Command: npx skills add https://github.com/dogwantfly/Nuxt3-training --skill spectra-ask-dogwantfly

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Answers must be grounded in documents under openspec/ and never rely on general knowledge or training data; if the documents don't contain the answer, the assistant should say so.

Core Features & Use Cases

  • Grounded Q&A: answers derived exclusively from openspec/documents.
  • Vector-search guided retrieval: uses embedding-based search to locate the most relevant specs and proposals, prioritizing current specs over archives for accuracy.
  • Historical context: archive documents provide context about how ideas evolved, used only when needed.
  • Use Case: ask about a spec requirement and get a precise, document-backed answer.

Quick Start

Ask a question after /spectra-ask and get a grounded answer sourced exclusively from openspec documents.

Frequently Asked Questions about spectra-ask

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I ground Q&A responses in openspec documents?

Ground Q&A responses by querying openspec documents with vector search to locate authoritative specs and proposals. The assistant answers strictly from document content, ensuring responses are derived exclusively from the knowledge base rather than general knowledge.

What happens when documentation doesn't contain the answer I need?

When documentation doesn't contain the answer, the grounding mechanism responds that the content is not present rather than speculating. This ensures answers never rely on training data or general knowledge outside the openspec knowledge base.

Can I retrieve historical context from archived spec proposals?

Archived spec proposals provide historical context about how ideas evolved. Vector search prioritizes current specs over archives for accuracy, using archive documents only when historical context about the spec is needed.

How does vector search locate relevant specs and proposals?

Vector search uses embedding-based retrieval to locate the most relevant main spec and related proposals within openspec documents. It prioritizes current specs over archives to ensure accurate, document-backed answers.

Does spectra-ask work without external dependencies?

Spectra-ask operates without external dependencies, querying the openspec knowledge base directly. It uses vector search to identify relevant specs and proposals, producing grounded answers exclusively from document content.

Why do my spec Q&A answers include inaccurate general knowledge?

Spec Q&A answers include inaccurate general knowledge when they are not grounded in openspec documents. Using vector search to retrieve authoritative specs ensures answers are derived strictly from document content, preventing speculation.