financas-donna

by evandrotho

Install this Skill

curl -fsSL -o financas-donna.zip https://skill.seembox.com/api/v1/skills/financas-donna/download && unzip financas-donna.zip

Download financas-donna.zip

SKILL.md About

# Skill Finanças - Donna

Gerenciamento financeiro pessoal com registro por categorias, processamento de extratos/faturas e resumos mensais/anuais.

## Triggers (Ativação Automática)

Esta skill é ativada automaticamente quando o usuário usar palavras-chave relacionadas a finanças:

**Registro de gastos/receitas:**
- "gastei", "paguei", "comprei", "compre", "gasto", "pagamento"
- "recebi", "entrar", "receita", "renda"
- "aluguel", "luz", "água", "internet", "celular", "conta"

**Consultas de resumo:**
- "resumo", "resumir", "balanço", "saldo"
- "quanto gastei", "total", "acumulado"
- "de [mês]", "em [mês]", "[mês] 2026"

**Processamento de arquivos:**
- "fatura", "extrato", "cartão", "banco"

**Categorias financeiras:**
- "alimentação", "mercado", "restaurante", "comida"
- "transporte", "gasolina", "pedágio", "uber"
- "lazer", "cinema", "show", "festa"
- "saúde", "farmácia", "médico"
- "compras", "roupas", "presente"

## Descrição

Skill para gerenciar as finanças pessoais do Evandro, incluindo registro diário de gastos em linguagem natural, processamento de extratos bancários e faturas de cartão, e geração de resumos mensais e anuais.

## Como Funciona

**Importante:** Esta skill NÃO é um processo automático que roda em background. Ela é um **conjunto de instruções** que guia a agente (Donna) quando você faz perguntas ou comandos relacionados a finanças.

**Fluxo de execução:**
1. Você fala algo que ativa um trigger (ex: "gastei 50 no iFood")
2. A Donna detecta que é sobre finanças
3. A Donna carrega esta skill como guia
4. A Donna **segue as instruções**:
   - Lê os arquivos financeiros do workspace
   - Interpreta sua solicitação
   - Faz os cálculos ou registros conforme as regras
   - Atualiza os arquivos se necessário

**O que a skill NÃO faz automaticamente:**
- ❌ Não monitora arquivos por conta própria
- ❌ Não envia alertas sem ser perguntada
- ❌ Não processa faturas automaticamente

**O que a skill FAZ quando ativada:**
- ✅ Lê os arquivos financeiros quando você pede
- ✅ Registra gastos quando você informa
- ✅ Calcula resumos quando você consulta
- ✅ Processa extratos quando você envia

## Estrutura de Arquivos

```
workspace/financas/
├── 2026-MM.md          # Arquivo mensal (MM = 01, 02, ..., 12)
├── resumo-anual.md     # Consolidado anual
└── metas.md           # Metas financeiras
```

### Formato do Arquivo Mensal

```markdown
# Finanças - Mês 2026

## 📊 Resumo do Mês

| Categoria | Total |
|-----------|-------|
| Receitas | R$ 0,00 |
| Despesas Fixas | R$ 0,00 |
| Parcelamentos | R$ 0,00 |
| Gastos Variáveis | R$ 0,00 |
| **Total Despesas** | **R$ 0,00** |
| **Saldo** | **R$ 0,00** |

---

## 💰 Receitas

| Dia | Data | Descrição | Tipo | Valor | Status | Obs |
|-----|------|-----------|------|-------|--------|-----|

---

## 🏠 Despesas Fixas

| Dia | Vencimento | Descrição | Categoria | Valor | Status | Obs |
|-----|------------|-----------|-----------|-------|--------|-----|

---

## 📦 Parcelamentos

| Dia | Vencimento | Descrição | Parcela | Vl.Parcela | Vl.Total | Status | Obs |
|-----|------------|-----------|---------|------------|----------|--------|-----|

---

## 💸 Gastos Variáveis

| Dia | Data | Descrição | Categoria | Valor | Status | Obs |
|-----|------|-----------|-----------|-------|--------|-----|
```

## Categorias Válidas

### Despesas Fixas
- Moradia
- Energia
- Água
- Internet
- Celular
- Streaming
- Outras Fixas

### Gastos Variáveis
- Alimentação
- Transporte
- Lazer
- Saúde
- Educação
- Compras Pessoais
- Outros

### Receitas
- Salário / Renda Principal
- Rendas Extras

## Fluxo de Trabalho

### 1. Registro Diário (Linguagem Natural)

O usuário informa gastos em linguagem natural, por exemplo:
- "Gastei 350 no Shibata no cartão Santander"
- "Paguei o aluguel de 1500"
- "Recebi meu salário de 8000"
- "Comprei um fone de 300 em 3x no C6"
- "Almocei no Habib's por 45 reais"

**Processo:**
1. Interpretar a frase e classificar (tipo de transação, categoria, valor, data, forma de pagamento)
2. Mostrar resumo ao usuário para confirmação
3. Se aprovado, registrar no arquivo do mês atual
4. Atualizar o resumo do mês
5. Atualizar o resumo anual se necessário

**Regras de interpretação:**
- Se o usuário não informar o mês, usar o mês atual
- Se não informar o dia, usar o dia atual
- Categoria deve ser inferida do contexto (ex: "iFood" → Alimentação)
- Forma de pagamento deve ser explicitada (Santander, C6, PIX, Débito, etc.)

### 2. Processamento de Extratos/Faturas

Quando o usuário enviar extratos bancários ou faturas de cartão:

**Fatura de Cartão (PDF/CSV):**
- Contém APENAS compras no crédito (maquininha, link de pagamento, apps, online)
- NUNCA assumir que transações de fatura são PIX
- Transações com nomes de pessoas são cobranças via link/maquininha, NÃO PIX
- Descrição deve refletir o que aparece na fatura
- **IMPORTANTE:** Faturas de "março" podem conter transações de JAN e FEV (ciclo de cobrança)
- Registrar cada transação no mês REAL da compra, não no mês da fatura

**Extrato Bancário (PDF/CSV):**
- Contém PIX, transferências, débito automático, boletos
- Somente registrar PIX quando fornecido o EXTRATO BANCÁRIO
- Não misturar dados de fatura de cartão com dados de extrato bancário

**Processo:**
1. Ler/interpretar o arquivo
2. Crie uma tabela resumo com as transações
3. Verificar duplicatas com dados existentes (comparar valor + data + mês)
4. Mostrar resumo ao usuário para confirmação
5. Se aprovado, registrar nas seções adequadas
6. Atualizar resumos

### 3. Consultas

Só exibir resumos quando o usuário pedir:
- "Me mostra o resumo de abril"
- "Quanto gastei em alimentação esse mês?"
- "Qual o saldo atual?"

## Regras de Ouro

### Registro
- ✅ UMA LINHA POR COMPRA (nunca agrupar compras diferentes)
- ✅ Descrição = nome REAL do estabelecimento (ex: "Supermercado Shibata", "Atacadão 635")
- ✅ NUNCA usar descrições genéricas como "Mercado", "Barbearia", "Coisas pra casa"
- ✅ Coluna Observações (Obs) SEMPRE com forma de pagamento (Santander, C6, Débito, PIX, Dinheiro)
- ✅ Data da compra REAL no campo Data
- ✅ Formato da data: DD/MM/AAAA
- ✅ Status padrão: "Pago" para despesas, "Recebido" para receitas

### Prevenção de Duplicatas
- ANTES de registrar qualquer gasto, SEMPRE verificar se já existe
- Comparar VALOR + DATA + MÊS → se coincidem, é provável duplicata
- Entradas manuais genéricas podem ser duplicatas de transações de fatura
- NUNCA registrar entradas manuais genéricas se a fatura do cartão já foi processada
- Descrição SEM nome do estabelecimento + SEM cartão na coluna Obs = sinal de alerta
- Ao processar faturas, varrer dados existentes e ALERTAR sobre possíveis duplicatas

### Contexto Pessoal do Evandro
- **Empresa própria / Autônomo** → receitas vêm direto dos clientes (ex: Avanto)
- **NÃO registrar "Retirada Empresa"** → os pagamentos dos clientes JÁ SÃO a receita
- Clientes podem ter % de repasse (ex: 35%) → registrar apenas a parte do Evandro
- **Namorada:** Ana Vitoria Nogueira Vian → PIX enviados = gastos reais, PIX recebidos = contribuições/reembolsos
- **Sogro:** Alexandre Placido Vianna → contribui com parte do aluguel
- **Aluguel na planilha:** registrar apenas o valor LÍQUIDO (aluguel total - contribuição Alexandre). NÃO registrar Alexandre como receita separada
- **Mãe:** Vanessa Cristina da Costa → PIX recebido = reembolso (comprou pra ela), NÃO é receita. PIX enviado = gasto real.
- **Irmã:** Evelin Thomazini Castilho → mesmo padrão da mãe
- **PIX de/para EVANDRO THOMAZINI** = transferência entre contas próprias da empresa. Só contabilizar o RECEBIDO como "Salário / Renda Principal"
- **Pagamentos de cartão de crédito no extrato** = NÃO registrar (já estão nas faturas)
- **Resgates CDB/RDB** = NÃO registrar (movimentação de investimentos)
- **Aluguel:** R$ 2.202,16/mês - Invest Imoveis (categoria Moradia)
- **IPVA:** R$ 276,71/mês (categoria Outras Fixas)

## Lições Aprendidas com Erros Reais

### Duplicatas (Fev/2026 — R$ 849,51 perdidos)
3 entradas manuais com descrições genéricas ("Mercado", "Barbearia", "Coisas pra casa") foram registradas SEM indicar o cartão. Depois, ao processar as faturas C6, as mesmas compras foram registradas com os nomes reais (Havan Jacareí, MP Milgrau, Sam's Club SJC), criando duplicatas.

**Sinais de alerta:** entrada sem cartão na coluna Obs, descrição genérica, mesmo valor + data próxima.

### PIX vs Cartão (Fev/2026 — 4 transações erradas)
4 transações do cartão Santander tinham nomes de pessoas na descrição e foram erroneamente registradas como "PIX Vânia Matos", "PIX Juliana Pimenta", etc.

**Regra:** Transações com nomes de pessoas em faturas são cobranças via link/maquininha, NUNCA PIX.

## Comandos Disponíveis

### Registro
- `add-receita` - Registrar receita (salário, freelance, rendas extras)
- `add-fixa` - Registrar despesa fixa (aluguel, luz, água, internet, streaming)
- `add-parcelamento` - Registrar compra parcelada no cartão
- `add-variavel` - Registrar gasto variável (mercado, restaurante, uber, lazer)

### Consulta
- `view [mês]` - Visualizar dados de um mês específico
- `resumo` - Visualizar resumo anual
- `resumo [categoria] [mês]` - Visualizar total de uma categoria no mês

### Processamento
- `processar-fatura` - Processar fatura de cartão (PDF) e registrar compras
- `processar-extrato` - Processar extrato bancário (PDF/CSV)

## Formato de Confirmação

Antes de registrar qualquer transação, SEMPRE mostrar:

```
Interpretação:
- Tipo: Receita / Despesa Fixa / Parcelamento / Gasto Variável
- Categoria: [nome da categoria]
- Valor: R$ [valor]
- Descrição: [nome do estabelecimento]
- Data: [DD/MM/AAAA]
- Status: [Pago/Recebido]
- Obs: [forma de pagamento]

Confirma? [S/N]
```

## Atualização de Resumos

Após cada registro:
1. Atualizar tabela de resumo do mês atual
2. Atualizar `resumo-anual.md` se for necessário (alterar totais do mês)
3. Calcular saldos corretamente

## Notas Importantes

- **Nunca inventar dados** — se não tiver certeza, perguntar ao usuário
- **Sempre confirmar** antes de registrar
- **Verificar duplicatas** antes de cada novo registro
- **Usar descrições reais** dos estabelecimentos
- **Manter consistência** nos formatos (data, valor, status)

_meta.json Metadata

{
  "ownerId": "kn7f61dzdrxy5h6q0e4bg0k4qn849gj1",
  "publishedAt": 1775359283645,
  "slug": "financas-donna",
  "version": "1.0.0"
}