IA no financeiro · Conciliação bancária, artigo 3 de 4. No artigo 2, preenchemos o perfil, a ficha, o catálogo e as referências. Veja a trilha completa e as outras tarefas.
Passo 5: a lista de caminhos e o registro de execução
Lista de caminhos
O que é
A lista de caminhos (caminhos-entrada.xlsx) é uma planilha que diz à skill onde achar cada arquivo e onde gravar o resultado. É o "endereço" de tudo o que a skill usa.
Ela fica fora da pasta da skill por um motivo prático: pastas mudam. O banco muda o nome do arquivo, a equipe reorganiza a rede, alguém troca de computador. Se os caminhos estivessem escritos dentro da skill, cada mudança exigiria editar e reinstalar a skill. Com a lista separada, você edita só a planilha.
A skill tem uma única informação fixa: onde está a lista. Todo o resto ela lê de lá.
As colunas
| Coluna | O que escrever | Exemplo |
|---|---|---|
| Tipo | Entrada, Saída ou Registro de execução (lista suspensa) | Entrada |
| Arquivo | o nome exato ou o início do nome, com o padrão da data | extrato_AAAA-MM-DD.csv |
| Pasta | o caminho da pasta | Financeiro\Tesouraria\Extratos |
| Como escolher | qual arquivo pegar, se houver vários (lista suspensa) | O da data de referência |
| Dono | quem coloca o arquivo na pasta | Tesouraria |
| Obrigatório? | Sim ou Não | Sim |
| Se não encontrar | Parar ou Alertar | Parar |
| Observações | o que mais a skill precisa saber | Exportado do banco por uma pessoa; nunca acesso ao banco |
As opções de "Como escolher" são:
- Nome exato: o arquivo tem sempre o mesmo nome.
- O da data de referência: o nome tem a data, como
extrato_2026-10-05.csv. - O mais recente que começa com…: pega o último arquivo com aquele início de nome.
- O mais recente (maior data e maior versão) anterior ao de hoje: usado para achar a conciliação anterior.
- Criar com a data de criação + versão: usado na saída; nunca sobrescreve.
Como preencher
- Apague as linhas amarelas de exemplo e escreva as da sua empresa.
- Uma linha para cada entrada: extrato, registros da empresa, conciliação anterior e as entradas adicionais dos módulos que você ligou (relatório de boletos, recebíveis da maquininha, resumo da folha…).
- Uma linha para a Saída: a pasta onde a conciliação será gravada. É o único lugar onde a skill grava.
- Uma linha para o Registro de execução: copie o modelo do kit para a pasta de trabalho e anote o caminho aqui, com Obrigatório = Não e Se não encontrar = Alertar.
- Prefira caminhos que funcionem em qualquer máquina: a pasta da rede (
\\servidor\Financeiro\…) ou um caminho relativo à pasta liberada para a IA. Evite oC:\do seu computador, senão a skill só funciona nele. - Nunca coloque senha, token ou acesso ao internet banking na lista.
Regras que a skill segue
- Arquivo obrigatório que não aparece faz a skill parar. Ela nunca usa um arquivo antigo no lugar.
- Arquivo opcional que não aparece gera um alerta, e a skill segue sem ele.
- Na primeira execução não existe conciliação anterior. Por isso ela é "Não / Alertar": a skill usa o saldo anterior do extrato nos dois lados e avisa. Depois disso, se a conciliação anterior existir e o saldo não bater, a skill para.
Exemplo preenchido: a lista de caminhos da clínica
A clínica tem quatro entradas e uma saída:
- o extrato e a planilha financeira são obrigatórios: sem eles, a skill para;
- o relatório de boletos liquidados é obrigatório, mas só gera alerta se faltar. A clínica preferiu receber a conciliação com um aviso a não receber nada;
- a conciliação anterior pega "o mais recente (maior data e maior versão)": se houver
_v1e_v2do mesmo dia, vale a_v2; - a saída vai para a mesma pasta das conciliações anteriores, sem nunca sobrescrever;
- todos os caminhos são a partir da pasta da empresa, e não do
C:\de um computador.
A lista da clínica é de uma versão anterior do kit: ainda não tem a linha do registro de execução, e a conciliação anterior aparece como "Sim / Alertar". No kit atual, essa linha é "Não / Alertar", e o registro de execução ganha uma linha própria.
Registro de execução
O registro de execução é um CSV com uma linha por execução: data e hora, período, status, arquivos lidos e ausentes, saída, quantos itens foram para revisão e o motivo. A coluna revisado_em fica vazia para a pessoa revisora preencher.
Os status possíveis são: Concluída, Concluída com alertas, Parada e Falhou.
Copie o modelo para a pasta de trabalho antes da primeira execução e anote o caminho na lista. Se o registro não existir, a skill entrega a conciliação e avisa; ela não cria o arquivo por conta própria.
Passo 6: o modelo de saída
O modelo (modelo-saida-conciliacao.xlsx) define a planilha que a skill entrega. O nome do arquivo segue conciliacao-AAAA-MM-DD_vN.xlsx: a data é a do dia em que a skill roda, e cada nova execução no mesmo dia vira _v2, _v3. Nada é sobrescrito. O período conciliado aparece dentro do arquivo.
As abas:
| Aba | O que mostra |
|---|---|
| Verificação | a folha que a pessoa revisora assina: números-chave, ponte de saldos, conferências da skill, itens que exigem decisão e o bloco de assinatura |
| Resumo | saldo de cada lado, conferências e a diferença; a "Diferença NÃO explicada" tem de dar zero |
| Conciliados | os pares, com as duas referências |
| Divergências | o que não bate, com o efeito na diferença, o responsável e a próxima ação |
| Pendências de revisão | o que precisa de uma pessoa, do mais urgente para o menos |
| Extrato classificado | só no modo sem registros |
Os totais são fórmulas. Não cole valores sobre elas para "fazer fechar": cada número precisa apontar para as linhas que o compõem.
Quando a skill para, ela não grava a conciliação. Ela grava o aviso de parada (aviso-parada-AAAA-MM-DD_vN.xlsx, a partir do modelo do kit), sem números de negócio, e a linha Parada no registro de execução, com a mesma data e hora. Na conversa, explica o motivo, os números, o que falta e outros itens urgentes que já encontrou. O aviso tem um campo "Ciente" para a pessoa assinar.
Depois da revisão, a pessoa salva a pasta de trabalho inteira em PDF: a folha de Verificação sai primeiro, seguida do Resumo e das abas de detalhe. Ela decide entre Aprovado, Aprovado com ressalvas ou Devolvido, e assina. A assinatura é evidência de que houve revisão, não tem valor jurídico ou contábil além disso.
Passo 7: gerando a skill
Prepare a pasta
Se você usou GUIA-DE-PREENCHIMENTO-COM-IA.md, confira respostas-mapeamento.md e as pendências antes de continuar. Esse arquivo vale como a ficha preenchida; use lista-de-caminhos-preenchida.xlsx como lista externa. Se preferir o documento assinável, transcreva as respostas confirmadas para a ficha .docx. A entrevista organiza o mapeamento; a skill será gerada pelo pedido desta etapa.
Antes de pedir a skill, deixe numa pasta só (a "pasta original" da sua skill):
- a ficha preenchida, só com os módulos que você usa;
- o catálogo de erros, com a coluna Usa? marcada;
- as referências que as suas regras usam (glossário, de-para, calendário, taxas);
- o modelo de saída e o modelo do aviso de parada.
A lista de caminhos e o registro de execução ficam fora dessa pasta, no lugar indicado na própria lista. Os dados da empresa (extratos, relatórios, conciliações) também ficam fora.
Use o pedido de construção
Abra uma conversa nova na ferramenta de IA, libere a pasta e cole o pedido do kit (pedido-de-construcao.md), trocando o que está entre colchetes:
Na pasta [caminho da pasta original] estão a ficha e as referências
da conciliação bancária de [nome da empresa].
A lista de caminhos está em [caminho da lista].
Leia a ficha, o catálogo, as referências usadas e o modelo de saída.
Compare Perfil, módulos e a coluna Usa? do catálogo.
Antes de escrever, faça perguntas sobre tolerâncias, agrupamentos,
caminhos, responsáveis, aprovações, conflitos e ações ao parar.
Depois das respostas, crie um SKILL.md enxuto, usando apenas os
módulos selecionados. Nunca force pares, não acesse internet banking,
não lance, não pague e não aprove. Nunca peça senha, token ou acesso
ao internet banking. Acrescente um passo final: no caminho indicado por
Registro de execução na lista, registre uma linha por execução sem alterar
as anteriores e deixe revisado_em para a pessoa revisora. A skill gerada
segue os formatos de campos do guia do registro de execução. Se o arquivo não
existir ou o cabeçalho divergir do modelo, não o crie nem regrave: entregue
a conciliação e avise. Preencha a aba Verificação do modelo de saída com o
mesmo status e a mesma data e hora da linha do registro, o resultado PASSA
ou ALERTA de cada conferência e o efeito de cada divergência e pendência na
coluna de efeito, e deixe a revisão em branco. Ao parar, não grave a
conciliação; grave a linha Parada, com o motivo, e o aviso de parada a
partir do modelo do kit, sem números de negócio, e informe números, o que
falta e outros itens urgentes já encontrados. Preserve origens e fórmulas.
O pedido faz quatro coisas:
- Diz onde está tudo: a pasta original e a lista de caminhos.
- Manda conferir a coerência: perfil, módulos e catálogo precisam concordar.
- Manda perguntar antes de escrever: tolerâncias, agrupamentos, caminhos, responsáveis, aprovações, conflitos e o que fazer ao parar.
- Fixa os limites e as entregas: sem acesso ao banco, sem lançar, pagar ou aprovar; registro de execução, folha de Verificação e aviso de parada.
Atalho: o pedido de construção completo, os modelos de saída e do aviso de parada e o registro de execução estão reunidos no Template de Conciliação Bancária com IA.
Responda às perguntas
As perguntas da IA são um teste da ficha. Se ela pergunta o que fazer com dois PIX do mesmo valor, falta uma regra de desempate. Se pergunta quem aprova o agrupamento de cartões, falta um responsável. Resolva a lacuna na ficha ou na referência, não só na conversa.
No teste com a loja Vento Sul, a IA fez 12 perguntas antes de escrever a skill. Os temas foram:
- Período semanal × "dia útil anterior"
- O que forma o lado do sistema (caixa + maquininha?)
- Itens com data depois do domingo
- As três pontas do cartão (venda, recebível e banco)
- Nome do pagador diferente do cliente
- Compra no débito pessoal
- Retirada do sócio × pró-labore
- Arquivos dos módulos de pagamentos e folha
- Como conferir os depósitos em dinheiro
- Tarifa conferida na semana ou no mês
- Qual é a conciliação anterior
- Onde salvar e como acionar a skill
Sete delas, as seis primeiras e a da tarifa, mostraram lacunas do kit, e o kit foi corrigido. As outras cinco eram decisões legítimas da empresa, e é para isso que o pedido manda perguntar antes de escrever.
Responda na conversa e leve a resposta para a ficha ou para a referência certa. Se ficar só na conversa, a próxima versão da skill não vai saber.
Passo 8: verifique e leia o SKILL.md
O que é o SKILL.md
O SKILL.md é o arquivo principal da skill: o procedimento que a IA vai seguir toda vez que você pedir uma conciliação. Ele tem duas partes:
- o cabeçalho, entre linhas
---, com o nome, a descrição e a versão. A descrição é o que a ferramenta lê para decidir quando usar a skill; - o corpo, com objetivo, entradas, passos, classificação, quando parar, saída e conferência antes de entregar.
Ele é curto de propósito. Os detalhes (cada exceção, cada termo, cada tarifa) moram na ficha e nas referências, que o SKILL.md manda consultar.
Por que ler antes de usar
A IA escreveu esse arquivo a partir da ficha e das respostas. Ela pode ter entendido algo errado, misturado regras ou copiado um detalhe do exemplo. Uma skill que você não leu é uma skill que você não conhece. Antes de instalar, leia o arquivo inteiro, linha por linha.
Nos testes com as cinco empresas, a leitura do SKILL.md gerado achou problemas reais:
- Posições fixas do exemplo: a skill de uma empresa dizia "cabeçalho do caixa na linha 3", mas era a linha 4. Na próxima planilha, com uma linha a mais no topo, ela leria errado.
- Contradição interna: a mesma skill mandava "casar" o chargeback num passo e mandar para Pendências em outro.
- Dependência escondida: a skill contava com um programa específico para recalcular as fórmulas e não dizia o que fazer sem ele.
O que conferir
| Confira | Por quê |
|---|---|
| A descrição diz o que a skill faz e quando usar? | É ela que faz a ferramenta escolher a skill certa |
| Objetivo, entradas, passos, parada e saída batem com a ficha? | A skill não pode inventar nem esquecer regras |
| Só aparecem os módulos que você ligou? | Módulo sobrando cria regra que não se aplica |
| A tolerância e os agrupamentos são os que você decidiu? | São as decisões que mais mudam o resultado |
| Os caminhos continuam na lista, e não dentro da skill? | Senão, cada mudança de pasta exige reinstalar |
| Ela acha os cabeçalhos pelo nome das colunas, e não por número de linha? | Arquivos reais mudam de posição |
| Há contradições entre passos? | A IA vai escolher um dos dois, e você não sabe qual |
| Sobrou nome, valor ou caminho do exemplo da Horizonte Claro? | A skill é da sua empresa, não do exemplo |
| Os limites estão lá: não acessar o banco, não lançar, não pagar, não aprovar? | São a primeira camada de segurança |
| O registro de execução e a aba Verificação estão no passo final? | Sem eles, não há rastro |
Se encontrar um problema, corrija na ficha ou na referência e peça para gerar de novo. Corrigir só o SKILL.md funciona até a próxima versão, que vai repetir o erro.
Um exemplo
O começo do SKILL.md da Horizonte Claro mostra como a skill gerada fica curta, porque os detalhes moram na ficha e nas referências:
---
name: conciliacao-bancaria
description: Prepara a conciliação da Horizonte Claro com extrato e ERP autorizados. Use quando pedirem para conciliar um período ou reprocessar uma data.
metadata:
version: "2.2"
---
# Objetivo
Preparar uma proposta rastreável para revisão humana; nunca aprovar ou concluir a conciliação.
## Entradas
- Leia a lista de caminhos externa e use somente extrato, ERP, conciliação anterior e referências autorizadas.
- Nunca peça senha, token ou acesso ao internet banking.
- Localize cabeçalhos pelos nomes, não por números de linha do exemplo.
No pacote atualizado, o arquivo completo, com 48 linhas, está em testes-para-estudo/01-exemplo-horizonte-claro/skill-exemplo/.
O SKILL.md da clínica
A skill da Clínica Bem Viver foi gerada com a versão anterior do kit e ficou bem mais longa: 200 linhas, com as regras dos módulos escritas por extenso. A descrição mostra bem o que a ferramenta lê para decidir quando usar a skill:
Prepara a conciliação bancária diária da Clínica Bem Viver (Banco Fictício,
ag. 0145, cc 12345-6) — compara o extrato do banco com a planilha financeira
(financeiro_2026.xlsx) e com o relatório de boletos liquidados, desde a última
conciliação até ontem, e gera conciliacao-AAAA-MM-DD_vN.xlsx com Resumo,
Conciliados, Divergências e Pendências de revisão para a Renata investigar e
o Dr. Paulo aprovar. Use sempre que pedirem para conciliar o banco, fazer a
conciliação do dia, conferir o extrato com a planilha, ou disserem algo como
"roda a conciliação", "bate o extrato", mesmo sem citar a skill.
A descrição diz o que a skill faz, com quais arquivos, para quem, e lista as frases que devem acioná-la. O corpo segue a ficha: objetivo e regra de ouro, arquivos, e um passo a passo de 10 etapas (período, preparo dos dados, saldos e continuidade, pendências anteriores, pares, módulos ligados, efeito na diferença, responsáveis, planilha e resposta na conversa).
Na leitura, vale perguntar o que fazer com o que está fixo no texto. A descrição da clínica cita o nome do arquivo financeiro_2026.xlsx: em janeiro de 2027, alguém vai ter de lembrar de mudar. Se o nome do arquivo estivesse só na lista de caminhos, bastaria editar a planilha.
As duas skills estão nos testes para estudo do pacote atualizado, e vale compará-las: o kit pede um SKILL.md enxuto e deixa os detalhes nas referências.
Depois de aprovado, instale
Com o SKILL.md lido e aprovado, a pasta original vira a skill. No Claude Cowork, você compacta a pasta em ZIP e a adiciona pelo aplicativo; em outras ferramentas, copia a pasta para o lugar de skills que ela indica. A skill instalada é uma cópia: melhorias começam sempre na pasta original, ganham nova versão, passam pelos testes e só então são reinstaladas.
Instalar não é agendar. Rode a skill manualmente, numa conversa nova, e só pense em agendamento depois dos testes.
Perguntas frequentes
Posso editar o SKILL.md direto, sem passar pela ficha?
Pode, mas a correção some na próxima vez que a skill for gerada. O caminho seguro é corrigir na ficha ou na referência e gerar de novo.
A IA pode gerar uma skill diferente cada vez que eu pedir? Pode, por isso a leitura do passo 8 e os testes são obrigatórios a cada nova versão.
Onde guardo a lista de caminhos e o registro de execução?
Fora da pasta da skill, numa pasta que a ferramenta de IA possa ler e, no caso do registro, gravar. De preferência na rede da empresa, e não no C:\ de um computador.
Próximo artigo
Com a skill instalada, falta o mais importante: o artigo 4 mostra como testar antes de confiar.
Template de conciliação bancária com IA
Não comece do zero. O template traz tudo o que você viu nesta trilha, pronto para preencher com as regras da sua empresa:
- Ficha de mapeamento modular: perfil da empresa, Base e 13 módulos (boletos, PIX, cartões, marketplace, folha…). Você usa só o que a empresa faz.
- Catálogo com 100 situações de erro e exceção, já classificadas em Corrigir, Alertar e Parar.
- Modelos prontos: planilha de conciliação com fórmulas e folha de Verificação para assinatura, aviso de parada e registro de execução.
- Lista de caminhos, referências (glossário, de-para, calendário de dias úteis, tarifas) e o pedido de construção testado para gerar a skill.
- Testes para estudo: o case Horizonte Claro com gabarito, execuções em sessão limpa e cenários fictícios de perfis variados.
A skill que vai para a rotina é a que você monta com a ficha da sua empresa, e testa antes de confiar.