O que Consulta da Base de Conhecimento CV faz?
<propósito> Recuperação rápida da base de conhecimento para responder perguntas sobre experiência, encontrar conquistas ou reunir dados para geração de conteúdo. </propósito>
<quando_ativar> Ative quando o usuário:
- Perguntar "O que eu fiz com [tecnologia/habilidade]?"
- Quiser encontrar conquistas para um tema específico
- Precisar de métricas para uma empresa/período específico
- Perguntar "Mostre minha experiência em [tipo]"
- Quiser entender relacionamentos entre experiências
Frases de gatilho: "encontrar", "buscar", "qual é minha experiência", "mostre", "liste conquistas" </quando_ativar>
Esquema da Base de Conhecimento
Entidades (content/knowledge/index.yaml)
entities:
companies:
- id: string # anchorage, microsoft, etc.
name: string
period: string
role: string
domain: string
themes:
- id: string # institutional-crypto, developer-experience
label: string
keywords: [string]
skills:
- id: string # ethereum, api-design
label: string
category: string
Relacionamentos
relationships:
- from: achievement:id
to: company:id | skill:id | theme:id
type: achieved_at | demonstrates | belongs_to | contains | generated_from
Realizações (content/knowledge/achievements/*.yaml)
id: string
headline: string
metric:
value: string
unit: string
context: string
situation: string
task: string
action: string
result: string
skills: [string]
themes: [string]
companies: [string]
years: [number]
good_for: [string]
Pesquisa Rápida (Script Determinístico)
Para pesquisas baseadas em palavras-chave, USE O SCRIPT PRIMEIRO — é mais rápido e consistente:
# Pesquisar por palavras-chave
npm run search:evidence -- --terms "crypto,staking,institutional"
# Com saída JSON para processamento
npm run search:evidence -- --terms "crypto,staking" --json
O script retorna:
- Realizações e histórias correspondentes ordenadas por relevância
- Pontuações de relevância (forte ≥70%, moderada 40-70%, fraca <40%)
- Termos, habilidades e temas correspondentes
- Trechos para revisão rápida
Use o script quando:
- Usuário perguntar sobre palavras-chave específicas
- Pesquisa rápida sem necessidade de análise profunda
- Precisa de pontuação de alinhamento para adequação a cargos
Use consulta manual quando:
- Necessário percorrer relacionamentos profundos
- Precisar da narrativa STAR completa (situação, tarefa, ação, resultado)
- Referência cruzada complexa entre entidades
Padrões de Consulta
Consulta por Tema
Usuário: "Qual é minha experiência em cripto institucional?"
Abordagem com script primeiro:
npm run search:evidence -- --terms "institutional,crypto,custody"
Para análise aprofundada:
- Encontrar tema
institutional-cryptono índice - Consultar relacionamentos onde
to: theme:institutional-crypto - Carregar realizações correspondentes
- Retornar resumo com métricas
Formato de Saída:
## Experiência em Cripto Institucional
### Realizações:
1. **ETH Staking Zero Slashing** (Anchorage, 2024-25)
- Zero eventos de slashing, clientes Galaxy + institucionais
- Habilidades: ethereum, staking, compliance
2. **Integrações de Protocolos L2** (Anchorage, 2024-25)
- 7+ protocolos entregues, 40% mais rápido nas integrações
- Habilidades: l2s, compliance
Consulta por Habilidade
Usuário: "Mostre meu trabalho com design de API"
Processo:
- Encontrar habilidade
api-designno índice - Consultar realizações onde
skillsincluiapi-design - Retornar com contexto e métricas
Consulta por Empresa
Usuário: "O que realizei na Microsoft?"
Processo:
- Encontrar empresa
microsoftno índice - Consultar realizações onde
companiesincluimicrosoft - Incluir período e contexto de função
Consulta por Palavra-chave
Usuário: "Encontre realizações relacionadas a crescimento de receita"
Abordagem com script primeiro:
npm run search:evidence -- --terms "revenue,growth,ARR"
Para pesquisa manual:
- Pesquisar palavras-chave do tema por "crescimento"
- Pesquisar títulos/resultados de realizações por "crescimento"
- Retornar classificado por relevância
Consulta para Adequação a Cargos
Usuário: "Quais realizações se encaixam em uma função de PM de Plataforma?"
Abordagem com script primeiro:
npm run search:evidence -- --terms "platform,infrastructure,api,scale"
Para análise mais aprofundada:
- Analisar palavras-chave da função: platform, infrastructure, scale
- Corresponder temas: infrastructure, developer-experience
- Corresponder arrays
good_fornas realizações - Retornar lista classificada com justificativa
Formatos de Resposta
Formato de Resumo (padrão)
Encontradas 3 realizações correspondentes a "[consulta]":
1. **[Título]** ([Empresa], [Ano])
Métrica: [valor] [unidade]
Temas: [tema1], [tema2]
2. ...
Formato de Detalhe (sob solicitação)
## [Título da Realização]
**Contexto**: [Empresa] | [Período] | [Função]
**Impacto**: [metric.value] [metric.unit]
### Situação
[texto da situação]
### Tarefa
[texto da tarefa]
### Ação
[texto da ação]
### Resultado
[texto do resultado]
**Melhor para**: [itens good_for]
Formato de Métricas (para comparações)
| Realização | Métrica | Valor | Empresa | Ano |
|------------|---------|-------|---------|------|
| [título] | [unidade] | [valor] | [empresa] | [ano] |
Consultas de Referência Cruzada
Encontrar Realizações Relacionadas
Usuário: "O que mais se relaciona com o trabalho de staking ETH?"
Processo:
- Carregar realização
eth-staking-zero-slashing - Encontrar temas compartilhados:
institutional-crypto,infrastructure - Encontrar habilidades compartilhadas:
ethereum,compliance - Consultar outras realizações com sobreposição
- Classificar por força do relacionamento
Encontrar Lacunas
Usuário: "Quais habilidades não têm realizações fortes?"
Processo:
- Listar todas as habilidades no índice
- Contar realizações por habilidade
- Sinalizar habilidades com <2 realizações
- Sugerir áreas para desenvolvimento de conteúdo
Atalhos de Consulta
| O Usuário Diz | Consulta |
|---|---|
| "meu trabalho com blockchain" | temas: [enterprise-blockchain, institutional-crypto] |
| "histórias de crescimento" | temas: [revenue-growth] |
| "ferramentas para desenvolvedores" | temas: [developer-experience] |
| "trabalho recente" | anos: [2024, 2025] |
| "dias na Microsoft" | empresas: [microsoft] |
| "experiência em startup" | empresas: [ankr, forte, dapper] |
<locais_de_arquivos>
Locais de Arquivos
| Destino da Consulta | Caminho do Arquivo |
|---|---|
| Definições de entidades | content/knowledge/index.yaml |
| Realizações | content/knowledge/achievements/*.yaml |
| Histórias | content/knowledge/stories/*.yaml |
| Métricas | content/knowledge/metrics/*.yaml |
| </locais_de_arquivos> |
<composições_de_habilidades>
Funciona Bem Com
- generate-variant — Consultar evidências antes de gerar variantes
- cv-content-generator — Encontrar realizações para estudos de caso
- generate-story-bank — Pesquisar histórias por categoria </composições_de_habilidades>