spectra-ask

Solid

Query openspec/documents and answer questions

AI & Automation 29 stars 8 forks Updated today MIT

Install

View on GitHub

Quality Score: 87/100

Stars 20%
49
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

You are a project knowledge base assistant. Your answers MUST be grounded in documents under `openspec/` — never answer from general knowledge or training data. If the documents don't contain the answer, say so. **Input**: The text after `/spectra-ask` is the question. Examples: - `/spectra-ask activity-bar 的 badge 怎麼運作的?` - `/spectra-ask which specs are related to keyboard navigation?` - `/spectra-ask restore-tab-badge-count 這個 change 的設計是什麼?` - `/spectra-ask 你好` - `/spectra-ask` (no question — infer from conversation context) **Steps** 1. **Parse the query** - If a question is provided, use it - If no question, infer a relevant query from the current conversation context 2. **Decide whether to search** Always search unless the query is one of these exact cases: - Pure greetings: "你好", "hi", "hello" - Meta questions about the tool itself: "這是什麼工具", "spectra 是什麼" For everything else — including people, concepts, features, terms — **search first, answer later**. ```bash spectra search "<query>" --limit 10 --json ``` The search uses embedding-based vector search that handles cross-language queries natively (Chinese, English, Japanese). No need to translate or expand keywords — just use the natural language question directly. **Check the JSON output for an `error` field.** If present, respond with the appropriate message and STOP — do NOT fall back to grep, file search, or any other method: - `"error": "vector_not_compiled"` → "此平台的 ...

Details

Author
PsychQuant
Repository
PsychQuant/che-ical-mcp
Created
4 months ago
Last Updated
today
Language
Swift
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

spectra-discuss

Have a focused discussion about a topic and reach a conclusion

29 Updated today
PsychQuant
AI & Automation Solid

spectra-apply

Implement or resume tasks from a Spectra change

29 Updated today
PsychQuant
AI & Automation Listed

ask

Use when the user wants to ask a question and get an LLM-synthesized answer grounded in indexed documents, do RAG over previously crawled or embedded content, get cited answers from the knowledge base, or find information that was previously indexed. Triggers on "ask axon", "what does the documentation say about", "according to what I've indexed", "RAG query", "use axon to answer", or any question where the user wants grounded answers from indexed content rather than hallucination.

2 Updated today
jmagar
AI & Automation Listed

search

General vault retrieval — answers both "what" and "why" questions across MEMORY.md, memory/, session logs, project trackers, and vault notes. Uses qmd (lex+vec+hyde) with grep fallback.

10 Updated today
onebrain-ai
AI & Automation Listed

query

Use when the user wants to do a semantic vector search over indexed content, find relevant chunks matching a query, search the Qdrant knowledge base, or get raw search results without LLM synthesis. Triggers on "search axon", "query the knowledge base", "find chunks about", "vector search for", "semantic search", "what's indexed about", "find relevant passages". Different from `ask` (which synthesizes an answer) — query returns raw matching chunks with scores.

2 Updated today
jmagar