Gerindo Expedicao

Skill para consultas e operacoes logisticas da Nacom Goya.

Quando Usar Esta Skill

USE para:

• Consultas de pedidos: "tem pedido do Atacadao?", "pedido VCD123 esta em separacao?"
• Consultas de estoque: "quanto tem de palmito?", "chegou cogumelo?"
• Analise de disponibilidade: "quando VCD123 fica disponivel?", "o que vai dar falta?"
• Calculo de prazo: "se embarcar amanha, quando chega?"
• Criacao de separacao: "crie separacao do VCD123 pra amanha"

NAO USE para:

• Analise COMPLETA da carteira com decisoes (use o Agent analista-carteira)
• Comunicacao com PCP ou Comercial (use o Agent)
• Decisoes de priorizacao P1-P7 (use o Agent)

REGRAS CRITICAS (NUNCA VIOLAR)

1. GUARDRAIL ANTI-ALUCINACAO

PROIBIDO criar, calcular ou inferir dados que NAO foram retornados pelo script. Se precisar de dado que nao veio no script: EXECUTE o script com flag adequado ou PERGUNTE ao usuario.

2. REGRA DE FALLBACK (NUNCA TRAVAR)

Se um script falhar: SEMPRE responda ao usuario com erro e alternativa. NUNCA: Ficar em silencio, travar, ou tentar criar scripts customizados.

3. SIMULAR ANTES DE EXECUTAR (ACOES)

Para QUALQUER acao que modifica dados (criar separacao):

1. Executar SEM --executar (simular)
2. Mostrar resultado ao usuario
3. AGUARDAR confirmacao explicita
4. So entao executar COM --executar

DECISION TREE - Qual Script Usar?

Mapeamento Rapido

Regras de Decisao (em ordem de prioridade)

1. PRODUTO + CLIENTE/GRUPO juntos: → consultando_situacao_pedidos.py --grupo X --produto Y
2. PEDIDOS de cliente/grupo (sem produto): → consultando_situacao_pedidos.py --grupo X
3. ESTOQUE de produto (sem cliente): → consultando_produtos_estoque.py --produto X --completo
4. DISPONIBILIDADE de pedido: → analisando_disponibilidade_estoque.py --pedido X
5. PRAZO de entrega: → calculando_leadtime_entrega.py
6. ACAO de criar separacao: → criando_separacao_pedidos.py (SEMPRE simular antes!)

Como Decidir (Raciocinio Obrigatorio)

PASSO 1: O que o usuario quer? (PEDIDOS / ESTOQUE / DISPONIBILIDADE / PRAZO / ACAO) PASSO 2: Tem cliente/grupo? (SIM + produto → situacao_pedidos | SIM sem produto → situacao_pedidos | NAO → produtos_estoque) PASSO 3: A escolha faz sentido? (ESTOQUE mas "pro atacadao" → ERRADO, use PEDIDOS) PASSO 4: Em duvida → pergunte ao usuario!

Termos Ambiguos - PERGUNTE antes de agir!

"programacao de entrega" (CRITICO - 4 interpretacoes)

A) Data que cliente solicitou (data_entrega_pedido) | B) Data de expedicao (expedicao) | C) Data de chegada (agendamento) | D) Protocolo de agendamento (protocolo)

"quantidade pendente"

Acao padrao: Mostrar AMBOS: "Na carteira: X un | Em separacao: Y un | Total: Z un"

Multiplas lojas do mesmo grupo

Se resultado tiver mais de 1 loja: PERGUNTAR qual loja.

Scripts — Referencia Detalhada

Para parametros completos, retornos e modos de operacao: LER SCRIPTS.md

Resumo dos 8 scripts:

Fluxo de Criacao de Separacao

Sequencia: SIMULAR → Verificar alertas → Mostrar → Confirmar → EXECUTAR

Leitura de References (Sob Demanda)

Grupos Empresariais: --grupo atacadao, --grupo assai, --grupo tenda