Skill: evandrotho/financas-donna (version 1.0.0)

# 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)


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)