ealmeida
b3cb108ca7
- knowledge/SKILL.md v2.2.0: Família A passa a 4 fontes (Supabase, CC memory, Hub, Desk CRM) - hub-search/SKILL.md v1.1.0: RAG Trinity actualizada (2 layers) - research-pipeline/SKILL.md v1.1.0: Layer 3 LightRAG removida - deep-research/SKILL.md v1.1.0: Layer 3 passa a Web apenas Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
138 lines
3.5 KiB
Markdown
138 lines
3.5 KiB
Markdown
---
|
|
name: hub-search
|
|
description: >
|
|
Pesquisa no vault Hub Obsidian com relevance scoring e backlinks.
|
|
Layer 1 da arquitectura de pesquisa (CLI → NotebookLM).
|
|
Usar quando: (1) pesquisar conteúdo no Hub por termo ou conceito,
|
|
(2) encontrar notas relacionadas via backlinks, (3) localizar PROCs/QR/docs
|
|
antes de executar tarefas, (4) verificar se existe documentação antes de criar.
|
|
---
|
|
|
|
# /hub-search — Pesquisa no Hub (Layer 1 RAG)
|
|
|
|
Pesquisa rápida no vault Hub via Obsidian CLI. Requer Obsidian aberto.
|
|
Fallback automático para Grep se Obsidian não estiver a correr.
|
|
|
|
---
|
|
|
|
## Uso
|
|
|
|
```
|
|
/hub-search "termo"
|
|
/hub-search "LightRAG configuração" --backlinks
|
|
/hub-search "PROC-MCP" --files
|
|
```
|
|
|
|
---
|
|
|
|
## Workflow
|
|
|
|
### Passo 1 — Tentar via Obsidian CLI
|
|
|
|
```bash
|
|
# Pesquisa básica
|
|
obsidian search query="TERMO" format=json
|
|
|
|
# Com backlinks (recomendado para conceitos)
|
|
obsidian search query="TERMO" format=json
|
|
obsidian backlinks file="NOTA"
|
|
|
|
# Limitar resultados
|
|
obsidian search query="TERMO" limit=10 format=json
|
|
```
|
|
|
|
**Indicador de sucesso:** saída JSON com `results` array.
|
|
**Indicador de falha:** mensagem `unable to find Obsidian` → ir para fallback.
|
|
|
|
### Passo 2 — Fallback: Grep no Hub
|
|
|
|
Se CLI falhar (Obsidian fechado):
|
|
|
|
```
|
|
Grep "TERMO" /media/ealmeida/Dados/Hub/ --type md
|
|
```
|
|
|
|
Adicionar contexto ao utilizador: "Obsidian não está a correr — usando busca directa nos ficheiros."
|
|
|
|
### Passo 3 — Apresentar resultados
|
|
|
|
**Formato de output:**
|
|
|
|
```markdown
|
|
## Resultados: "[termo]"
|
|
|
|
**Fonte:** Obsidian CLI v1.12.7 | **Backlinks:** Sim/Não
|
|
|
|
### Encontrado em N notas
|
|
|
|
| Nota | Path | Relevância |
|
|
|------|------|-----------|
|
|
| [título] | `path/relativo.md` | Alta/Média/Baixa |
|
|
|
|
### Notas com backlinks para este termo
|
|
- `nota-a.md` → referencia `nota-b.md`
|
|
|
|
### Relacionados sugeridos
|
|
- [links relevantes encontrados nos resultados]
|
|
```
|
|
|
|
---
|
|
|
|
## Regras
|
|
|
|
1. **Sempre tentar CLI primeiro** — é mais preciso (scoring semântico)
|
|
2. **--include-backlinks por defeito** quando o termo é um conceito (não um comando)
|
|
3. **Fallback silencioso** — não perguntar, só mencionar que usou Grep
|
|
4. **Max 10 resultados** — se mais, mostrar top 10 por relevância
|
|
5. **Paths relativos** na apresentação (ex: `04-Stack/02.03-IA/` não path absoluto)
|
|
|
|
---
|
|
|
|
## Integração com outras skills
|
|
|
|
```
|
|
/hub-search "termo" → Layer 1: Obsidian CLI (este skill)
|
|
/knowledge "termo" → Layer 2: NotebookLM (65 notebooks)
|
|
```
|
|
|
|
**Quando escalar para Layer 2:**
|
|
- Resultado CLI score < 50% ou 0 resultados → sugerir `/knowledge`
|
|
- Conteúdo conceptual/externo → sugerir `/knowledge` directamente
|
|
|
|
---
|
|
|
|
## Referência CLI
|
|
|
|
```bash
|
|
# Sintaxe correcta: parâmetros com = (não flags com --)
|
|
obsidian search query="TERMO" format=json
|
|
obsidian search query="TERMO" limit=10 format=json
|
|
obsidian backlinks file="NOTA"
|
|
obsidian tags sort=count counts
|
|
obsidian tasks daily todo
|
|
obsidian version
|
|
obsidian help # lista todos os comandos disponíveis
|
|
```
|
|
|
|
**Nota:** A skill oficial kepano (`obsidian-cli`) tem referência completa de todos os comandos.
|
|
|
|
**Requer:** Obsidian aberto + CLI activado em Settings → General → Advanced
|
|
**Wrapper:** `~/.local/bin/obsidian` (define XDG_RUNTIME_DIR Flatpak)
|
|
**Docs:** `04-Stack/02.03-IA/Obsidian-CLI.md`
|
|
|
|
---
|
|
|
|
*Skill v1.0.0 | 06-04-2026 | Descomplicar®*
|
|
|
|
---
|
|
|
|
## Healing Log
|
|
|
|
Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.
|
|
|
|
```jsonl
|
|
{"date":"","issue":"","fix":"","source":"user|auto"}
|
|
```
|
|
|
|
*Adicionar nova linha após cada erro corrigido.*
|